LinkedIn Performance Report

LinkedIn performance report. pivot: CAMPAIGN | CREATIVE | CAMPAIGN_GROUP | ACCOUNT | MEMBER_JOB_TITLE | MEMBER_JOB_FUNCTION | MEMBER_INDUSTRY | MEMBER_SENIORITY | MEMBER_COMPANY_SIZE ... Up to THREE pivots at once, comma-separated (pivot='CAMPAIGN_GROUP,CAMPAIGN,CREATIVE') via LinkedIn's Statistics finder; combinable pivots are ACCOUNT, CAMPAIGN_GROUP, CAMPAIGN, CREATIVE, CONVERSION. Professional demographic pivots (MEMBER_*) work one at a time. campaign_ids = comma-separated campaign ids to narrow the report. start_date/end_date (YYYY-MM-DD) override days. Performance data is kept 10 years, professional demographic data 2 years (https://learn.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/ads-reporting). time_granularity: ALL | DAILY | MONTHLY. fields: comma-separated metric list (empty = default set; up to 20). Demographic pivots have a 12-24h delay and privacy thresholds.

Each row carries `pivot_names` — the HUMAN-READABLE labels for `pivotValues`, resolved for you at EVERY level: campaign / ad set / campaign group / creative names as well as demographic labels. `pivot_names` holds the readable names for the URNs (such as urn:li:title:95); typeahead search only goes name→ID and cannot reverse them. Anything that genuinely could not be resolved remains as its raw URN in that row's `pivotValues` / `pivot_names`; `unresolved_pivot_urn_count` is the account-wide count.

With pivot=CREATIVE each row also carries `creative_content` (headline, description, landing_page, format), so for TEXT-BASED formats (textAd, spotlight, follow/jobs ads) you can correlate MESSAGING with performance directly, without a second call.

POST-BASED formats are the exception and in many accounts they are the MAJORITY of spend (Sponsored Content, Document Ads, Thought Leader Ads). There the copy lives in the referenced post, so by default `creative_content` carries `post_urn` + `post_permalink` and `ad_copy_status: "not_fetched"` instead of the text, which keeps the report fast. The copy IS retrievable: rank the rows first, then call `linkedin_ad_copy` with the top creative ids (or re-run with include_ad_previews=true) — it reads the real ad text from LinkedIn's PUBLIC Ad Library, plus `author_type` / `is_thought_leader_ad` (Thought Leader Ads) and `preview_url`. Each previewed creative costs about two extra LinkedIn requests. An internal creative name is not the ad text.

Rows also carry computed `ctr`, `engagement_rate`, `cpc`, `cpm` (ratios, not %); LinkedIn returns only raw counts. `pivotValues` is always requested even with a custom `fields` list (without it rows have no identity).

Every matching row is retained: `limit` controls only this transport response (0 = as many rows as safely fit). When `has_more` is true, call again with `page_token=next_page_token`; the remaining cached rows are returned without another LinkedIn request or credit.