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 whether an entity, such as a campaign or ad, is currently active.

dimension

Date

Date

The date covered by the report data point, specified in UTC.

dimension

DayofWeek

DayofWeek

The day of the week when the ad activity occurred.

dimension

First Touch Campaign

First Touch Campaign

The name of the first campaign a user interacted with in their customer journey.

dimension

First Touch Medium

First Touch Medium

The marketing medium (e.g., social, organic search, email) associated with the first interaction a user had.

dimension

First Touch Source

First Touch Source

The marketing source (e.g., LinkedIn, Google) associated with the first interaction a user had.

dimension

Last Touch Campaign

Last Touch Campaign

The name of the last campaign a user interacted with before a conversion or desired action.

dimension

Last Touch Medium

Last Touch Medium

The marketing medium (e.g., social, organic search, email) associated with the last interaction a user had before a conversion.

dimension

Last Touch Source

Last Touch Source

The marketing source (e.g., LinkedIn, Google) associated with the last interaction a user had before a conversion.

dimension

Platform

Platform

The advertising platform where campaigns and ads are managed and displayed, which for this data integration, is LinkedIn.

dimension

WeekAsDate

WeekAsDate

The specific date representing the week for which the campaign performance data is reported, allowing for weekly analysis of ad metrics.

dimension

WeekNum

WeekNum

The numerical representation of the week in the year.

metric

Year

Year

The year corresponding to the report data point.

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 advertisement account.

dimension

account_name

account_name

A label or name for the advertisement 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.

metric

ad_id_ad_format

ad_id_ad_format

The format of the advertisement, such as text ad, image ad, or video ad.

dimension

ad_id_country

ad_id_country

The country targeted by the specific advertisement.

dimension

ad_id_cta

ad_id_cta

The Call To Action (CTA) associated with a specific ad creative.

dimension

ad_id_language

ad_id_language

The language of the advertisement.

dimension

ad_id_targeting

ad_id_targeting

The specific targeting criteria applied to the advertisement, defining its intended audience.

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

averageDwellTime

averageDwellTime

Average user dwell time (in seconds). It measures the duration for which more than 50% of the ad’s pixels remain visible in the viewport. This metric is only supported from API version 202411 onwards.

metric

campaign

campaign

The name of the campaign.

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.

metric

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.

dimension

campaign.runSchedule.start

campaign.runSchedule.start

The start date and time of the campaign’s run schedule.

dimension

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.audienceMatchingSegments

campaign.targeting.excludedTargetingFacets.audienceMatchingSegments

Segments of members who will be excluded from the advertising campaign’s targeting based on audience matching segments.

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.retargetingSegments

campaign.targeting.excludedTargetingFacets.retargetingSegments

Segments of members who will be excluded from the advertising campaign’s targeting based on retargeting segments.

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.excludedTargetingFacets.staffCountRanges

campaign.targeting.excludedTargetingFacets.staffCountRanges

Ranges of staff counts (company sizes) that will be excluded from the advertising campaign’s targeting.

dimension

campaign.targeting.excludedTargetingFacets.titles

campaign.targeting.excludedTargetingFacets.titles

Specific job titles that will be excluded from the advertising campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.audienceMatchingSegments

campaign.targeting.includedTargetingFacets.audienceMatchingSegments

Segments of members who will be included in the advertising campaign’s targeting based on audience matching segments.

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.groups

campaign.targeting.includedTargetingFacets.groups

Groups of members who will be included in the advertising 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.interfaceLocales

campaign.targeting.includedTargetingFacets.interfaceLocales

Interface locales that will be included in the advertising campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.jobFunctions

campaign.targeting.includedTargetingFacets.jobFunctions

Standardized job functions of members who will be included in the advertising campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.locations

campaign.targeting.includedTargetingFacets.locations

Geographic locations that will be included in the advertising campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.profileLocations

campaign.targeting.includedTargetingFacets.profileLocations

Profile locations of members who will be included in the advertising campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.retargetingSegments

campaign.targeting.includedTargetingFacets.retargetingSegments

Segments of members who will be included in the advertising campaign’s targeting based on retargeting segments.

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.targeting.includedTargetingFacets.skills

campaign.targeting.includedTargetingFacets.skills

Specific skills of members who will be included in the advertising campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.staffCountRanges

campaign.targeting.includedTargetingFacets.staffCountRanges

Ranges of staff counts (company sizes) that will be included in the advertising campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.titles

campaign.targeting.includedTargetingFacets.titles

Specific job titles that will be included in the advertising 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.

dimension

campaignGroup

campaignGroup

A grouping of multiple related campaigns, used for organizational and reporting purposes.

