Granular performance metrics for ads, audiences, creatives, offers, target groups, keywords.
IMPORTANT: Always specify endpoint parameter. Always use ISO 8601 for dates.
USE FOR: Best performing ads/audiences/creatives/offers/target groups, ingredient comparisons, ad type analysis (IMAGE, VIDEO, CAROUSEL), lead gen forms vs landing pages, pipeline by ingredient, creative previews, keyword performance.
NOT FOR: Account-level stats, experiment-level analysis without ingredient focus.
ENDPOINT LOGIC:
- 'target group' → customAudience/group
- 'audience' → customAudience
- 'offer'/'lead gen'/'landing page' → offer
- 'creative' → creative
- 'keyword' → keywords
- 'ad'/'ads' or default → ads
AD TYPES: IMAGE, VIDEO, CAROUSEL, DOCUMENT, CONVO, SPOTLIGHT, SEARCH, MESSAGE
- The `adFormat` field on each response row identifies the ad type.
METRICS: spend, impressions, clicks, leads, mqls | opens, sends, actionClicks, costPerOpen, costPerSend (CONVO/MESSAGE ads) | cpl, cpc, cpm, ctr, conversionRate, formConversionRate, mqlRate | totalOpps, totalTriggered, oppsAmount, triggeredAmount | cpMql, cpOppInfluenced, cpOppTriggered | channel, goal, adFormat, audienceSize, statusLabel | previewUrl
CONVO/MESSAGE AD CAVEAT: when adFormat is CONVO or MESSAGE (LinkedIn message ads), success is measured by opens, sends, and actionClicks (and costPerOpen / costPerSend), NOT clicks/ctr/cpc. Do not rank these ads by CTR or dismiss them when clicks=0. Use sort='actionClicks,desc' or sort='opens,desc' for conversational performance ranking.
RULES: Field 'id' corresponds to endpoint queried. Exclude $0 CPL experiments from calculations.