LinkedIn Ads: Most-used fields

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