Data reference

Introduction

LinkedIn Ads is LinkedIn’s B2B-focused paid advertising platform, used to run Sponsored Content, Sponsored Messaging, Text Ads, Dynamic Ads, and Lead Gen Forms across the LinkedIn feed and inbox. It supports CPC, CPM, and CPS payment models across awareness, consideration, and conversion objectives, with audience targeting built on professional attributes such as company, industry, job function, job title, and seniority. The connector imports campaign structure, performance metrics, and conversion data through LinkedIn’s Marketing Developer Platform. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across sources without additional configuration. To connect this data source, see How to connect LinkedIn Ads to Adriel.

Data refresh strategy

Architecture data

Architecture covers ad accounts, campaigns, and ads. It refreshes twice daily at 4:00 PM UTC and 5:00 AM UTC.

Reports data

Reports include daily performance metrics for ad accounts, campaigns, ad sets, and ads. Real-time. Report data is fetched from LinkedIn on demand when a dashboard loads, so the latest values are always visible. On top of that, scheduled cache refreshes keep historical data consistent across multiple time windows. Refresh schedule. Reports refresh on three overlapping schedules:

5:00 PM UTC daily — syncs the last 9 days for ad account, campaign, ad set, and ad
11:40 PM and 6:40 AM UTC daily — syncs the last 3 days for ad account, campaign, ad set, and ad
7:30 AM UTC on the 1st and 15th of each month — syncs the last 30 days for ad account, campaign, ad set, and ad

Architecture levels

Ad account → Campaign → (Ad set = duplicate of campaign) → Ad

LinkedIn has no native ad set entity Both the campaign and ad set levels query the same LinkedIn endpoint, so the same campaigns appear at both hierarchy levels. Ad-set-level queries returning identical data to campaign-level queries is expected behavior, not a bug.

Date range limits

Breakdown	Max range
Daily	93 days
Weekly	1 year
Monthly	2 years

Metrics

How to read the columnsData type uses Adriel’s vocabulary — Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean. API Key in code style like impressions is the literal LinkedIn Marketing API field; where the same raw field name is shared across objects (LinkedIn returns name for the ad account, campaign, ad set, and ad) it’s shown qualified as object.field (for example account.name) so each row stays unique; italic marks a value Adriel computes or derives. Some raw fields back several rows — notably costInLocalCurrency (spend) and creativeParams.urls (the ad’s destination URLs, which Adriel parses for landing and UTM values) — so the same key can appear on multiple rows; that’s the shared source field, not a duplicated entry. Currency values are reported in each ad account’s configured LinkedIn currency; when the ad account currency differs from the workspace currency, values are converted using the current day’s exchange rate.

Basic

Metric	Description	Data type	API Key
Channel Type	A more specific LinkedIn ad subtype or placement classification, when available.	Text	Adriel-derived
Creative Image	A visual identifier for the ad image, when available.	Text	Adriel-derived
Creative Type	The creative format or ad type, when available.	Text	Adriel-derived
Lifetime Budget	The total lifetime budget configured for the selected campaigns or ad sets.	Currency	`totalBudget.amount`
Result Indicator	The result type used to interpret the values stored in the results object.	Text	Adriel-derived
Results	An object containing result totals keyed by result type.	Text	Adriel-derived

Campaign Attributes

