LinkedIn Ads: Most-used fields#
The table below gives information about most-used fields that you can import from LinkedIn Ads. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
Active |
ACTIVE |
Indicates that a campaign or ad is currently running. |
dimension |
Date |
Date |
The specific date for which the performance metrics are reported. Data can be retrieved at a daily, monthly, or yearly granularity. |
dimension |
account.changeAuditStamps.created.actor |
account.changeAuditStamps.created.actor |
The actor (e.g., user URN) who created the ad account. |
dimension |
account.changeAuditStamps.created.time |
account.changeAuditStamps.created.time |
The timestamp when the ad account was created. |
metric |
account.changeAuditStamps.lastModified.actor |
account.changeAuditStamps.lastModified.actor |
The actor (e.g., user URN) who last modified the ad account. |
dimension |
account.changeAuditStamps.lastModified.time |
account.changeAuditStamps.lastModified.time |
The timestamp when the ad account was last modified. |
metric |
account.currency |
account.currency |
The default currency used for the ad account. |
dimension |
account.id |
account.id |
The unique identifier of the ad account. |
dimension |
account.name |
account.name |
The name of the ad account. |
dimension |
account.notifiedOnCampaignOptimization |
account.notifiedOnCampaignOptimization |
Indicates if the account contact receives notifications about campaign optimization opportunities. |
dimension |
account.notifiedOnCreativeApproval |
account.notifiedOnCreativeApproval |
Indicates if the account contact receives notifications when a creative has been reviewed and approved. |
dimension |
account.notifiedOnCreativeRejection |
account.notifiedOnCreativeRejection |
Indicates if the account contact receives notifications when a creative has been rejected. |
dimension |
account.notifiedOnEndOfCampaign |
account.notifiedOnEndOfCampaign |
Indicates if the account contact receives notifications when an associated campaign has ended. |
dimension |
account.reference |
account.reference |
A unique identifier or reference for the ad account. |
dimension |
account.servingStatuses |
account.servingStatuses |
The current serving statuses for the ad account, indicating if it’s active, paused, or in review. |
dimension |
account.status |
account.status |
The overall status of the ad account, such as ‘ACTIVE’ or ‘CLOSED’. |
dimension |
account.type |
account.type |
The type of the ad account, such as ‘BUSINESS’ or ‘PERSONAL’. |
dimension |
account.version.versionTag |
account.version.versionTag |
A unique identifier or tag representing the version of the ad account object within the API. |
metric |
account_id |
account_id |
The unique identifier for the advertising account. |
dimension |
account_name |
account_name |
The name of the ad account. |
dimension |
actionClicks |
actionClicks |
The number of clicks on the action button within a Sponsored Messaging ad. |
metric |
adUnitClicks |
adUnitClicks |
The number of clicks recorded on an ad unit. |
dimension |
approximateMemberReach |
approximateMemberReach |
The estimated number of unique LinkedIn members who saw an ad at least once. This metric is available for date ranges up to 92 days and is an updated version of approximateUniqueImpressions. |
metric |
approximateUniqueImpressions |
approximateUniqueImpressions |
A legacy metric representing the estimated number of unique users who saw an ad at least once. |
metric |
audiencePenetration |
audiencePenetration |
The approximate number of unique members reached by the advertiser divided by the approximate total target audience size. This metric is available for date ranges of up to 92 days and supports account, campaign group, or campaign pivots. |
metric |
buying_type |
buying_type |
The buying type of the campaign, such as auction or fixed price. |
dimension |
campaign.account |
campaign.account |
The unique identifier of the ad account to which the campaign belongs. |
dimension |
campaign.associatedEntity |
campaign.associatedEntity |
The entity, such as an organization or member, that the campaign is associated with. |
dimension |
campaign.audienceExpansionEnabled |
campaign.audienceExpansionEnabled |
Indicates whether audience expansion is enabled for the campaign, which broadens targeting criteria. |
dimension |
campaign.changeAuditStamps.created.time |
campaign.changeAuditStamps.created.time |
The timestamp when the campaign was created. |
metric |
campaign.changeAuditStamps.lastModified.time |
campaign.changeAuditStamps.lastModified.time |
The timestamp when the campaign was last modified. |
dimension |
campaign.costType |
campaign.costType |
The method by which the cost of a campaign is determined, such as CPC (Cost Per Click) or CPM (Cost Per Mille). |
dimension |
campaign.creativeSelection |
campaign.creativeSelection |
The method or strategy used to select and deliver creatives within a campaign. |
dimension |
campaign.dailyBudget.amount |
campaign.dailyBudget.amount |
The daily budget amount set for the campaign. |
metric |
campaign.dailyBudget.currencyCode |
campaign.dailyBudget.currencyCode |
The currency code (e.g., USD, EUR) used for the campaign’s daily budget. |
dimension |
campaign.id |
campaign.id |
The unique identifier of the campaign. |
dimension |
campaign.locale.country |
campaign.locale.country |
The country target associated with the campaign’s locale. |
dimension |
campaign.locale.language |
campaign.locale.language |
The language target associated with the campaign’s locale. |
dimension |
campaign.name |
campaign.name |
The name of the campaign. |
dimension |
campaign.objectiveType |
campaign.objectiveType |
The primary marketing objective of the campaign, such as Lead Generation, Website Traffic, or Brand Awareness. |
dimension |
campaign.offsiteDeliveryEnabled |
campaign.offsiteDeliveryEnabled |
Indicates if the campaign is enabled for delivery on the LinkedIn Audience Network (off-site placements). |
dimension |
campaign.offsitePreferences.iabCategories.exclude |
campaign.offsitePreferences.iabCategories.exclude |
A list of IAB (Interactive Advertising Bureau) categories to exclude for offsite ad placements, preventing ads from appearing on certain content types. |
dimension |
campaign.runSchedule.end |
campaign.runSchedule.end |
The end date and time of the campaign’s run schedule. |
metric |
campaign.runSchedule.start |
campaign.runSchedule.start |
The start date and time of the campaign’s run schedule. |
metric |
campaign.servingStatuses |
campaign.servingStatuses |
The current serving statuses of the campaign, indicating if it’s active, paused, or pending. Can include multiple statuses. |
dimension |
campaign.status |
campaign.status |
The current status of the campaign, such as ‘ACTIVE’, ‘PAUSED’, ‘DRAFT’. |
dimension |
campaign.targeting.excludedTargetingFacets.employers |
campaign.targeting.excludedTargetingFacets.employers |
A list of employer organizations that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.followedCompanies |
campaign.targeting.excludedTargetingFacets.followedCompanies |
A list of companies that, if followed by a member, would exclude them from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.industries |
campaign.targeting.excludedTargetingFacets.industries |
A list of industries that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.seniorities |
campaign.targeting.excludedTargetingFacets.seniorities |
A list of professional seniorities that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.employers |
campaign.targeting.includedTargetingFacets.employers |
A list of employer organizations that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.followedCompanies |
campaign.targeting.includedTargetingFacets.followedCompanies |
A list of companies that, if followed by a member, would include them in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.industries |
campaign.targeting.includedTargetingFacets.industries |
A list of industries that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.seniorities |
campaign.targeting.includedTargetingFacets.seniorities |
A list of professional seniorities that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targetingCriteria.exclude |
campaign.targetingCriteria.exclude |
Specifies the criteria used to exclude certain audiences from a campaign’s targeting. |
dimension |
campaign.targetingCriteria.include |
campaign.targetingCriteria.include |
The criteria used to include specific demographics or attributes for campaign targeting. |
dimension |
campaign.totalBudget.amount |
campaign.totalBudget.amount |
The total budget amount set for the campaign. |
metric |
campaign.totalBudget.currencyCode |
campaign.totalBudget.currencyCode |
The currency code for the total budget amount of the campaign. |
dimension |
campaign.type |
campaign.type |
The type of ad campaign, such as Text Ad, Sponsored Updates, Sponsored InMails, or Dynamic Ads. |
dimension |
campaign.unitCost.amount |
campaign.unitCost.amount |
The unit cost amount, such as cost per click or cost per impression, for the campaign. |
metric |
campaign.unitCost.currencyCode |
campaign.unitCost.currencyCode |
The currency code for the campaign’s unit cost. |
dimension |
campaign.urn |
campaign.urn |
The Uniform Resource Name (URN) that uniquely identifies the campaign. |
dimension |
campaign.version.versionTag |
campaign.version.versionTag |
A unique identifier or tag representing the version of the campaign object within the API. |
metric |
campaign_group.backfilled |
campaign_group.backfilled |
A system-set flag indicating if the campaign group was created organically or to backfill existing campaigns. |
dimension |
campaign_group.changeAuditStamps.created.time |
campaign_group.changeAuditStamps.created.time |
The timestamp indicating when the campaign group was created. |
metric |
campaign_group.changeAuditStamps.lastModified.time |
campaign_group.changeAuditStamps.lastModified.time |
The timestamp indicating when the campaign group was last modified. |
metric |
campaign_group.id |
campaign_group.id |
The unique identifier of the campaign group. |
metric |
campaign_group.name |
campaign_group.name |
The name of the campaign group. |
dimension |
campaign_group.runSchedule.end |
campaign_group.runSchedule.end |
The exclusive end date and time for when a campaign group and its associated campaigns are scheduled to stop running. |
metric |
campaign_group.runSchedule.start |
campaign_group.runSchedule.start |
The inclusive start date and time for when a campaign group and its associated campaigns are scheduled to begin running. |
metric |
campaign_group.servingStatuses |
campaign_group.servingStatuses |
The serving statuses of the campaign group. |
dimension |
campaign_group.status |
campaign_group.status |
The current operational status of the campaign group. |
dimension |
campaign_group.totalBudget.amount |
campaign_group.totalBudget.amount |
The maximum amount to spend across all associated campaigns and creatives for the duration of the campaign group. |
metric |
campaign_group.totalBudget.currencyCode |
campaign_group.totalBudget.currencyCode |
The currency code (e.g., USD, EUR) for the campaign group’s total budget amount. |
dimension |
campaign_id |
campaign_id |
The unique identifier for the advertising campaign. |
dimension |
campaign_name |
campaign_name |
The name of the advertising campaign. |
dimension |
campaign_objective |
campaign_objective |
The primary goal or objective set for the advertising campaign. |
dimension |
campaign_status |
campaign_status |
The overall status of the campaign, such as ACTIVE, PAUSED, DRAFT, ARCHIVED. |
dimension |
cardClicks |
cardClicks |
The number of clicks on individual cards within a carousel ad creative, applicable for non-demographic pivots. |
metric |
cardImpressions |
cardImpressions |
The number of impressions recorded for each individual card within a carousel ad, applicable for non-demographic pivots. |
metric |
changeAuditStamps.created.time |
changeAuditStamps.created.time |
The timestamp indicating when an entity (e.g., ad, campaign, creative) was originally created. |
dimension |
changeAuditStamps.created.time.date |
changeAuditStamps.created.time.date |
The date when the entity was created, as part of its change audit stamps. |
dimension |
clicks |
clicks |
The total number of chargeable clicks on an ad, representing interactions like landing page views or company page visits. |
metric |
commentLikes |
commentLikes |
The number of likes received on comments made on Sponsored Content. |
metric |
comments |
comments |
The number of comments received on Sponsored Content. |
metric |
companyPageClicks |
companyPageClicks |
The number of clicks that directed users to the company page associated with the ad. |
dimension |
conversion.account |
conversion.account |
The LinkedIn Ads account associated with a specific conversion event or rule. This identifies the ad account for which the conversion data is reported. |
dimension |
conversion.attributionType |
conversion.attributionType |
The method or model used to assign credit for a conversion to various touchpoints in the customer journey. |
dimension |
conversion.id |
conversion.id |
A unique identifier for the conversion event or conversion rule. |
metric |
conversion.name |
conversion.name |
The name given to the conversion event or conversion rule for identification. |
dimension |
conversion.type |
conversion.type |
The category or classification of the conversion event (e.g., Lead, Purchase). |
dimension |
conversion.value.amount |
conversion.value.amount |
The monetary value associated with a conversion event. |
metric |
conversion.value.currencyCode |
conversion.value.currencyCode |
The currency code (e.g., USD, EUR) for the monetary value of a conversion event. |
dimension |
conversion.viewThroughAttributionWindowSize |
conversion.viewThroughAttributionWindowSize |
The duration, in days, after an impression (view) during which a conversion can be attributed to that impression. |
metric |
conversionValueInLocalCurrency |
conversionValueInLocalCurrency |
The monetary value of conversions recorded in the ad account’s local currency, based on advertiser-defined rules, applicable for non-demographic pivots. |
dimension |
costInLocalCurrency |
costInLocalCurrency |
The total cost of the ad campaign in the account’s local currency, broken down by selected pivots and time granularity. |
metric |
costInUsd |
costInUsd |
The total cost of the ad campaign in USD, broken down by selected pivots and time granularity. |
dimension |
country |
country |
The country targeted by the campaign or associated with the ad’s locale. |
dimension |
creative.activity |
creative.activity |
The activity associated with the creative, often referring to a sponsored update or social share. |
dimension |
creative.call_to_action |
creative.call_to_action |
The call-to-action (CTA) text displayed on the creative (e.g., ‘Learn More’, ‘Apply Now’). |
dimension |
creative.call_to_action_target |
creative.call_to_action_target |
The target URL or destination for the creative’s call-to-action. |
dimension |
creative.campaign |
creative.campaign |
The unique identifier of the campaign to which this creative belongs. |
dimension |
creative.changeAuditStamps.created.time |
creative.changeAuditStamps.created.time |
The timestamp indicating when the ad creative was originally created. |
metric |
creative.changeAuditStamps.lastModified.time |
creative.changeAuditStamps.lastModified.time |
The timestamp indicating the last time the creative was modified. |
metric |
creative.company_name |
creative.company_name |
The name of the company associated with the creative. |
dimension |
creative.contentLandingPageUri |
creative.contentLandingPageUri |
The URI of the landing page for the content associated with the creative. |
dimension |
creative.created_timestamp |
creative.created_timestamp |
The timestamp when the creative was created. |
metric |
creative.description |
creative.description |
The descriptive text for the creative, providing details about the ad. |
dimension |
creative.headline |
creative.headline |
The headline text for the creative. |
dimension |
creative.id |
creative.id |
The unique identifier of the ad creative. |
dimension |
creative.inmail_account |
creative.inmail_account |
The InMail account associated with an InMail creative. |
dimension |
creative.inmail_html_body |
creative.inmail_html_body |
The HTML body content of a Sponsored InMail creative. |
dimension |
creative.inmail_legal_text |
creative.inmail_legal_text |
The legal text or disclaimer included in a Sponsored InMail creative. |
dimension |
creative.inmail_sender |
creative.inmail_sender |
The sender’s profile associated with a Sponsored InMail creative. |
dimension |
creative.is_direct_sponsored_content |
creative.is_direct_sponsored_content |
Indicates if the creative is a direct sponsored content, meaning it’s only shown as an ad and not as an organic post on a company page. |
dimension |
creative.job_ad_button_label |
creative.job_ad_button_label |
The text label displayed on the call-to-action button for a job ad creative. |
dimension |
creative.name |
creative.name |
The name of the creative. |
dimension |
creative.owner |
creative.owner |
The URN of the entity (e.g., organization or ad account) that owns or is associated with the ad creative. |
dimension |
creative.reference |
creative.reference |
A reference to the underlying asset or post that the creative is built upon, identified by a URN. |
dimension |
creative.resolved_url |
creative.resolved_url |
The final, resolved landing page URL for the ad creative after all redirects. |
dimension |
creative.review.reviewStatus |
creative.review.reviewStatus |
The editorial review status of the creative (e.g., approved, rejected, pending). |
dimension |
creative.servingStatuses |
creative.servingStatuses |
The current serving statuses of the creative, indicating if it’s active, paused, or pending. Can include multiple statuses. |
dimension |
creative.share |
creative.share |
The unique identifier (URN) of the LinkedIn share (post) that the ad creative is promoting. |
dimension |
creative.share_media_category |
creative.share_media_category |
The category of media being shared by the creative, such as IMAGE or VIDEO. |
dimension |
creative.sponsor_company |
creative.sponsor_company |
The company sponsoring the creative. |
dimension |
creative.sponsor_logo |
creative.sponsor_logo |
The URL of the sponsor company’s logo. |
dimension |
creative.spotlight_custom_background |
creative.spotlight_custom_background |
The custom background image used for a Dynamic Spotlight ad. |
dimension |
creative.spotlight_forum_name |
creative.spotlight_forum_name |
The forum name displayed in a Spotlight ad creative. |
dimension |
creative.spotlight_logo |
creative.spotlight_logo |
The logo used for a Spotlight ad creative. |
dimension |
creative.status |
creative.status |
The current status of the creative, such as ‘ACTIVE’, ‘PAUSED’, ‘DRAFT’. |
dimension |
creative.subject |
creative.subject |
The subject line of the creative, often used for InMail ads. |
dimension |
creative.text |
creative.text |
The main body text content of the creative. |
dimension |
creative.text_click_uri |
creative.text_click_uri |
The URI associated with a click on the text component of the creative. |
dimension |
creative.text_vector_image |
creative.text_vector_image |
The vector image used for a text ad creative. |
dimension |
creative.title |
creative.title |
The title of the creative. |
dimension |
creative.type |
creative.type |
The type of the creative, such as ‘SponsoredUpdateCreative’, ‘TextAdCreative’, ‘VideoAdCreative’. |
dimension |
creative.variables.clickUri |
creative.variables.clickUri |
The click-through URI defined within the creative’s variables. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.activity |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.activity |
The activity URN for a sponsored update carousel creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.directSponsoredContent |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.directSponsoredContent |
The direct sponsored content associated with a Sponsored Update Carousel creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.share |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.share |
Information related to the organic or sponsored share that forms the basis of the Sponsored Update Carousel creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.activity |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.activity |
The activity URN for a sponsored update creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent |
The direct sponsored content associated with a Sponsored Update creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share |
Information related to the organic or sponsored share that forms the basis of the Sponsored Update creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.directSponsoredContent |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.directSponsoredContent |
The direct sponsored content associated with a Sponsored Video creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.durationMicro |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.durationMicro |
The duration of the video creative in microseconds. |
metric |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.mediaAsset |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.mediaAsset |
The URN of the media asset (video file) used in the Sponsored Video creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.userGeneratedContentPost |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.userGeneratedContentPost |
The URN of the user-generated content post associated with a sponsored video creative. |
dimension |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId |
The identifier of the image used in a Text Ad creative. |
dimension |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.vectorImage |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.vectorImage |
The vector image URN for a Text Ad Creative. |
dimension |
creative.version.versionTag |
creative.version.versionTag |
A unique identifier or tag representing the version of the creative object within the API. |
metric |
creative.video_external_distribution_channel_type |
creative.video_external_distribution_channel_type |
The type of external distribution channel used for the video creative. |
dimension |
creative.video_lifecycle_state |
creative.video_lifecycle_state |
The lifecycle state of a video creative, indicating its processing or availability status. |
dimension |
creative.video_primary_landing_page_url |
creative.video_primary_landing_page_url |
The primary landing page URL for a video creative. |
dimension |
creative.video_share_commentary |
creative.video_share_commentary |
The commentary text accompanying a video share creative. |
dimension |
creative.video_share_media |
creative.video_share_media |
The media URN for the video being shared by the creative. |
dimension |
creative.video_share_media_category |
creative.video_share_media_category |
The category of the video media being shared by the creative. |
dimension |
creative.video_share_media_description |
creative.video_share_media_description |
The description for the video media being shared by the creative. |
dimension |
creative.video_share_media_landing_page |
creative.video_share_media_landing_page |
The landing page URL for the video media being shared by the creative. |
dimension |
creative.video_share_media_text |
creative.video_share_media_text |
The text content associated with the video media being shared by the creative. |
dimension |
creative.video_share_media_title |
creative.video_share_media_title |
The title for the video media being shared by the creative. |
dimension |
creative.video_target_audience |
creative.video_target_audience |
The intended target audience for the video creative. |
dimension |
creative.video_ugc_origin |
creative.video_ugc_origin |
The origin of the user-generated content (UGC) video. |
dimension |
creative.video_visibility |
creative.video_visibility |
The visibility setting of a video ad creative, determining who can view it (e.g., public, unlisted). |
dimension |
creative_id |
creative_id |
The unique identifier for an ad creative. |
dimension |
data_currency |
data_currency |
The currency in which monetary data is reported. |
dimension |
dateRange |
dateRange |
The inclusive date range for which the report data is requested or provided, specified in UTC. |
dimension |
documentCompletions |
documentCompletions |
The number of times a document ad was fully completed/read. |
metric |
documentFirstQuartileCompletions |
documentFirstQuartileCompletions |
The number of times a document ad was read through its first quartile (25%). |
metric |
documentMidpointCompletions |
documentMidpointCompletions |
The number of times a document ad was read through its midpoint (50%). |
metric |
documentThirdQuartileCompletions |
documentThirdQuartileCompletions |
The number of times a document ad was read through its third quartile (75%). |
metric |
downloadClicks |
downloadClicks |
The number of times users clicked to indicate an intent to download media from an ad, available for ad formats supporting media downloads. |
metric |
endDate |
endDate |
The end date of the reporting period or campaign. |
dimension |
externalWebsiteConversions |
externalWebsiteConversions |
The total number of desired actions taken by users on an external website after interacting with or viewing an ad. |
dimension |
externalWebsitePostClickConversions |
externalWebsitePostClickConversions |
The total number of desired actions taken by users on an external website specifically after clicking on an ad. |
dimension |
externalWebsitePostViewConversions |
externalWebsitePostViewConversions |
The total number of desired actions taken by users on an external website specifically after viewing an ad. |
dimension |
follows |
follows |
The number of new followers gained, applicable to Sponsored Content and Follower ads. |
metric |
format_size |
format_size |
The size or format specifications of the creative, such as image dimensions. |
dimension |
format_type |
format_type |
The category or type of ad creative format, such as video, image, or text. |
dimension |
fullScreenPlays |
fullScreenPlays |
The number of times members engaged with a video ad by entering full screen mode. |
dimension |
headlineClicks |
headlineClicks |
The number of clicks on the headline of conversation ads. |
metric |
headlineImpressions |
headlineImpressions |
The number of impressions recorded for an ad’s headline. |
metric |
id |
id |
A unique identifier for the entity, such as an ad account, campaign, or creative. |
dimension |
impression_device_type.value |
impression_device_type.value |
The type of device on which an ad impression occurred, such as desktop or mobile. This is a pivot for grouping ad analytics data. |
dimension |
impressions |
impressions |
The number of times an ad, particularly Sponsored Content, was displayed to users, or the number of sends for Sponsored Messaging. |
metric |
jobApplications |
jobApplications |
The number of times users applied for a job advertised through a LinkedIn Ads campaign. |
metric |
jobApplyClicks |
jobApplyClicks |
The number of times a member clicked the ‘apply’ button on a LinkedIn jobs page after engaging with an ad that leads to a LinkedIn job landing page. |
metric |
landingPageClicks |
landingPageClicks |
The number of clicks that directed users to the ad creative’s designated landing page. |
dimension |
language |
language |
The language targeted by the campaign or associated with the ad’s locale. |
dimension |
last_refresh_date |
last_refresh_date |
The timestamp indicating when the ad account data was last modified or refreshed in the LinkedIn Ads API. |
dimension |
leadGenerationMailContactInfoShares |
leadGenerationMailContactInfoShares |
The number of times contact information was shared via Lead Gen Forms in Sponsored Messaging campaigns. |
dimension |
leadGenerationMailInterestedClicks |
leadGenerationMailInterestedClicks |
The number of clicks by recipients of Sponsored Messaging ads indicating interest in a lead generation offer. |
dimension |
likes |
likes |
The number of ‘likes’ received on Sponsored Content. |
metric |
member_company.localizedName |
member_company.localizedName |
The localized name of the company a member is associated with, used for demographic reporting. |
dimension |
member_company_size.value |
member_company_size.value |
The size category of the company a member works for, used for demographic reporting. This is a pivot for grouping ad analytics data. |
dimension |
member_country.name |
member_country.name |
The name of the country associated with the LinkedIn member who engaged with the ad. |
dimension |
member_county.name |
member_county.name |
The name of the county associated with the member’s location, used for demographic reporting. |
dimension |
member_industry.$URN |
member_industry.$URN |
The Uniform Resource Name (URN) for a member’s industry, used to uniquely identify the industry for demographic reporting. This is a pivot for grouping ad analytics data. |
dimension |
member_industry.id |
member_industry.id |
The unique identifier for a member’s industry. |
metric |
member_industry.name.localized.en_US |
member_industry.name.localized.en_US |
The English (US) localized name of the member’s industry. |
dimension |
member_job_function.$URN |
member_job_function.$URN |
The Uniform Resource Name (URN) for a member’s job function, used to uniquely identify the job function for demographic reporting. This is a pivot for grouping ad analytics data. |
dimension |
member_job_function.id |
member_job_function.id |
The unique identifier for a member’s job function, used for demographic reporting. |
metric |
member_job_function.name.localized.en_US |
member_job_function.name.localized.en_US |
The English (US) localized name of the member’s job function. |
dimension |
member_region.name |
member_region.name |
The name of the region associated with the LinkedIn member who engaged with the ad. |
dimension |
name |
name |
The name or label of the entity, such as an ad account, campaign, or conversion. |
dimension |
oneClickLeadFormOpens |
oneClickLeadFormOpens |
The number of times users opened a lead form for a One Click Lead Gen campaign. |
dimension |
oneClickLeads |
oneClickLeads |
The number of leads generated through One Click Lead Gen campaigns. |
dimension |
opens |
opens |
The number of times Sponsored Messaging ads were opened by recipients. |
metric |
otherEngagements |
otherEngagements |
The count of user interactions with an ad unit that do not fall into other specific engagement categories. |
dimension |
pivot |
pivot |
A dimension used to group and break down performance metrics in ad analytics reports, such as ACCOUNT, CAMPAIGN, or CREATIVE. |
dimension |
pivotValue |
pivotValue |
A specific value for a selected pivot in an analytics report. |
dimension |
pivotValues |
pivotValues |
A collection of specific values for the selected pivot(s) in an analytics report. |
dimension |
pivotValues.{NUM} |
pivotValues.{NUM} |
The specific values for the chosen pivot(s) in an analytics report. |
dimension |
placement_name.value |
placement_name.value |
The name of the placement where the ad is displayed (e.g., LinkedIn Feed, Audience Network). |
dimension |
postClickJobApplications |
postClickJobApplications |
The number of times a member completed a job application after clicking on an ad. |
metric |
postClickJobApplyClicks |
postClickJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after clicking an ad with a LinkedIn job landing page. |
metric |
postClickRegistrations |
postClickRegistrations |
The number of times a member registered for an event or seminar after clicking on an ad leading to a LinkedIn landing page. |
metric |
postViewJobApplications |
postViewJobApplications |
The number of job applications submitted after viewing an ad, without clicking. |
metric |
postViewJobApplyClicks |
postViewJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after viewing an ad with a LinkedIn job landing page. |
metric |
postViewRegistrations |
postViewRegistrations |
The number of registrations completed after viewing an ad, without clicking. |
metric |
quarters |
quarters |
The fiscal quarter(s) within a reporting period for ad performance data. |
dimension |
reactions |
reactions |
The number of positive reactions (e.g., like, insightful, curious) on Sponsored Content. |
metric |
registrations |
registrations |
The number of times users completed a registration action after engaging with an ad. |
metric |
sends |
sends |
The number of times Sponsored Messaging ads were sent to recipients. |
metric |
shares |
shares |
The number of times Sponsored Content was shared by users. |
metric |
startDate |
startDate |
The start date of the reporting period or campaign. |
dimension |
status |
status |
The current operational state of the associated LinkedIn Ads entity, such as an ad campaign or creative. |
dimension |
subscriptionClicks |
subscriptionClicks |
The number of clicks on a subscription-related call to action in an ad. |
metric |
talentLeads |
talentLeads |
The number of leads generated specifically for talent-related objectives. |
metric |
targeting |
targeting |
The specific criteria used to define the audience for an ad campaign, such as demographics, company information, skills, or interests. This information helps understand which audience segments an ad was designed to reach. |
dimension |
targeting_type |
targeting_type |
The method or category of audience targeting applied. |
dimension |
textUrlClicks |
textUrlClicks |
The number of clicks on text-based URLs or links embedded within the body of a Sponsored Messaging ad. |
dimension |
totalEngagements |
totalEngagements |
The total number of all user interactions with the ad unit, combining various engagement types. |
metric |
type |
type |
The classification or category of an entity, such as an ad account type, campaign type, or creative type. |
dimension |
url |
url |
The URL associated with an ad creative or landing page, used for tracking where users are directed. |
dimension |
urn |
urn |
The Uniform Resource Name (URN) that uniquely identifies an entity (e.g., account, campaign, creative). |
dimension |
validWorkEmailLeads |
validWorkEmailLeads |
The number of leads generated that include a valid work email address, often tracked via Lead Gen Forms or conversion tracking. |
metric |
videoCompletions |
videoCompletions |
The number of times a video ad was played 97-100% of its duration, including watches that skipped to this point. |
dimension |
videoFirstQuartileCompletions |
videoFirstQuartileCompletions |
The number of times a video ad was played through the first quartile (25%) of its duration, including watches that skipped to this point. |
dimension |
videoMidpointCompletions |
videoMidpointCompletions |
The number of times a video ad was played through its midpoint (50%) duration, including watches that skipped to this point. |
dimension |
videoStarts |
videoStarts |
The number of times a video ad began playing by users. |
dimension |
videoThirdQuartileCompletions |
videoThirdQuartileCompletions |
The number of times a video ad was played through the third quartile (75%) of its duration, including watches that skipped to this point. |
dimension |
videoViews |
videoViews |
A video ad playing for at least 2 continuous seconds with 50% in-view, or a click on the Call To Action, whichever comes first. |
metric |
viralCardClicks |
viralCardClicks |
The number of clicks on individual cards within a carousel ad that resulted from viral impressions, applicable for non-demographic pivots. |
metric |
viralCardImpressions |
viralCardImpressions |
The number of organic impressions for each card within a carousel ad. |
metric |
viralClicks |
viralClicks |
The number of clicks that originated from viral impressions on Sponsored Content. |
dimension |
viralCommentLikes |
viralCommentLikes |
The count of likes on comments that originated from viral impressions of a Sponsored Content ad. |
metric |
viralComments |
viralComments |
The number of organic comments received on an ad or sponsored content. |
dimension |
viralCompanyPageClicks |
viralCompanyPageClicks |
The number of clicks to view the company page resulting from viral impressions on Sponsored Content. |
dimension |
viralDocumentCompletions |
viralDocumentCompletions |
The number of times users completed viewing an entire document ad, indicating full engagement with the content. |
metric |
viralDocumentFirstQuartileCompletions |
viralDocumentFirstQuartileCompletions |
The number of times users completed viewing the first 25% of a document ad. |
metric |
viralDocumentMidpointCompletions |
viralDocumentMidpointCompletions |
The number of times users completed viewing 50% (midpoint) of a document ad. |
metric |
viralDocumentThirdQuartileCompletions |
viralDocumentThirdQuartileCompletions |
The number of times users completed viewing 75% (third quartile) of a document ad. |
metric |
viralDownloadClicks |
viralDownloadClicks |
The number of times users clicked to download media from a viral ad, available for ads supporting media downloads. |
metric |
viralExternalWebsiteConversions |
viralExternalWebsiteConversions |
The number of organic conversions that occurred on an external website after users engaged with an ad. |
dimension |
viralExternalWebsitePostClickConversions |
viralExternalWebsitePostClickConversions |
The number of post-click conversions on an external website attributed to viral clicks on an ad. |
dimension |
viralExternalWebsitePostViewConversions |
viralExternalWebsitePostViewConversions |
The number of organic conversions on an external website attributed to a view of an ad, rather than a direct click. |
dimension |
viralFollows |
viralFollows |
The number of organic follows gained as a result of ad engagement. |
dimension |
viralFullScreenPlays |
viralFullScreenPlays |
The number of times a video ad creative was played in full-screen mode by users, indicating engagement beyond initial view. |
dimension |
viralImpressions |
viralImpressions |
The number of organic (non-paid) impressions an ad or sponsored content has received. |
dimension |
viralJobApplications |
viralJobApplications |
The number of job applications driven by viral or organic reach attributed to an ad campaign. |
metric |
viralJobApplyClicks |
viralJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after viewing or clicking on a viral ad leading to a LinkedIn job landing page. |
metric |
viralLandingPageClicks |
viralLandingPageClicks |
The number of clicks on viral impressions that directed users to the ad creative’s landing page on Sponsored Content. |
dimension |
viralLikes |
viralLikes |
The number of organic likes received on an ad or sponsored content. |
dimension |
viralOneClickLeadFormOpens |
viralOneClickLeadFormOpens |
The number of times users opened a lead form for a Lead Gen campaign originating from viral impressions. |
dimension |
viralOneClickLeads |
viralOneClickLeads |
The number of leads generated through One Click Lead Gen campaigns from viral impressions. |
dimension |
viralOtherEngagements |
viralOtherEngagements |
The number of other organic engagement actions (not clicks, likes, shares, or comments) on an ad. |
dimension |
viralPostClickJobApplications |
viralPostClickJobApplications |
The number of times a member completed a job application after clicking on a viral ad. |
metric |
viralPostClickJobApplyClicks |
viralPostClickJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after clicking on a viral ad that had a LinkedIn job landing page. |
metric |
viralPostClickRegistrations |
viralPostClickRegistrations |
The number of times a member registered for an event or seminar after clicking on a viral ad that led to a LinkedIn landing page. |
metric |
viralPostViewJobApplications |
viralPostViewJobApplications |
The number of job applications resulting from users who viewed an ad post and subsequently applied for a job, including viral reach. |
metric |
viralPostViewJobApplyClicks |
viralPostViewJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after viewing a viral ad that had a LinkedIn job landing page. |
metric |
viralPostViewRegistrations |
viralPostViewRegistrations |
The number of registrations resulting from users who viewed an ad post and subsequently registered, including viral reach. |
metric |
viralReactions |
viralReactions |
The total number of organic reactions (likes, comments, shares, etc.) on an ad or sponsored content. |
metric |
viralRegistrations |
viralRegistrations |
The number of registrations driven by viral or organic reach attributed to an ad campaign. |
metric |
viralShares |
viralShares |
The number of organic shares of an ad or sponsored content. |
dimension |
viralSubscriptionClicks |
viralSubscriptionClicks |
The number of clicks on ads that led to a subscription (e.g., newsletter, premium content), including viral reach. |
metric |
viralTotalEngagements |
viralTotalEngagements |
The total number of organic engagement actions (likes, comments, shares, etc.) on an ad. |
dimension |
viralVideoCompletions |
viralVideoCompletions |
The number of organic video ads that played to 97-100% completion. |
dimension |
viralVideoFirstQuartileCompletions |
viralVideoFirstQuartileCompletions |
The number of organic video ads that played through the first 25% duration. |
dimension |
viralVideoMidpointCompletions |
viralVideoMidpointCompletions |
The number of organic video ads that played through the 50% duration (midpoint). |
dimension |
viralVideoStarts |
viralVideoStarts |
The number of organic video ad plays that were initiated. |
dimension |
viralVideoThirdQuartileCompletions |
viralVideoThirdQuartileCompletions |
The number of organic video ads that played through the 75% duration. |
dimension |
viralVideoViews |
viralVideoViews |
The number of organic (non-paid) views a video ad has received. |
dimension |