Analytics

Analytics

Standard metrics (spend, impressions, clicks, CPC, CPM) come rolled up on GET /v1/ads, GET /v1/ads/tree and GET /v1/ads/{adId}. What's LinkedIn-specific is the firmographic layer: who saw the ad, by title, seniority, industry and company.

Firmographic breakdowns

GET /v1/ads/{adId}/analytics?breakdowns=... with LinkedIn dimensions:

const { data } = await zernio.adinsights.getAdAnalytics({
  path: { adId: 'AD_ID' },
  query: { breakdowns: 'job_title,seniority,company_size' },
});
// rows: { value, name, spend, impressions, clicks, ctr, cpc, cpm, engagement }, sorted by impressions

data = client.ad_insights.get_ad_analytics(
    ad_id="AD_ID",
    breakdowns="job_title,seniority,company_size",
)

curl "https://zernio.com/api/v1/ads/AD_ID/analytics?breakdowns=job_title,seniority,company_size" \
  -H "Authorization: Bearer YOUR_API_KEY"

Rows come back as { value, name, spend, impressions, clicks, ctr, cpc, cpm, engagement }, sorted by impressions. value is LinkedIn's URN; name is resolved server-side (job titles, companies, industries all come back human-readable).

The same breakdowns parameter works at the campaign level on GET /v1/ads/campaigns/{campaignId}/analytics (for LinkedIn, the campaign id is the campaign group). It's also the same endpoint that serves Meta's demographic breakdowns, dimensions are validated per platform, and an invalid one returns a 400 listing the valid set.

LinkedIn constraints

• Aggregated over the whole requested range: LinkedIn only serves firmographic pivots with timeGranularity: ALL, so there's no per-day time series per job title.
• 12-24h data delay on demographic pivots.
• Privacy floor: segments with fewer than 3 events are omitted by LinkedIn entirely, so small campaigns return short lists. Not a bug.

Conversion attribution

Conversion-level metrics (post-click / view-through conversions, conversion value, cost) are read per conversion rule via the Conversions API metrics endpoint.