Metric	Description	Data type	API Key
Ad Account Name	The name of the LinkedIn ad account.	Text	`account.name`
Ad Name	The name of the LinkedIn ad creative.	Text	`ad.name`
Ad Set Name	The name of the LinkedIn campaign used as the ad set in this connector.	Text	`adset.name`
Ad Spend	Cost in the account’s local currency for the selected reporting rows.	Currency	`costInLocalCurrency`
Bid Cap	The bid amount or cap configured for the campaign, when available.	Currency	Adriel-derived
Bid Strategy	The bidding model configured for the campaign or campaign proxy used as an ad set.	Text	`costType`
Budget	The configured budget object for the campaign or campaign proxy used as an ad set.	Text	`totalBudget`, `dailyBudget`
Campaign Name	The name of the LinkedIn campaign.	Text	`campaign.name`
Creative URL	A preview or destination URL associated with the ad creative, when available.	URL	Adriel-derived
Daily Budget	The total daily budget configured for the selected campaigns or ad sets.	Currency	`dailyBudget.amount`
Ends	The scheduled end date of the campaign or campaign proxy used as an ad set, when one is set.	Date	`runSchedule.end`
Is Active	Whether the campaign, campaign proxy used as an ad set, or ad is currently active.	Text	Adriel-side
Landing URL	The landing page URLs used by the ad creative.	URL	`creativeParams.urls`
Objective	The campaign objectives selected for the ads.	Text	`objectiveType`
Starts	The scheduled start date of the campaign or campaign proxy used as an ad set.	Date	`runSchedule.start`
Status	The current delivery status of the LinkedIn ad account, campaign, campaign proxy used as an ad set, or ad.	Text	`status`, `servingStatuses`, `intendedStatus`
Status Text	The delivery status label for the campaign, campaign proxy used as an ad set, or ad.	Text	Adriel-side
UTM Campaign	The UTM campaign values found in the ad destination URLs.	Text	`creativeParams.urls`
UTM Content	The UTM content values found in the ad destination URLs.	Text	`creativeParams.urls`
UTM Medium	The UTM medium values found in the ad destination URLs.	Text	`creativeParams.urls`
UTM Source	The UTM source values found in the ad destination URLs.	Text	`creativeParams.urls`
UTM Term	The UTM term values found in the ad destination URLs.	Text	`creativeParams.urls`

UTM values are parsed by Adriel, not returned by LinkedIn. Adriel reads the UTM query parameters from each ad’s configuration and landing URL and exposes them as both metrics (for rollup) and breakdowns (for grouping).

Campaign Structure

Metric	Description	Data type	API Key
Ad Account ID	The LinkedIn ad account ID.	Text	`account.id`
Ad ID	The LinkedIn creative ID.	Text	`ad.id`
Ad Set ID	The LinkedIn campaign ID used as the ad set ID in this connector.	Text	Adriel-derived
Campaign ID	The LinkedIn campaign or campaign group ID associated with the row.	Text	Adriel-derived
Channel	Sub-channel classifications associated with the campaign or ad, when available.	Array	Adriel-derived
Keyword ID	A keyword identifier when keyword-based reporting data is available.	Text	Adriel-derived
Keyword Name	A keyword name when keyword-based reporting data is available.	Text	Adriel-derived

Computed Metric

These are calculated by Adriel from other metrics; they have no single underlying LinkedIn field.

Metric	Description	Data type	API Key
Frequency	Impressions divided by reach.	Ratio	Adriel-computed
ROAS	Return on ad spend — conversion value divided by spend.	Ratio	Adriel-computed
Video Played To 100% (%)	Plays reaching 100% completion as a share of total plays.	Percentage	Adriel-computed
Video Played To 25% (%)	Plays reaching 25% completion as a share of total plays.	Percentage	Adriel-computed
Video Played To 50% (%)	Plays reaching 50% completion as a share of total plays.	Percentage	Adriel-computed
Video Played To 75% (%)	Plays reaching 75% completion as a share of total plays.	Percentage	Adriel-computed
View Rate	Video views as a share of impressions.	Percentage	Adriel-computed

Conversion Performance

Metric	Description	Data type	API Key
All Conversions	Total conversions across all tracked conversion actions, when available.	Number	Adriel-derived
Conversion Goal	The conversion action or goal associated with the reported results, when available.	Text	Adriel-derived
Conversion Value	The total conversion value in the account’s local currency across the returned conversion actions.	Currency	`conversionValueInLocalCurrency`
Conversions	The total number of external website conversions across the returned conversion actions.	Number	`externalWebsiteConversions`
Revenue	The total conversion value in the account’s local currency across the returned conversion actions.	Currency	`conversionValueInLocalCurrency`

Custom conversion events. LinkedIn conversion data is fetched in a separate query and joined to the main analytics response; named conversion events are resolved through LinkedIn’s conversions endpoint to build an ID-to-name map. Any conversion event configured in the connected ad account is imported and, for each, Adriel also generates derived KPIs such as ROAS, CPA, and conversion rate. An event appears on a dashboard only while the underlying event is active in the account.