dimension

campaign_account

campaign_account

The account where the campaign is running.

dimension

campaign_associatedEntity

campaign_associatedEntity

The entity (e.g., an organization or product) that the campaign is associated with, often identified by a URN (Uniform Resource Name).

dimension

campaign_audienceExpansionEnabled

campaign_audienceExpansionEnabled

Indicates whether audience expansion is enabled for the campaign, allowing LinkedIn to reach a broader audience similar to your defined target.

dimension

campaign_changeAuditStamps_created_time

campaign_changeAuditStamps_created_time

The timestamp when the campaign was created according to audit records.

metric

campaign_changeAuditStamps_lastModified_time

campaign_changeAuditStamps_lastModified_time

The timestamp when the campaign was last modified according to audit records.

metric

campaign_costType

campaign_costType

The cost type of the campaign (e.g., CPC, CPM, CPS).

dimension

campaign_creativeSelection

campaign_creativeSelection

Defines the method or strategy used to select creatives for delivery within the campaign.

dimension

campaign_dailyBudget_amount

campaign_dailyBudget_amount

The daily budget amount for the campaign.

metric

campaign_dailyBudget_currencyCode

campaign_dailyBudget_currencyCode

The currency code for the campaign’s daily budget.

dimension

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.

dimension

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.

dimension

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.

dimension

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_group_name

campaign_group_name

The name of the campaign group to which this campaign belongs.

dimension

campaign_id

campaign_id

The unique identifier for the campaign.

dimension

campaign_locale_country

campaign_locale_country

The country code for the campaign’s locale.

dimension

campaign_locale_language

campaign_locale_language

The language code for the campaign’s locale.

dimension

campaign_name

campaign_name

The name of the campaign, used for identification and recall of its purpose.

dimension

campaign_objectiveType

campaign_objectiveType

The objective type of the campaign (e.g., website visits, lead generation, brand awareness).

dimension

campaign_offsiteDeliveryEnabled

campaign_offsiteDeliveryEnabled

Indicates if the campaign is enabled for offsite delivery, allowing ads to be shown on websites and apps outside of LinkedIn.

dimension

campaign_offsitePreferences_iabCategories_exclude

campaign_offsitePreferences_iabCategories_exclude

A list of IAB (Interactive Advertising Bureau) categories to exclude for offsite campaign delivery, preventing ads from appearing on sites related to these categories.

dimension

campaign_runSchedule_end

campaign_runSchedule_end

The exclusive (strictly less than) date when the campaign is scheduled to stop running. If unset, it indicates an open range with no end date.

metric

campaign_runSchedule_start

campaign_runSchedule_start

The inclusive (greater than or equal to) date when the campaign is scheduled to start running.

metric

campaign_servingStatuses

campaign_servingStatuses

The current serving statuses for a campaign, indicating its operational state (e.g., running, paused).

dimension

campaign_status

campaign_status

The current status of the campaign.

dimension

campaign_totalBudget_amount

campaign_totalBudget_amount

The total budget amount for the entire duration of the campaign.

metric

campaign_totalBudget_currencyCode

campaign_totalBudget_currencyCode

The currency code for the campaign’s total budget.

dimension

campaign_type

campaign_type

The type of the campaign (e.g., Sponsored Content, Text Ad, Message Ad).

dimension

campaign_unitCost_amount

campaign_unitCost_amount

The unit cost amount for the campaign (e.g., cost per click, cost per impression).

metric

campaign_unitCost_currencyCode

campaign_unitCost_currencyCode

The currency code for the campaign’s unit cost.

dimension

campaign_urn

campaign_urn

The Universal Resource Name (URN) that uniquely identifies a campaign within LinkedIn.

dimension

campaign_version_versionTag

campaign_version_versionTag

An internal tag or identifier representing a specific version of a campaign object within the LinkedIn Ads API, used for tracking changes or updates to the campaign’s configuration.

metric

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.

metric

conversion.account

conversion.account

The account associated with the conversion event.

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.enabled

conversion.enabled

Indicates whether the conversion rule is enabled to match on the advertiser’s website.

dimension

conversion.id

conversion.id

A unique identifier for the conversion event or conversion rule.

dimension

conversion.imagePixelTag

conversion.imagePixelTag

An identifier for the image pixel (e.g., LinkedIn Insight Tag) associated with a conversion event, used to track user actions on external websites for attribution and optimization.

dimension

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 for the value of the conversion.

dimension

conversion.viewThroughAttributionWindowSize

conversion.viewThroughAttributionWindowSize

Specifies the duration (in days) for the view-through (post-view) attribution window for conversions.

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.

metric

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.

metric

