LinkedIn Ads

LinkedIn engagement and video metrics

Reports the social half of LinkedIn delivery: reactions, comments, shares, page follows, total engagements and engagement rate, plus video views and completions where the creative is a video. Use when: the objective is BRAND_AWARENESS, ENGAGEMENT or VIDEO_VIEW — for those, clicks and leads are the wrong scoreboard. Also use it to explain a campaign whose CTR looks weak but whose content is being shared. Do not use it to judge a lead-generation or conversion campaign: engagement there is a vanity number, and linkedin_get_campaign_performance has the metrics that matter. Returns totals and a per-campaign (ad set) table. Engagement rate is engagements ÷ impressions. Video completion rate is completions ÷ views, which on LinkedIn counts a view at two seconds, so completion rate reads low compared with other platforms. LinkedIn ad accounts carry no reporting timezone, so every window here is UTC days. If video metrics are all zero on a video campaign, the creative is probably an image — check linkedin_list_creatives.

post/api/v1/tools/linkedin_get_engagement_metrics/execute

Request

  • Base URL: https://adako.ai
  • URL: https://adako.ai/api/v1/tools/linkedin_get_engagement_metrics/execute
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional 8-128 character key. A successful envelope is cached for 24 hours; replaying the key with the same arguments returns it again with Idempotent-Replayed: true, and replaying it with different arguments answers 409.

Request body

Response

The tool ran. A write returns proposal_id and approve_url while the change waits for approval.

successunknown required
toolstring required
dataobject required

Machine-readable result.

markdownstring required

The same result written for a person or a model.

proposal_idstring

Present for writes. Nothing changes on the ad platform until it is approved.

approve_urlstring

Where a person approves the proposal.

request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.