Conversion stub rows for missing metric matches. When a conversion row exists for a date and breakdown combination that has no matching metric row — for example an entity with conversions but zero impressions — a stub row with empty metrics is synthesized so the conversion data is preserved.

Engagement

Metric	Description	Data type	API Key
Engagement	The total number of user interactions with the ad.	Number	`totalEngagements`
Post Comments	The number of comments on the promoted post, when available.	Number	Adriel-derived
Post Engagement	The total engagements on the promoted post, when available.	Number	Adriel-derived
Post Reactions	The number of reactions on the promoted post, when available.	Number	Adriel-derived
Post Saves	The number of saves on the promoted post, when available.	Number	Adriel-derived
Post Shares	The number of shares on the promoted post, when available.	Number	Adriel-derived
Video Impressions	The number of impressions from rows where LinkedIn reported video views.	Number	`impressions`, `videoViews`

Impression Click Performance

Metric	Description	Data type	API Key
Clicks (All)	The total clicks reported by LinkedIn for the selected rows.	Number	`clicks`
CPC	Cost per click.	Currency	Adriel-computed
CPM	Cost per thousand impressions.	Currency	Adriel-computed
CTR	Click-through rate — clicks divided by impressions.	Percentage	Adriel-computed
Impressions	The count of impressions, or sends for Sponsored Messaging ads.	Number	`impressions`
Link Clicks	The count of chargeable clicks.	Number	`clicks`
Reach	The estimated number of unique member accounts with at least one impression.	Number	`approximateMemberReach`

Video Performance

Metric	Description	Data type	API Key
15s Video Plays	Video views that lasted at least 15 seconds, when available.	Number	Adriel-derived
2s Video Plays	Video views that lasted at least two seconds, when available.	Number	Adriel-derived
30s Video Plays	Video views that lasted at least 30 seconds, when available.	Number	Adriel-derived
3s Video Plays	Video views that lasted at least three seconds, when available.	Number	Adriel-derived
6s Video Plays	Video views that lasted at least six seconds, when available.	Number	Adriel-derived
CPV	The average amount spent for each video view.	Currency	Adriel-computed
ThruPlays	Video plays that reached LinkedIn’s thru-play threshold, when available.	Number	Adriel-derived
Video Play	The number of times users started a video ad.	Number	`videoStarts`
Video Played To 100% (Views)	The number of video ads that reached completion.	Number	`videoCompletions`
Video Played To 25% (Views)	The number of video ads that reached the first quartile of playback.	Number	`videoFirstQuartileCompletions`
Video Played To 50% (Views)	The number of video ads that reached the midpoint of playback.	Number	`videoMidpointCompletions`
Video Played To 75% (Views)	The number of video ads that reached the third quartile of playback.	Number	`videoThirdQuartileCompletions`
Views	A video view counted after at least two continuous seconds at 50% in-view, or after a CTA click, whichever comes first.	Number	`videoViews`

LinkedIn Ads-specific

These metrics exist only for LinkedIn Ads and aren’t part of any cross-connector category. Every group above is a standard category shared with other connectors.