costType

costType

The billing model or type of cost associated with the advertising campaign, such as Cost Per Click (CPC) or Cost Per Mille (CPM).

dimension

createdAt

createdAt

The timestamp when the entity was created.

dimension

createdAt.date

createdAt.date

The date when the entity was created.

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.

dimension

creative.changeAuditStamps.lastModified.time

creative.changeAuditStamps.lastModified.time

The timestamp indicating the last time the creative was modified.

dimension

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.

dimension

creative.description

creative.description

The descriptive text for the creative, providing details about the ad.

dimension

creative.format

creative.format

The format of the ad creative, such as image, video, or text, defining its visual and interactive presentation on LinkedIn’s platform.

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 the ad creative.

dimension

creative_name

creative_name

The name given to the creative asset used in the advertisement.

dimension

creative_title

creative_title

The title of the ad creative.

dimension

dailyBudget.amount

dailyBudget.amount

The monetary amount allocated as the daily budget for a campaign.

dimension

dailyBudget.currencyCode

dailyBudget.currencyCode

The currency code for the daily budget amount (e.g., USD, EUR).

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 users reached 100% of the document’s length in a document ad, including those that skipped to this point. This metric is only available for document ads and not all dimensions.

metric

documentFirstQuartileCompletions

documentFirstQuartileCompletions

The number of times users reached the first quartile of the document’s length in a document ad, including those that skipped to this point. This metric is only available for document ads and not all dimensions.

metric

documentMidpointCompletions

documentMidpointCompletions

The number of times users reached the second quartile (midpoint) of the document’s length in a document ad, including those that skipped to this point. This metric is only available for document ads and not all dimensions.

metric

documentThirdQuartileCompletions

documentThirdQuartileCompletions

The number of times users reached the third quartile of the document’s length in a document ad, including those that skipped to this point. This metric is only available for document ads and not all dimensions.

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.

metric

externalWebsitePostClickConversions

externalWebsitePostClickConversions

The total number of desired actions taken by users on an external website specifically after clicking on an ad.

metric

externalWebsitePostViewConversions

externalWebsitePostViewConversions

The total number of desired actions taken by users on an external website specifically after viewing an ad.

metric

follows

follows

The number of new followers gained, applicable to Sponsored Content and Follower ads.

metric

fullScreenPlays

fullScreenPlays

The number of times members engaged with a video ad by entering full screen mode.

metric

headlineClicks

headlineClicks

The number of clicks on the headline of conversation ads.

metric

headlineImpressions

headlineImpressions

The number of times members were shown the headline of conversation ads.

metric

id

id

A unique identifier for the entity, such as an ad account, campaign, or creative.

metric

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 a member completed a job application after viewing or clicking on an ad. This metric is broken down into post-view and post-click job applications.

metric

jobApplyClicks

jobApplyClicks

The number of times a member clicked on the job’s apply button on a LinkedIn jobs page after viewing or clicking on an ad which has a LinkedIn job landing page. This metric is broken down into post-view and post-click job apply clicks.

metric

landingPageClicks

landingPageClicks

The number of clicks that directed users to the ad creative’s designated landing page.

metric

leadGenerationMailContactInfoShares

leadGenerationMailContactInfoShares

The number of times contact information was shared via Lead Gen Forms in Sponsored Messaging campaigns.

metric

leadGenerationMailInterestedClicks

leadGenerationMailInterestedClicks

The number of clicks by recipients of Sponsored Messaging ads indicating interest in a lead generation offer.

metric

likes

likes

The number of ‘likes’ received on Sponsored Content.

metric

locale.country

locale.country

The country associated with the locale settings of an ad or account.

dimension

locale.language

locale.language

The language associated with the locale settings of an ad or account.

dimension

media_cost

media_cost

The total cost incurred for media placements.

metric

medium

medium

The advertising medium or channel.

dimension

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 where the LinkedIn member (target audience) is located. This is a demographic breakdown field.

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_job_title.$URN

member_job_title.$URN

The Universal Resource Name (URN) that uniquely identifies a LinkedIn member’s job title.

dimension

member_job_title.function

member_job_title.function

The job function associated with the member’s job title. Used for demographic reporting.

dimension

member_job_title.id

member_job_title.id

The unique identifier for the member’s job title. Used for demographic reporting.

dimension

member_job_title.name.localized.en_US

member_job_title.name.localized.en_US

The localized name of the job title for members engaging with campaigns, in en_US locale. Used for demographic reporting.

dimension

member_job_title.superTitle

member_job_title.superTitle

The high-level category or super title associated with a LinkedIn member’s job title, used for demographic targeting and reporting.

dimension

member_region.name