Metric	Description	Data type	API Key
Action Clicks	The count of clicks on the action button of the Sponsored Messaging ad.	Number	`actionClicks`
Ad Unit Clicks	The count of clicks on the ad unit displayed alongside the Sponsored Messaging ad.	Number	`adUnitClicks`
Approximate Member Reach	The estimated number of unique member accounts with at least one impression.	Number	`approximateMemberReach`
Card Clicks	Clicks on individual cards within carousel ads.	Number	`cardClicks`
Card Impressions	Impressions served for individual cards within carousel ads.	Number	`cardImpressions`
Comment Likes	Likes on comments for Sponsored Content ads.	Number	`commentLikes`
Comments	The count of comments. Sponsored Content only.	Number	`comments`
Company Page Clicks	The count of clicks to view the company page.	Number	`companyPageClicks`
Cost In Local Currency	Cost in the account’s local currency for the selected reporting rows.	Currency	`costInLocalCurrency`
Document 25% Completions	The number of times viewers reached the first quarter of a document ad.	Number	`documentFirstQuartileCompletions`
Document 50% Completions	The number of times viewers reached the midpoint of a document ad.	Number	`documentMidpointCompletions`
Document 75% Completions	The number of times viewers reached the third quarter of a document ad.	Number	`documentThirdQuartileCompletions`
Document Completions	The number of times viewers reached the end of a document ad.	Number	`documentCompletions`
Download Clicks	The number of times users clicked to download ad media.	Number	`downloadClicks`
Event Views	Valid views for an event hosted on LinkedIn.	Number	`eventViews`
Event Views (Over 15 Seconds)	Valid event views where viewers watched for more than 15 seconds.	Number	`eventViewsOver15Seconds`
Event Views (Over 2 Minutes)	Valid event views where viewers watched for more than 2 minutes.	Number	`eventViewsOver2Minutes`
Event Views (Over 30 Seconds)	Valid event views where viewers watched for more than 30 seconds.	Number	`eventViewsOver30Seconds`
Event Watch Time	Total watch time for LinkedIn-hosted events.	Duration	`eventWatchTime`
Follows	The count of follows. Sponsored Content and Follower ads only.	Number	`follows`
Full Screen Plays	The number of times viewers opened a video in full-screen mode.	Number	`fullScreenPlays`
Headline Clicks	Clicks on the headline in conversation ads.	Number	`headlineClicks`
Headline Impressions	The number of times the headline in a conversation ad was shown.	Number	`headlineImpressions`
Job Applications	Completed job applications attributed to the ad after a view or click.	Number	`jobApplications`
Job Apply Clicks	Clicks on a job’s apply button after a view or click on the ad.	Number	`jobApplyClicks`
Landing Page Clicks	The raw LinkedIn landing page clicks metric returned by the reporting API.	Number	`landingPageClicks`
Lead Forms Opened	The count of times users opened the lead form for a One Click Lead Gen campaign.	Number	`oneClickLeadFormOpens`
Lead Gen Mail - Contact Info Shares	The number of times users shared contact information through Sponsored Messaging Lead Gen.	Number	`leadGenerationMailContactInfoShares`
Lead Gen Mail - Interested Clicks	Recipients of Sponsored Messaging ads who clicked to express interest.	Number	`leadGenerationMailInterestedClicks`
Likes	The count of likes on Sponsored Content.	Number	`likes`
LinkedIn Leads	The count of leads generated through One Click Lead Gen.	Number	`oneClickLeads`
One Click Lead Form Opens	The number of times users opened a One Click Lead Gen form.	Number	`oneClickLeadFormOpens`
One Click Leads	The count of leads generated through One Click Lead Gen.	Number	`oneClickLeads`
Opens	The count of opens of Sponsored Messaging ads.	Number	`opens`
Other Engagements	The count of user interactions with the ad unit that don’t fit into a more specific category.	Number	`otherEngagements`
Paid Likes	The count of likes. Sponsored Content only.	Number	`likes`
Paid Shares	The count of shares. Sponsored Content only.	Number	`shares`
Post-Click Job Applications	Completed job applications attributed to ad clicks.	Number	`postClickJobApplications`
Post-Click Job Apply Clicks	Clicks on a job’s apply button attributed to ad clicks.	Number	`postClickJobApplyClicks`
Post-Click Registrations	Event or seminar registrations attributed to ad clicks.	Number	`postClickRegistrations`
Post-View Job Applications	Completed job applications attributed to ad views.	Number	`postViewJobApplications`
Post-View Job Apply Clicks	Clicks on a job’s apply button attributed to ad views.	Number	`postViewJobApplyClicks`
Post-View Registrations	Event or seminar registrations attributed to ad views.	Number	`postViewRegistrations`
Qualified Leads	Leads the advertiser marked as more likely to become customers.	Number	`qualifiedLeads`
Reactions	The count of positive reactions on Sponsored Content.	Number	`reactions`
Registrations	Event or seminar registrations attributed to the ad after a view or click.	Number	`registrations`
Scheduled Appointments	The number of appointments booked through Lead Gen campaigns.	Number	`appointmentsScheduled`
Sends	The count of sends of Sponsored Messaging ads.	Number	`sends`
Shares	The count of shares. Sponsored Content only.	Number	`shares`
Spend On Views	Spend for rows where LinkedIn reported at least one video view.	Currency	`costInLocalCurrency`
Subscription Clicks	Clicks to subscribe to a series such as a newsletter.	Number	`subscriptionClicks`
Talent Leads	Leads captured through talent media campaigns.	Number	`talentLeads`
Text Url Clicks	The count of clicks on any links included in the body of the Sponsored Messaging ad.	Number	`textUrlClicks`
Total Engagements	The count of all user interactions with the ad unit.	Number	`totalEngagements`
Total Social Actions	Derived as reactions + comments + shares + follows + otherEngagements.	Number	`reactions`, `comments`, `shares`, `follows`, `otherEngagements`
Valid Work Email Leads	Leads with a valid work email address that is not from a free or personal domain.	Number	`validWorkEmailLeads`
Video Completed	The count of video ads that played 97-100% of the video.	Number	`videoCompletions`
Video First Quartile Completions	The count of video ads that reached the first quartile of playback.	Number	`videoFirstQuartileCompletions`
Video Midpoint Completions	The count of video ads that reached the midpoint of playback.	Number	`videoMidpointCompletions`
Video Starts	The count of video ads that were started by users.	Number	`videoStarts`
Video Third Quartile Completions	The count of video ads that reached the third quartile of playback.	Number	`videoThirdQuartileCompletions`
Video Watch Time	Total watch time for video ads.	Duration	`videoWatchTime`
Viral Card Clicks	Clicks on carousel cards from viral impressions.	Number	`viralCardClicks`
Viral Card Impressions	Carousel card impressions generated by viral sharing.	Number	`viralCardImpressions`
Viral Clicks	Clicks from viral impressions.	Number	`viralClicks`
Viral Comment Likes	Likes on comments from viral impressions.	Number	`viralCommentLikes`
Viral Comments	Comments generated from viral impressions.	Number	`viralComments`
Viral Company Page Clicks	Clicks to the company page from viral impressions.	Number	`viralCompanyPageClicks`
Viral Document 25% Completions	The number of times viewers reached the first quarter of a document ad from viral impressions.	Number	`viralDocumentFirstQuartileCompletions`
Viral Document 50% Completions	The number of times viewers reached the midpoint of a document ad from viral impressions.	Number	`viralDocumentMidpointCompletions`
Viral Document 75% Completions	The number of times viewers reached the third quarter of a document ad from viral impressions.	Number	`viralDocumentThirdQuartileCompletions`
Viral Document Completions	The number of times viewers reached the end of a document ad from viral impressions.	Number	`viralDocumentCompletions`
Viral Download Clicks	The number of times users clicked to download media from a viral ad.	Number	`viralDownloadClicks`
Viral External Website Conversions	Conversions attributed to viral events from the ad.	Number	`viralExternalWebsiteConversions`
Viral External Website Post-Click Conversions	Post-click conversions attributed to viral clicks.	Number	`viralExternalWebsitePostClickConversions`
Viral External Website Post-View Conversions	Post-view conversions attributed to viral impressions.	Number	`viralExternalWebsitePostViewConversions`
Viral Follows	Follows generated from viral impressions.	Number	`viralFollows`
Viral Full Screen Plays	The number of times viewers opened a viral video in full-screen mode.	Number	`viralFullScreenPlays`
Viral Impressions	Impressions generated when sponsored content was shared into members’ networks.	Number	`viralImpressions`
Viral Job Applications	Completed job applications attributed to viral impressions or clicks.	Number	`viralJobApplications`
Viral Job Apply Clicks	Clicks on a job’s apply button attributed to viral impressions or clicks.	Number	`viralJobApplyClicks`
Viral Landing Page Clicks	Clicks to the landing page from viral impressions.	Number	`viralLandingPageClicks`
Viral Likes	Likes generated from viral impressions.	Number	`viralLikes`
Viral One-Click Lead Form Opens	Lead form opens from viral impressions in Lead Gen campaigns.	Number	`viralOneClickLeadFormOpens`
Viral One-Click Leads	Leads generated through One Click Lead Gen from viral impressions.	Number	`viralOneClickLeads`
Viral Other Engagements	Other user interactions from viral impressions that do not fit a more specific metric.	Number	`viralOtherEngagements`
Viral Post-Click Job Applications	Completed job applications attributed to viral clicks.	Number	`viralPostClickJobApplications`
Viral Post-Click Job Apply Clicks	Clicks on a job’s apply button attributed to viral clicks.	Number	`viralPostClickJobApplyClicks`
Viral Post-Click Registrations	Event or seminar registrations attributed to viral clicks.	Number	`viralPostClickRegistrations`
Viral Post-View Job Applications	Completed job applications attributed to viral impressions.	Number	`viralPostViewJobApplications`
Viral Post-View Job Apply Clicks	Clicks on a job’s apply button attributed to viral impressions.	Number	`viralPostViewJobApplyClicks`
Viral Post-View Registrations	Event or seminar registrations attributed to viral impressions.	Number	`viralPostViewRegistrations`
Viral Reactions	Positive reactions generated from viral impressions.	Number	`viralReactions`
Viral Registrations	Event or seminar registrations attributed to viral impressions or clicks.	Number	`viralRegistrations`
Viral Shares	Shares generated from viral impressions.	Number	`viralShares`
Viral Subscription Clicks	Subscription clicks generated from viral impressions.	Number	`viralSubscriptionClicks`
Viral Total Engagements	Total user interactions generated from viral impressions.	Number	`viralTotalEngagements`
Viral Video 25% Completions	The number of viral video plays that reached the first quarter of the video.	Number	`viralVideoFirstQuartileCompletions`
Viral Video 50% Completions	The number of viral video plays that reached the midpoint of the video.	Number	`viralVideoMidpointCompletions`
Viral Video 75% Completions	The number of viral video plays that reached the third quarter of the video.	Number	`viralVideoThirdQuartileCompletions`
Viral Video Completions	The number of viral video plays that reached the end of the video.	Number	`viralVideoCompletions`
Viral Video Starts	The number of viral video plays that were started by users.	Number	`viralVideoStarts`
Viral Video Views	Qualified viral video views reported by LinkedIn.	Number	`viralVideoViews`

Raw pass-through metrics. Several metrics are also exposed in a raw LinkedIn Ads: [metric] form directly from the LinkedIn API — for example LinkedIn Ads: Impressions, LinkedIn Ads: Landing Page Clicks, LinkedIn Ads: Total Engagements, and LinkedIn Ads: Cost In Local Currency. These mirror the standardized metrics above.

Breakdowns

Basic

Breakdown	Description	API Key
Channel	Groups results by marketing channel.	Adriel-side

Campaign Structure

Breakdown	Description	API Key
Ad Name	Groups results by ad creative name.	`ad.name`
Ad Set Name	Groups results by the ad set name used in this connector.	`adset.name`
Campaign Name	Groups results by campaign name.	`campaign.name`
Objective	Groups results by campaign objective.	`objectiveType`
Platform	Groups results by sub-channel classification, when available.	Adriel-side
Status	Groups results by the current delivery status of the selected entity.	Adriel-side

Creatives

Adriel post-processes ad creatives to generate these breakdowns.

Breakdown	Description	API Key
Ad Copy	Groups results by words detected in the creative, when available.	Adriel-side
Color Clustering	Groups results by dominant creative color cluster, when available.	Adriel-side
Creative Image	Groups results by the visual identifier of the ad image, when available.	Adriel-side
Emoji Analysis	Groups results by emoji usage detected in the creative, when available.	Adriel-side