member_region.name

The name of the region associated with the LinkedIn member who engaged with the ad.

dimension

member_seniority.id

member_seniority.id

The unique identifier for the member’s seniority level. Used for demographic reporting.

dimension

member_seniority.name.localized.en_US

member_seniority.name.localized.en_US

The localized name of the seniority level for members engaging with campaigns, in en_US locale. Used for demographic reporting.

dimension

name

name

The name or label of the entity, such as an ad account, campaign, or conversion.

dimension

objectiveType

objectiveType

The marketing objective of the campaign (e.g., Brand Awareness, Website Visits, Lead Generation).

dimension

oneClickLeadFormOpens

oneClickLeadFormOpens

The number of times users opened a lead form for a One Click Lead Gen campaign.

metric

oneClickLeads

oneClickLeads

The number of leads generated through One Click Lead Gen campaigns.

metric

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.

metric

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

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

runSchedule.end

runSchedule.end

The timestamp indicating the end of the campaign’s scheduled run.

dimension

runSchedule.end.date

runSchedule.end.date

The date indicating the end of the campaign’s scheduled run.

dimension

runSchedule.start

runSchedule.start

The timestamp indicating the start of the campaign’s scheduled run.

dimension

runSchedule.start.date

runSchedule.start.date

The date indicating the start of the campaign’s scheduled run.

dimension

sends

sends

The number of times Sponsored Messaging ads were sent to recipients.

metric

servingStatuses

servingStatuses

The current serving statuses that indicate whether an ad or campaign is active, paused, or pending.

dimension

shares

shares

The number of times Sponsored Content was shared by users.

metric

source

source

The source of the advertising traffic, often ‘LinkedIn’.

dimension

spend

spend

The cost of the campaign in the account’s local currency.

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

textUrlClicks

textUrlClicks

The number of clicks on text-based URLs or links embedded within the body of a Sponsored Messaging ad.

metric

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

unitCost.amount

unitCost.amount

The amount of the unit cost for a campaign.

dimension

unitCost.currencyCode

unitCost.currencyCode

The currency code for the unit cost of a campaign.

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

videoCompletions

videoCompletions

The number of times a video ad was played 97-100% of its duration, including watches that skipped to this point.

metric

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.

metric

videoMidpointCompletions

videoMidpointCompletions

The number of times a video ad was played through its midpoint (50%) duration, including watches that skipped to this point.

metric

videoStarts

videoStarts

The number of times a video ad began playing by users.

metric

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.

metric

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.

metric

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.

metric

viralCompanyPageClicks

viralCompanyPageClicks

The number of clicks to view the company page resulting from viral impressions on Sponsored Content.

metric

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.

metric

viralExternalWebsitePostClickConversions

viralExternalWebsitePostClickConversions

The number of post-click conversions on an external website attributed to viral clicks on an ad.

metric

viralExternalWebsitePostViewConversions

viralExternalWebsitePostViewConversions

The number of organic conversions on an external website attributed to a view of an ad, rather than a direct click.

metric

viralFollows

viralFollows

The number of organic follows gained as a result of ad engagement.

metric

viralFullScreenPlays

viralFullScreenPlays

The number of times a video ad creative was played in full-screen mode by users, indicating engagement beyond initial view.

metric

viralImpressions

viralImpressions

The number of organic (non-paid) impressions an ad or sponsored content has received.

metric

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.

metric

viralLikes

viralLikes

The number of organic likes received on an ad or sponsored content.

metric

viralOneClickLeadFormOpens

viralOneClickLeadFormOpens

The number of times users opened a lead form for a Lead Gen campaign originating from viral impressions.

metric

viralOneClickLeads

viralOneClickLeads

The number of leads generated through One Click Lead Gen campaigns from viral impressions.

metric

viralOtherEngagements

viralOtherEngagements

The number of other organic engagement actions (not clicks, likes, shares, or comments) on an ad.

metric

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.

metric

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.

metric

viralVideoCompletions

viralVideoCompletions

The number of organic video ads that played to 97-100% completion.

metric

viralVideoFirstQuartileCompletions

viralVideoFirstQuartileCompletions

The number of organic video ads that played through the first 25% duration.

metric

viralVideoMidpointCompletions

viralVideoMidpointCompletions

The number of organic video ads that played through the 50% duration (midpoint).

metric

viralVideoStarts

viralVideoStarts

The number of organic video ad plays that were initiated.

metric

viralVideoThirdQuartileCompletions

viralVideoThirdQuartileCompletions

The number of organic video ads that played through the 75% duration.

metric

viralVideoViews

viralVideoViews

The number of organic (non-paid) views a video ad has received.

metric