Date

LinkedIn returns daily records; all time-grouping breakdowns are Adriel-side aggregations of the same underlying daily data.

Breakdown	Description	API Key
Auto Time Breakdown	Groups results by the automatically selected time granularity.	Adriel-side
Daily Breakdown	Groups results by calendar day.	Adriel-side
Monthly Breakdown	Groups results by calendar month.	Adriel-side
Quarterly Breakdown	Groups results by calendar quarter.	Adriel-side
Week Date Breakdown	Groups results by the starting date of the week.	Adriel-side
Week Number Breakdown (W#)	Groups results by week number in the year.	Adriel-side
Weekly Breakdown (Start: Mon)	Groups results by calendar week.	Adriel-side
Weekly Breakdown (Start: Sun)	Groups results by Sunday-to-Saturday week.	Adriel-side
Yearly Breakdown	Groups results by calendar year.	Adriel-side

Others

Breakdown	Description	API Key
No Grouping	Returns results without applying an additional breakdown.	Adriel-side

LinkedIn Ads-specific

These breakdowns exist only for LinkedIn Ads and aren’t part of any cross-connector category. Every group above is a standard category shared with other connectors.

Breakdown	Description	API Key
Ad	Groups results by LinkedIn ad creative.	Adriel-side
Ad Account	Groups results by LinkedIn ad account.	Adriel-side
Ad Set	Groups results by the LinkedIn campaign used as the ad set in this connector.	Adriel-side
Campaign	Groups results by LinkedIn campaign.	Adriel-side
Company	Groups results by member company.	`MEMBER_COMPANY`
Company Size	Groups results by member company size.	`MEMBER_COMPANY_SIZE`
Country	Groups results by member country.	`MEMBER_COUNTRY_V2`
Device Target	Groups results by the device type where the ad impression occurred.	`IMPRESSION_DEVICE_TYPE`
Industry	Groups results by member industry.	`MEMBER_INDUSTRY`
Job Function	Groups results by member job function.	`MEMBER_JOB_FUNCTION`
Job Title	Groups results by member job title.	`MEMBER_JOB_TITLE`
Location	Groups results by member region or location.	`MEMBER_REGION_V2`
Seniority	Groups results by member seniority.	`MEMBER_SENIORITY`
State (US Only)	Groups results by member region or state.	`MEMBER_REGION_V2`

Limitations

Maximum 2 breakdowns per query. Adriel’s LinkedIn connector caps each query at two breakdowns at once; adding a third returns a “too much breakdowns” error. This is an Adriel connector limit, not a LinkedIn platform restriction.
Detail breakdowns not supported at ad level. Detail breakdowns must be queried at the ad account, campaign, or ad set level; querying one at ad level returns an error.
Detail breakdown with conversion metrics. Conversion data is not returned for queries that include a detail breakdown.
20-item architecture filter cap. When more than 20 campaigns, groups, or creatives are selected in the data source filter, the filter is dropped and account-level (unfiltered) data is returned. Use a breakdown for finer granularity past 20 items.
Ad set duplicates campaign. LinkedIn has no native ad set entity, so campaign-level and ad-set-level queries return the same data (LinkedIn campaign and account structure).
Company breakdown labels can be raw URNs. LinkedIn’s organizations lookup requires that the connecting user be a member of the organization. Companies without that membership fall back to the raw URN as the label.
Token activation delay. After OAuth, LinkedIn’s API can take up to roughly a minute to accept the new token. The connector retries the ad-account list call multiple times during this window; if LinkedIn takes longer, data source creation can fail and a retry is required.
Token expiry. OAuth tokens occasionally expire and require re-authorization via the connections list.
Today’s end date is omitted. Reports for date ranges ending today omit the end-date field to prevent partial-day data contamination.

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Basic

Campaign Attributes

Campaign Structure

Computed Metric

Conversion Performance

Engagement

Impression Click Performance

Video Performance

LinkedIn Ads-specific

Breakdowns

Basic

Campaign Structure

Creatives

Date

Others

LinkedIn Ads-specific

Limitations

API references

See also

​Introduction

​Data refresh strategy

​Architecture data

​Reports data

​Architecture levels

​Date range limits

​Metrics

​Basic

​Campaign Attributes

​Campaign Structure

​Computed Metric

​Conversion Performance

​Engagement

​Impression Click Performance

​Video Performance

​LinkedIn Ads-specific

​Breakdowns

​Basic

​Campaign Structure

​Creatives

​Date

​Others

​LinkedIn Ads-specific

​Limitations

​API references

​See also

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Basic

Campaign Attributes

Campaign Structure

Computed Metric

Conversion Performance

Engagement

Impression Click Performance

Video Performance

LinkedIn Ads-specific

Breakdowns

Basic

Campaign Structure

Creatives

Date

Others

LinkedIn Ads-specific

Limitations

API references

See also