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

ADVERTISER_ID

ADVERTISER_ID

The unique identifier for the advertiser.

dimension

ADVERTISER_NAME

ADVERTISER_NAME

The name of the advertiser.

dimension

APPROVED

APPROVED

Indicates that an ad creative or campaign has been approved to run.

dimension

ASSET_ID

ASSET_ID

The unique identifier for an advertising asset, such as an image or video.

dimension

ATTRIBUTION_WINDOW

ATTRIBUTION_WINDOW

The time frame within which a conversion or action is attributed to an ad interaction.

dimension

Account Name

Account Name

The human-readable name of the advertising account.

dimension

Active

ACTIVE

Indicates that a campaign or ad is currently running.

dimension

Ad Format

Ad Format

The specific format of the advertisement (e.g., Text Ad, Sponsored Content).

dimension

Ad ID

Ad ID

The unique identifier for an ad creative.

metric

Ad Type

Ad Type

The specific classification of an advertisement.

dimension

Ad_type

Ad_type

The format or type of the ad, such as single image, video, carousel, text ad, or message ad.

dimension

Advertiser Group Name

Advertiser Group Name

The name of the advertiser group.

dimension

Audience

Audience

The target audience segment for an ad campaign.

dimension

AvailableImpressions

AvailableImpressions

The number of impressions that were available for the ad, representing the total opportunities for the ad to be shown to users.

metric

Bidding Strategy

Bidding Strategy

The bidding strategy set for a campaign, which determines how bids are optimized to achieve campaign objectives. Examples include Maximum Delivery or Target Cost.

dimension

Bidding Type

Bidding Type

The specific method used for bidding, such as CPM (Cost Per Mille/Thousand Impressions), CPC (Cost Per Click), or oCPM (optimized Cost Per Mille).

dimension

Buying Unit Type

Buying Unit Type

The type of buying unit used for the ad campaign, such as bidding strategy or pricing model.

dimension

CARD_CLICKS

CARD_CLICKS

The number of clicks on a card within a carousel ad or similar interactive format.

dimension

CARD_ENGAGEMENTS

CARD_ENGAGEMENTS

The number of engagements with cards in an interactive ad format.

dimension

CAROUSEL_SWIPES

CAROUSEL_SWIPES

The number of times users swiped through a carousel ad.

dimension

COMPLETED

COMPLETED

Indicates that a campaign or ad has finished running.

dimension

CONVERSIONS

CONVERSIONS

The total number of desired actions users took after interacting with or viewing an ad, such as website purchases, registrations, or lead form submissions.

dimension

CONVERSION_DEVICE

CONVERSION_DEVICE

The type of device on which a conversion occurred.

dimension

COST

COST

The cost incurred for the advertising activities.

metric

CPC

CPC

The average cost per click (CPC) for the ad.

dimension

CPM

CPM

The average cost per mille (CPM) or cost per thousand impressions for the ad.

dimension

CREATIVE

CREATIVE

A pivot used to group ad analytics results by individual ad creative.

dimension

Campaign ID

Campaign ID

The unique identifier for the advertising campaign.

metric

Campaign Name

Campaign Name

The human-readable name of the advertising campaign.

dimension

Campaign Objective Normalized

Campaign Objective Normalized

A standardized or normalized representation of the campaign’s objective, such as lead generation or website traffic.

dimension

Campaign Product

Campaign Product

The product or service promoted within a specific campaign.

dimension

Campaign Type

Campaign Type

The type of campaign, such as Sponsored Updates, Sponsored InMails, or Text Ads. This can also be used as a filter for analytics data.

dimension

Channel Grouping

Channel Grouping

A categorization of marketing channels for reporting purposes.

dimension

Channel Harmonized

Channel Harmonized

A standardized or harmonized categorization of marketing channels.

dimension

Company Name

Company Name

The name of the company associated with a LinkedIn member who engaged with the ads, or the advertiser’s company name.

dimension

Country

Country

The country associated with the ad’s audience or targeting. This can be used as a pivot for demographic reporting.

dimension

Creative Duration

Creative Duration

The duration of the creative, particularly relevant for video or document ads, potentially reflecting metrics like video completion rates or average user dwell time.

dimension

Creative Engagement

CREATIVE_ENGAGEMENT

A campaign objective focused on driving user engagement with ad creatives, such as likes, comments, and shares.

dimension

Currency

Currency

The currency code used for financial metrics like cost and spend.

dimension

DAY

DAY

The specific day for which the reporting data is aggregated.

dimension

DOWNLOADS

DOWNLOADS

The number of times a downloadable asset, such as a document or app, was downloaded.

dimension

Date End

Date End

The inclusive end date of the reporting period for ad analytics.

dimension

Date Start

Date Start

The inclusive start date of the reporting period for ad analytics.

dimension

Date Stop

Date Stop

The end date when an ad or campaign stopped running.

dimension

DayofWeek

DayofWeek

The day of the week for reporting data.

dimension

DestinationURL

DestinationURL

The final URL where users are directed after clicking on an ad.

dimension

Device Type

Device Type

The type of device on which an ad was displayed (e.g., desktop, mobile).

dimension

ENGAGEMENTS

ENGAGEMENTS

The total number of interactions with an ad, including clicks, likes, comments, and shares.

metric

EUR

EUR

Indicates that the cost or other financial metric is in Euros.

dimension

First Touch Campaign

First Touch Campaign

The campaign that received the first recorded interaction in a conversion path.

dimension

First Touch Medium

First Touch Medium

The marketing channel that received the first recorded interaction in a conversion path.

dimension

First Touch Source

First Touch Source

The origin of the first recorded interaction in a conversion path.

dimension

GBP

GBP

Indicates that the cost or other financial metric is in British Pounds.

dimension

ID Advertiser Group

ID Advertiser Group

The unique identifier for the advertiser group.

metric

IMPRESSION_DEVICE

IMPRESSION_DEVICE

The type of device on which an ad impression was served.

dimension

LEADS

LEADS

The total number of leads generated through advertising efforts.

dimension

LINK_CLICKS

LINK_CLICKS

The number of clicks on a link within an ad that leads to an external destination.

dimension

LandingPage

LandingPage

The URL of the landing page associated with an ad.

dimension

Language

Language

The language target of the campaign or creative.

dimension

Last Touch Campaign

Last Touch Campaign

The campaign that received the last recorded interaction before a conversion.

dimension

Last Touch Medium

Last Touch Medium

The marketing channel that received the last recorded interaction before a conversion.

dimension

Last Touch Source

Last Touch Source

The origin of the last recorded interaction before a conversion.

dimension

MEDIA_TYPE

MEDIA_TYPE

The type of media used in the ad creative (e.g., image, video, text).

dimension

MeasurableImpressions

MeasurableImpressions

The number of impressions that were measurable, meaning they met industry standards for viewability.

metric

Media Cost

Media Cost

The total cost associated with media placements for an ad campaign.

dimension

Month

Month

The month in which the ad performance data was recorded. Data can be grouped by month.

dimension

OPTIMIZED

OPTIMIZED

Indicates whether a campaign is optimized for a specific objective.

dimension

Objective_Harmonized

Objective_Harmonized

A harmonized or standardized name for the campaign’s objective.

dimension

Offer

Offer

The specific offer or promotion presented in the ad.

dimension

Overall_Clicks

Overall_Clicks

The total count of all clicks on the ad unit.

metric

Overall_Impressions

Overall_Impressions

The total number of times an ad was displayed.

metric

PAID_ORGANIC

PAID_ORGANIC

A dimension indicating whether the impression or engagement originated from paid advertising or organic reach.

dimension

PLACEMENT_LINKEDIN

PLACEMENT_LINKEDIN

A specific placement where the ad was shown within the LinkedIn platform.

dimension

Persona

Persona

The target persona or audience segment for the campaign.

dimension

Platform

Platform

The advertising platform where the ad was run, which is LinkedIn in this context.

dimension

Platform Engagements

Platform Engagements

The total number of user interactions with an ad on the advertising platform.

metric

Post_Click_Conversions

Post_Click_Conversions

The total number of conversions attributed to users who clicked on an ad.

metric

Post_View_Conversions

Post_View_Conversions

The total number of conversions attributed to users who viewed an ad but did not click on it.

metric

Product/Brand

Product/Brand

The product or brand being advertised in a campaign.

dimension

Product/Theme

Product/Theme

The product category or theme associated with an ad campaign.

dimension

Publisher

Publisher

dimension

Report Date

Report Date

The date for which the report data is generated.

dimension

SPONSORED_INMAILS

SPONSORED_INMAILS

A campaign type for Sponsored Messaging ads (InMails).

dimension

SPONSORED_STATUS_UPDATE

SPONSORED_STATUS_UPDATE

A campaign type for Sponsored Content that appears in the feed.

dimension

SPONSORED_UPDATES

SPONSORED_UPDATES

A campaign type for Sponsored Content that appears in the feed.

dimension

Social Platform

Social Platform

The social media platform where the ad is served, which is LinkedIn in this context.

dimension

Social Unit Size

Social Unit Size

The size or format of the social ad unit.

dimension

Source

Source

The source of ad traffic or data, such as ‘LinkedIn’.

dimension

Specific Product

Specific Product

A more granular designation of the product being advertised.

dimension

Spend

Spend

The total amount of money spent on the ad campaign.

metric

Spending Category

Spending Category

The category of spending associated with the ad campaign.

dimension

Spending Type

Spending Type

The type of spending incurred for the ad campaign.

dimension

Stage

Stage

The stage of a live event associated with an ad campaign, such as ‘PRE_LIVE’, ‘LIVE’, or ‘POST_LIVE’.

dimension

Start

Start

The start date for the reporting period.

dimension

Start Month

Start Month

The starting month for an ad campaign or reporting period.

dimension

Start Year

Start Year

The starting year for an ad campaign or reporting period.

metric

Starting Month

Starting Month

The calendar month in which a campaign or reporting period begins.

dimension

Status

Status

The current operational state or approval status of an ad campaign, creative, or account within the LinkedIn Ads platform (e.g., Active, Paused, Archived).

dimension

TEXT_AD

TEXT_AD

A campaign type for text-based ads.

dimension

THRUPLAY

THRUPLAY

A video metric indicating plays that are completed or played for a significant duration (e.g., 15 seconds).

dimension

TOTAL_CONVERSIONS

TOTAL_CONVERSIONS

The aggregate count of all conversions recorded for a campaign or ad.

dimension

Targeting

Targeting

The audience targeting criteria applied to a campaign.

dimension

Targeting Type

Targeting Type

The type of targeting used for an ad campaign (e.g., audience, demographic).

dimension

Total Clicks

Total Clicks

The aggregate count of all clicks on the ad unit.

metric

URL_LINK

URL_LINK

The URL link associated with the ad or creative.

dimension

US

US

Indicates whether the ad performance data is specifically for users located in the United States, often used as a geographic breakdown for reporting.

dimension

USD

USD

Indicates that the cost or other financial metric is in United States Dollars.

dimension

UTM_ID

UTM_ID

The UTM tracking parameter for campaign identification.

dimension

VIDEO_PLAYS

VIDEO_PLAYS

The total number of times a video ad started playing.

dimension

VIDEO_VIEWS

VIDEO_VIEWS

The number of times a video ad has been played for at least 2 continuous seconds with 50% in-view, or when a call-to-action is clicked.

metric

VIDEO_VIEWS_100

VIDEO_VIEWS_100

The number of video views that reached 100% completion.

metric

VIDEO_VIEWS_25

VIDEO_VIEWS_25

The number of video views that reached 25% completion.

metric

VIDEO_VIEWS_3S

VIDEO_VIEWS_3S

The number of video views that lasted for at least 3 seconds.

dimension

VIDEO_VIEWS_50

VIDEO_VIEWS_50

The number of video views that reached 50% completion.

metric

VIDEO_VIEWS_75

VIDEO_VIEWS_75

The number of video views that reached 75% completion.

metric

Video View

VIDEO_VIEW

A campaign objective focused on optimizing for video views.

dimension

View_100

View_100

The count of times a video ad was viewed 97-100% of its duration.

metric

View_25

View_25

The count of times a video ad was viewed through the first quartile (25%) of its duration.

metric

View_50

View_50

The count of times a video ad was viewed through the midpoint (50%) of its duration.

metric

View_75

View_75

The count of times a video ad was viewed through the third quartile (75%) of its duration.

metric

ViewableImpressions

ViewableImpressions

The number of impressions that were deemed viewable according to industry standards, meaning a certain percentage of the ad was on screen for a minimum duration.

metric

Website Traffic

WEBSITE_TRAFFIC

A campaign objective focused on driving traffic to a website.

dimension

WeekAsDate

WeekAsDate

A date representing the start or end of a reporting week.

dimension

WeekNum

WeekNum

The week number within a year for reporting data.

metric

Year

Year

The year associated with the reported data, used for aggregating performance metrics on an annual basis.

metric

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.reference.id

account.reference.id

The identifier for the referenced ad account.

metric

account.reference.name

account.reference.name

The name of the referenced 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.totalBudget.amount

account.totalBudget.amount

The total budget amount set for the ad account.

metric

account.totalBudget.currencyCode

account.totalBudget.currencyCode

The currency code (e.g., USD, EUR) for the ad account’s total budget amount.

dimension

account.totalBudgetEndsAt

account.totalBudgetEndsAt

The date and time when the total budget allocated for the ad account is set to end.

metric

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

accountName

accountName

The name of the advertising account.

dimension

account_id

account_id

The unique identifier for the advertising account.

dimension

account_name

account_name

The name of the ad account.

dimension

accountcurrency

accountcurrency

The currency in which the ad account operates.

dimension

accountid

accountid

The unique identifier for the advertising account.

metric

accountstatus

accountstatus

The current status of the ad account, such as ‘ACTIVE’ or ‘CLOSED’.

dimension

accounttype

accounttype

The type of the ad account, such as ‘BUSINESS’ or ‘PERSONAL’.

dimension

actionClicks

actionClicks

The number of clicks on the action button within a Sponsored Messaging ad.

dimension

adUnitClicks

adUnitClicks

The number of clicks recorded on an ad unit.

metric

ad_id_ad_format

ad_id_ad_format

The ad format type associated with the ad’s unique identifier.

dimension

ad_id_country

ad_id_country

The country associated with the ad’s unique identifier, often indicating targeting.

dimension

ad_id_cta

ad_id_cta

The Call-to-Action (CTA) label associated with the ad’s unique identifier.

dimension

ad_id_language

ad_id_language

The language associated with the ad’s unique identifier, often indicating targeting.

dimension

ad_id_targeting

ad_id_targeting

The targeting criteria associated with the ad’s unique identifier.

dimension

ad_serving_method

ad_serving_method

Specifies the method by which an ad is served or displayed to users, influencing ad delivery and visibility.

dimension

advertiser

advertiser

The unique identifier for the advertiser.

dimension

age

age

The age demographic of the target audience for the campaign.

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

asset

asset

The unique identifier for an advertising asset, such as an image or video.

dimension

audienceExpansionEnabled

audienceExpansionEnabled

Indicates whether audience expansion is enabled for the campaign, allowing ads to reach a broader but similar audience beyond specified targeting.

dimension

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

The average time, in seconds, that users spend viewing the ad when at least 50% of its pixels are present on the screen.

metric

buying_type

buying_type

The buying type of the campaign, such as auction or fixed price.

dimension

callToAction.labelType

callToAction.labelType

The type of label used for the call-to-action button on an ad, such as ‘Learn More’ or ‘Sign Up’.

dimension

callToAction.target

callToAction.target

The destination URL or action associated with the call-to-action button.

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

campaign.campaignGroup

The campaign group to which a specific campaign belongs. This is a pivot for grouping ad analytics data.

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

campaign.optimizationTargetType

The primary goal or objective that the campaign is optimized for, such as lead generation or brand awareness.

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

campaign.targeting.excludedTargetingFacets.audienceMatchingSegments

A list of audience matching segments that are explicitly excluded from the campaign’s targeting.

dimension

campaign.targeting.excludedTargetingFacets.degrees

campaign.targeting.excludedTargetingFacets.degrees

Specific academic degrees excluded from the campaign’s target audience.

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

campaign.targeting.excludedTargetingFacets.employersAll

All employers specifically excluded from the campaign’s target audience.

dimension

campaign.targeting.excludedTargetingFacets.firstDegreeConnectionCompanies

campaign.targeting.excludedTargetingFacets.firstDegreeConnectionCompanies

Companies that are first-degree connections of the advertiser and are excluded from 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.groups

campaign.targeting.excludedTargetingFacets.groups

LinkedIn groups whose members are excluded from the campaign’s target audience.

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

campaign.targeting.excludedTargetingFacets.jobFunctions

Specific job functions excluded from the campaign’s target audience.

dimension

campaign.targeting.excludedTargetingFacets.locations

campaign.targeting.excludedTargetingFacets.locations

Geographic locations excluded from the campaign’s target audience.

dimension

campaign.targeting.excludedTargetingFacets.profileLocations

campaign.targeting.excludedTargetingFacets.profileLocations

Profile-based locations explicitly excluded from the campaign’s target audience.

dimension

campaign.targeting.excludedTargetingFacets.retargetingSegments

campaign.targeting.excludedTargetingFacets.retargetingSegments

A list of retargeting segments that are explicitly excluded from the campaign’s targeting.

dimension

campaign.targeting.excludedTargetingFacets.schools

campaign.targeting.excludedTargetingFacets.schools

Educational institutions explicitly excluded from the campaign’s target audience.

dimension

campaign.targeting.excludedTargetingFacets.segments

campaign.targeting.excludedTargetingFacets.segments

Audience segments explicitly excluded from the campaign’s target audience.

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

campaign.targeting.excludedTargetingFacets.skills

Specific skills explicitly excluded from the campaign’s target audience.

dimension

campaign.targeting.excludedTargetingFacets.staffCountRanges

campaign.targeting.excludedTargetingFacets.staffCountRanges

A list of staff count ranges (company sizes) that are explicitly excluded from the campaign’s targeting.

dimension

campaign.targeting.excludedTargetingFacets.titles

campaign.targeting.excludedTargetingFacets.titles

A list of job titles that are explicitly excluded from the campaign’s targeting.

dimension

campaign.targeting.excludedTargetingFacets.titlesAll

campaign.targeting.excludedTargetingFacets.titlesAll

All job titles explicitly excluded from the campaign’s target audience.

dimension

campaign.targeting.includedTargetingFacets.ageRanges

campaign.targeting.includedTargetingFacets.ageRanges

A list of age ranges that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.audienceMatchingSegments

campaign.targeting.includedTargetingFacets.audienceMatchingSegments

A list of audience matching segments that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.contextualAdSizes

campaign.targeting.includedTargetingFacets.contextualAdSizes

The contextual ad sizes included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.degrees

campaign.targeting.includedTargetingFacets.degrees

Specific academic degrees included in the campaign’s target audience.

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

campaign.targeting.includedTargetingFacets.employersAll

All employers specifically included in the campaign’s target audience.

dimension

campaign.targeting.includedTargetingFacets.employersPast

campaign.targeting.includedTargetingFacets.employersPast

Past employers included in the campaign’s target audience.

dimension

campaign.targeting.includedTargetingFacets.fieldsOfStudy

campaign.targeting.includedTargetingFacets.fieldsOfStudy

Specific fields of study included in the campaign’s target audience.

dimension

campaign.targeting.includedTargetingFacets.firstDegreeConnectionCompanies

campaign.targeting.includedTargetingFacets.firstDegreeConnectionCompanies

Companies that are first-degree connections of the advertiser and are included in 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.genders

campaign.targeting.includedTargetingFacets.genders

A list of genders that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.groups

campaign.targeting.includedTargetingFacets.groups

A list of LinkedIn groups that are explicitly included 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.interests

campaign.targeting.includedTargetingFacets.interests

User interests included in the campaign’s target audience.

dimension

campaign.targeting.includedTargetingFacets.interfaceLocales

campaign.targeting.includedTargetingFacets.interfaceLocales

A list of interface locales (language settings) that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.jobFunctions

campaign.targeting.includedTargetingFacets.jobFunctions

A list of job functions that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.locations

campaign.targeting.includedTargetingFacets.locations

A list of geographical locations that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.profileLocations

campaign.targeting.includedTargetingFacets.profileLocations

A list of profile-based geographical locations that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.retargetingSegments

campaign.targeting.includedTargetingFacets.retargetingSegments

A list of retargeting segments that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.schools

campaign.targeting.includedTargetingFacets.schools

Educational institutions included in the campaign’s target audience.

dimension

campaign.targeting.includedTargetingFacets.segments

campaign.targeting.includedTargetingFacets.segments

A list of audience segments 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.targeting.includedTargetingFacets.skills

campaign.targeting.includedTargetingFacets.skills

A list of professional skills that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.staffCountRanges

campaign.targeting.includedTargetingFacets.staffCountRanges

A list of staff count ranges (company sizes) that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.titles

campaign.targeting.includedTargetingFacets.titles

A list of job titles that are explicitly included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.titlesAll

campaign.targeting.includedTargetingFacets.titlesAll

All job titles specifically included in the campaign’s target audience.

dimension

campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.end

campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.end

The end value for the range of years of professional experience included in the campaign’s targeting.

dimension

campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.start

campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.start

The start value for the range of years of professional experience included in the campaign’s targeting.

metric

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

campaignGroup

campaignGroup

The unique identifier (URN) of the campaign group to which a campaign belongs.

dimension

campaignID

campaignID

The unique identifier for the advertising campaign.

metric

campaignName

campaignName

The human-readable name of the advertising campaign.

dimension

campaignStatus

campaignStatus

The current operational status of the campaign (e.g., active, paused, completed).

dimension

campaign_account

campaign_account

The unique identifier for the ad account associated with the campaign.

dimension

campaign_associatedEntity

campaign_associatedEntity

The entity (e.g., a LinkedIn Page or organization) associated with and sponsoring the ad campaign.

dimension

campaign_audienceExpansionEnabled

campaign_audienceExpansionEnabled

Indicates whether audience expansion is enabled for the campaign, allowing LinkedIn to automatically reach additional relevant audiences beyond the initial targeting.

dimension

campaign_changeAuditStamps_created_time

campaign_changeAuditStamps_created_time

The timestamp indicating when the campaign was originally created.

metric

campaign_changeAuditStamps_lastModified_time

campaign_changeAuditStamps_lastModified_time

The timestamp indicating the last time the campaign was modified.

metric

campaign_costType

campaign_costType

The cost type of the campaign, such as impressions (CPM) or clicks (CPC).

dimension

campaign_creativeSelection

campaign_creativeSelection

The method used to select and deliver creatives within a campaign, often involving optimization or sequential rotation.

dimension

campaign_dailyBudget_amount

campaign_dailyBudget_amount

The daily budget amount allocated for the campaign.

dimension

campaign_dailyBudget_currencyCode

campaign_dailyBudget_currencyCode

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

dimension

campaign_end_date

campaign_end_date

The date on which the advertising campaign is scheduled to end.

dimension

campaign_group

campaign_group

An organizational unit used to group related campaigns, often representing a larger advertising initiative.

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.

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.

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_grouping

campaign_grouping

A grouping or categorization applied to campaigns for reporting.

dimension

campaign_id

campaign_id

The unique identifier for the advertising 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 advertising campaign.

dimension

campaign_objective

campaign_objective

The primary goal or objective set for the advertising campaign.

dimension

campaign_objectiveType

campaign_objectiveType

The primary objective of the campaign, such as ‘Brand Awareness’, ‘Website Visits’, ‘Lead Generation’, or ‘Conversions’.

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

List of IAB content categories excluded for off-site placements within the LinkedIn Audience Network.

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_start_date

campaign_start_date

The date on which the advertising campaign is scheduled to begin.

dimension

campaign_status

campaign_status

The overall status of the campaign, such as ACTIVE, PAUSED, DRAFT, ARCHIVED.

dimension

campaign_totalBudget_amount

campaign_totalBudget_amount

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

metric

campaign_totalBudget_currencyCode

campaign_totalBudget_currencyCode

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

dimension

campaign_type

campaign_type

The type of the campaign, defining its structure and available features.

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

campaigncostType

campaigncostType

The cost type of the campaign, such as impressions (CPM) or clicks (CPC).

dimension

campaigncreativeSelection

campaigncreativeSelection

The method used to select and deliver creatives within a campaign, often involving optimization or sequential rotation.

dimension

campaigntype

campaigntype

The type or format of the advertising campaign (e.g., Sponsored Updates, Text Ad).

dimension

campaignunitCost.amount

campaignunitCost.amount

The unit cost amount for the campaign.

metric

campaignunitCost.currencyCode

campaignunitCost.currencyCode

The currency code for the campaign’s unit cost.

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

changeAuditStamps.created.actor

The URN of the actor who created the entity, as recorded in audit logs.

dimension

changeAuditStamps.created.time

changeAuditStamps.created.time

The timestamp indicating when an entity (e.g., ad, campaign, creative) was originally created.

metric

changeAuditStamps.created.time.date

changeAuditStamps.created.time.date

The date when the entity was created, as part of its change audit stamps.

dimension

changeAuditStamps.lastModified.actor

changeAuditStamps.lastModified.actor

The URN of the actor who last modified the entity, as recorded in audit logs.

dimension

changeAuditStamps.lastModified.time

changeAuditStamps.lastModified.time

The timestamp indicating when the entity was last modified.

metric

changeAuditStamps.lastModified.time.date

changeAuditStamps.lastModified.time.date

The date of the last modification recorded in the change audit trail for an entity.

dimension

chargeableClicks

chargeableClicks

The count of clicks for which the advertiser is charged.

metric

click_through_conversions

click_through_conversions

The number of conversions that occurred after a user clicked on an ad.

metric

click_through_purchases

click_through_purchases

The number of purchases that occurred after a user clicked on an ad.

metric

clicks

clicks

The total number of chargeable clicks on an ad, representing interactions like landing page views or company page visits.

dimension

commentLikes

commentLikes

The number of likes received on comments made on Sponsored Content.

metric

comments

comments

The number of comments received on Sponsored Content.

dimension

comments_social_engagments

comments_social_engagments

The number of comments received on a social post or ad.

metric

company

company

Information about the company associated with the ad or its target audience.

dimension

company.id

company.id

The unique identifier for the company.

metric

company.name

company.name

The name of the company.

dimension

companyPageClicks

companyPageClicks

The number of clicks that directed users to the company page associated with the ad.

metric

companySize

companySize

The size of the company targeted by the ad, or associated with the member. This can be used as a pivot for demographic reporting.

dimension

companySize.name

companySize.name

The name of the company size category.

dimension

company_size

company_size

The size category of the company, used for demographic reporting or targeting.

dimension

content.reference

content.reference

A URN (Uniform Resource Name) referring to the content of an ad creative or shared post.

dimension

conversion.account

conversion.account

The ad account to which the conversion event is attributed.

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 tracking or specific conversion rule is active.

dimension

conversion.id

conversion.id

A unique identifier for the conversion event or conversion rule.

metric

conversion.imagePixelTag

conversion.imagePixelTag

The identifier or configuration of the image pixel tag used to track specific conversion events on an advertiser’s website.

dimension

conversion.lastCallbackAt

conversion.lastCallbackAt

The timestamp of the last time a conversion tracking event was reported back to the server.

dimension

conversion.lastModified

conversion.lastModified

The timestamp indicating when the conversion entity was last modified.

metric

conversion.name

conversion.name

The name given to the conversion event or conversion rule for identification.

dimension

conversion.postClickAttributionWindowSize

conversion.postClickAttributionWindowSize

The duration, in days, after a click during which a conversion can be attributed to that click.

metric

conversion.type

conversion.type

The category or classification of the conversion event (e.g., Lead, Purchase).

dimension

conversion.urlRules

conversion.urlRules

The rules based on URLs that define when a conversion event should be triggered.

dimension

conversion.value.amount

conversion.value.amount

The monetary value associated with a conversion event.

dimension

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

conversionCost.amount

conversionCost.amount

The monetary amount representing the cost per conversion.

metric

conversionCost.currencyCode

conversionCost.currencyCode

The currency code for the cost per conversion.

dimension

conversionCount

conversionCount

The total number of conversions recorded for the ad campaign.

metric

conversionRates.adSpendPerConversion.amount

conversionRates.adSpendPerConversion.amount

The amount of ad spend per conversion.

metric

conversionRates.adSpendPerConversion.currencyCode

conversionRates.adSpendPerConversion.currencyCode

The currency code for the ad spend per conversion amount.

dimension

conversionRates.advertiserROAS

conversionRates.advertiserROAS

The Return on Ad Spend (ROAS) for the advertiser, indicating the revenue generated per unit of ad spend.

metric

conversionRates.postClickConversionRate

conversionRates.postClickConversionRate

The rate of conversions that occurred after a user clicked on an ad.

metric

conversionRates.viewThroughConversionRate

conversionRates.viewThroughConversionRate

The rate of conversions that occurred after a user viewed an ad but did not click on it.

metric

conversionStatistics.postClickConversions

conversionStatistics.postClickConversions

Statistical count of conversions attributed to users who clicked on an ad.

metric

conversionStatistics.viewThroughConversions

conversionStatistics.viewThroughConversions

Statistical count of conversions attributed to users who viewed an ad but did not click on it.

metric

conversionValue.amount

conversionValue.amount

The monetary value generated by conversions.

metric

conversionValue.currencyCode

conversionValue.currencyCode

The currency code for the conversion value.

dimension

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.

dimension

costInUsd

costInUsd

The total cost of the ad campaign in USD, broken down by selected pivots and time granularity.

metric

costType

costType

The method by which the cost is calculated for an ad or campaign.

dimension

cost_USD

cost_USD

The cost in United States Dollars (USD) based on the pivot and time granularity.

metric

country.name

country.name

The name of the country. This can be used as a pivot for demographic reporting.

dimension

country_name

country_name

The name of the country associated with reporting data or targeting.

dimension

createdAt

createdAt

The timestamp when an entity, such as an ad or campaign, was created.

dimension

createdAt.date

createdAt.date

The date when an entity, such as an ad or campaign, was created.

dimension

createdBy

createdBy

The identifier of the user who created the entity.

dimension

creative.activity

creative.activity

The activity associated with the creative, often referring to a sponsored update or social share.

dimension

creative.callToAction.labelType

creative.callToAction.labelType

The type of label used for the call-to-action button within an ad creative.

dimension

creative.callToAction.target

creative.callToAction.target

The destination URL or action associated with the call-to-action button within an ad creative.

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.

metric

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.SponsoredInMailCreativeVariables.content

creative.variables.data.com.linkedin.ads.SponsoredInMailCreativeVariables.content

The content body of a Sponsored InMail creative.

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.

dimension

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.SpotlightCreativeVariablesV2.callToAction

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.callToAction

The call-to-action text for a Spotlight Creative V2.

dimension

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.customBackground

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.customBackground

The custom background image or color used for a Spotlight ad creative.

dimension

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.description

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.description

The description for a Spotlight Creative V2.

dimension

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.forumName

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.forumName

The forum name specified within the variables of a Spotlight ad creative.

dimension

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.headline

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.headline

The headline for a Spotlight Creative V2.

dimension

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.logo

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.logo

The logo URN for a Spotlight Creative V2.

dimension

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.showMemberProfilePhoto

creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.showMemberProfilePhoto

Indicates whether the member’s profile photo is shown in a Spotlight ad 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.text

creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.text

The text content for a Text Ad Creative.

dimension

creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.title

creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.title

The title for 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_grouping

creative_grouping

The method or category used to organize and group different ad creatives for reporting and analysis.

dimension

creative_id

creative_id

The unique identifier for an ad creative.

dimension

creative_name

creative_name

The name assigned to an ad creative.

dimension

creative_title

creative_title

The title displayed as part of the ad creative.

dimension

ctr_calculated

ctr_calculated

The calculated click-through rate (CTR) for the ad.

metric

dailyBudget.amount

dailyBudget.amount

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

metric

dailyBudget.currencyCode

dailyBudget.currencyCode

The currency code for the daily campaign budget.

dimension

data_currency

data_currency

The currency in which monetary data is reported.

dimension

date

date

The specific date for which the ad performance data is reported. Data can be grouped by day.

dimension

dateRange

dateRange

The inclusive date range for which the report data is requested or provided, specified in UTC.

dimension

day_of_the_year

day_of_the_year

A dimension representing the day of the year for reporting purposes.

metric

device

device

The specific device used to view an ad.

dimension

device_type

device_type

The general type of device used to view an ad (e.g., mobile, desktop).

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

engagement

engagement

A general measure of user interaction with the ad.

metric

entity_id

entity_id

The unique identifier for an entity, often part of a Uniform Resource Name (URN).

dimension

entity_type

entity_type

The type of the entity, such as an ad account, campaign, or creative.

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.

dimension

externalWebsitePostViewConversions

externalWebsitePostViewConversions

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

dimension

final_target_url

final_target_url

The final URL where users are directed after clicking on an ad, after all redirects.

dimension

follows

follows

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

metric

format

format

The ad format used for the creative or campaign, such as Text Ad, Sponsored Content, or Video Ad.

dimension

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.

metric

function

function

The professional function or department of a LinkedIn member, used for audience targeting or demographic reporting.

metric

function.name

function.name

The name of a job function.

dimension

fy

fy

The fiscal year associated with the reporting period for ad performance data.

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

impressionCount

impressionCount

The total number of times an ad was displayed.

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.

dimension

industry

industry

The industry associated with a member or company.

metric

industry.name

industry.name

The name of the industry.

dimension

intendedStatus

intendedStatus

The desired or planned status for an ad or campaign (e.g., ACTIVE, PAUSED).

dimension

inventory_type

inventory_type

The type of inventory where ads are shown, such as LinkedIn Feed, Audience Network, etc.

dimension

isServing

isServing

A boolean indicating whether the ad or campaign is currently serving impressions.

dimension

isTest

isTest

A boolean indicating whether the ad account or campaign is a test entity, not served to real users.

dimension

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.

metric

lastModifiedAt

lastModifiedAt

The timestamp when the entity was last modified.

dimension

lastModifiedAt.date

lastModifiedAt.date

The date when the entity was last modified.

dimension

lastModifiedBy

lastModifiedBy

The identifier of the user who last modified the entity.

dimension

last_refresh_date

last_refresh_date

dimension

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

li_clicks

li_clicks

The number of clicks on LinkedIn ads.

metric

li_impressions

li_impressions

The number of impressions served for LinkedIn ads.

metric

likes

likes

The number of ‘likes’ received on Sponsored Content.

dimension

likes_social_engagments

likes_social_engagments

The number of likes received on a social post or ad.

metric

linkedin_clicks

linkedin_clicks

The number of clicks on LinkedIn-specific elements of an ad.

metric

linkedin_costs

linkedin_costs

The costs incurred for advertising on the LinkedIn platform.

metric

linkedin_creative_id

linkedin_creative_id

The unique identifier for an ad creative on LinkedIn.

dimension

linkedin_form_leads

linkedin_form_leads

The number of leads generated through LinkedIn Lead Gen Forms.

metric

linkedin_impressions

linkedin_impressions

The number of impressions served specifically on the LinkedIn platform.

metric

linkedin_leads

linkedin_leads

The number of leads generated directly through LinkedIn.

metric

linkedin_platform_campaign

linkedin_platform_campaign

The campaign identifier specific to the LinkedIn advertising platform.

dimension

linkedin_video_100

linkedin_video_100

The number of LinkedIn video plays that reached 100% completion.

metric

linkedin_video_25

linkedin_video_25

The number of LinkedIn video plays that reached 25% completion.

metric

linkedin_video_50

linkedin_video_50

The number of LinkedIn video plays that reached 50% completion.

metric

linkedin_video_75

linkedin_video_75

The number of LinkedIn video plays that reached 75% completion.

metric

linkedin_video_starts

linkedin_video_starts

The number of times a LinkedIn video ad started playing.

metric

locale.country

locale.country

The country code associated with the locale of the ad or targeted audience.

dimension

locale.language

locale.language

The language code associated with the locale of the ad or targeted audience.

dimension

market

market

The geographical market targeted by the ad campaign, typically represented by country or region.

dimension

maxage

maxage

The maximum age limit set for the target audience of the campaign.

metric

media_cost

media_cost

The cost associated with media placements for an ad campaign.

metric

media_platform_id

media_platform_id

An identifier for the media platform on which the ad was served. For LinkedIn Ads, this typically refers to LinkedIn itself.

dimension

medium

medium

The marketing channel or medium through which the ad is delivered.

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

member_country.$URN

The Uniform Resource Name (URN) for a member’s country, used for demographic reporting. This is a pivot for grouping ad analytics data.

dimension

member_country.countryCode

member_country.countryCode

The two-letter country code for a member’s country.

dimension

member_country.countryGroup

member_country.countryGroup

The geographical grouping of the member’s country.

dimension

member_country.name

member_country.name

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

dimension

member_country.name.locale.country

member_country.name.locale.country

The country component of the locale used to localize the member’s country name.

dimension

member_country.name.locale.language

member_country.name.locale.language

The language component of the locale used to localize the member’s country name.

dimension

member_country.name.value

member_country.name.value

The localized name of the member’s country.

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

member_job_title.$URN

The Uniform Resource Name (URN) for a member’s job title, used to uniquely identify the job title for demographic reporting. This is a pivot for grouping ad analytics data.

dimension

member_job_title.function

member_job_title.function

The job function associated with a member’s job title, used for demographic reporting.

dimension

member_job_title.id

member_job_title.id

The unique identifier for a member’s job title, used for demographic reporting.

metric

member_job_title.name.localized.en_US

member_job_title.name.localized.en_US

The English (US) localized name of the member’s job title.

dimension

member_job_title.superTitle

member_job_title.superTitle

A broader classification or ‘super title’ associated with a member’s specific job title, used for demographic 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 a member’s seniority level, used for demographic reporting. This is a pivot for grouping ad analytics data.

metric

member_seniority.name.localized.en_US

member_seniority.name.localized.en_US

The English (US) localized name of the member’s seniority level.

dimension

minage

minage

The minimum age limit set for the target audience of the campaign.

metric

name

name

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

dimension

nonchargeableClicks

nonchargeableClicks

The number of clicks on an ad that were deemed non-billable or invalid by the advertising platform.

metric

objective

objective

The marketing objective set for the ad campaign, such as lead generation, brand awareness, or website traffic.

dimension

objectiveType

objectiveType

The primary goal or objective of the advertising campaign, such as awareness, consideration, or conversion.

dimension

offsiteDeliveryEnabled

offsiteDeliveryEnabled

Indicates if the ad creative is enabled for delivery outside of the LinkedIn platform, on partnered websites or apps.

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

one_click_lead_form_open

one_click_lead_form_open

The number of times a one-click lead form was opened.

metric

opens

opens

The number of times Sponsored Messaging ads were opened by recipients.

metric

optimizationTargetType

optimizationTargetType

The specific metric or action that the campaign is optimized to achieve.

dimension

organicFollowerCount

organicFollowerCount

The number of organic followers gained through the ad activity.

metric

otherEngagements

otherEngagements

The count of user interactions with an ad unit that do not fall into other specific engagement categories.

metric

paidFollowerCount

paidFollowerCount

The number of followers gained through paid advertising campaigns.

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

placement

A specific placement where the ad was shown within the LinkedIn platform.

dimension

placement_id

placement_id

The identifier for the ad placement, indicating where the ad was displayed on the LinkedIn platform or audience network. This can be used as a pivot for grouping ad analytics data.

dimension

placement_name.value

placement_name.value

The name of the placement where the ad is displayed (e.g., LinkedIn Feed, Audience Network).

dimension

placement_type

placement_type

The category or type of ad placement.

dimension

platform_clicks

platform_clicks

The number of clicks recorded on the advertising platform.

metric

platform_impressions

platform_impressions

The number of impressions recorded on the advertising platform.

metric

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

post_id

post_id

The unique identifier of the organic post that is being promoted by a sponsored content creative.

dimension

post_publish_date

post_publish_date

The date when the organic post was published.

dimension

post_text

post_text

The textual content of the organic post.

dimension

post_type

post_type

The type of the organic post (e.g., text, image, video).

dimension

post_url

post_url

The URL of the organic post.

dimension

post_url_path

post_url_path

The specific path component of the destination URL for an ad creative, directing users to a particular page or section.

dimension

post_url_transfer_protocol

post_url_transfer_protocol

The transfer protocol (e.g., HTTP, HTTPS) used for the destination URL of an ad creative.

dimension

post_url_without_path

post_url_without_path

The base domain and subdomains of the destination URL for an ad creative, excluding any specific path.

dimension

product_brand

product_brand

The brand of the product being advertised.

dimension

product_theme

product_theme

The thematic category of the product being advertised.

dimension

q

q

A query parameter used to designate the specific finder method (e.g., analytics, statistics, attributedRevenueMetrics) for the ad analytics endpoint.

dimension

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

reactions_social_engagments

reactions_social_engagments

The number of reactions (e.g., likes, loves, insights) received on a social post or ad.

metric

reference

reference

A URN (Uniform Resource Name) referring to an associated entity, such as the organization or person advertising, or the content of a creative.

dimension

region

region

The geographical region associated with an ad campaign or target audience.

dimension

registrations

registrations

The number of times users completed a registration action after engaging with an ad.

metric

resolved_url

resolved_url

The final, resolved URL after any redirects or tracking parameters have been processed.

dimension

review.reviewStatus

review.reviewStatus

The status of an ad or creative review process.

dimension

review.status

review.status

The overall status of an ad or creative review, indicating approval or rejection.

dimension

runSchedule.end

runSchedule.end

The exclusive end date and time for when a campaign or campaign group is scheduled to stop running.

metric

runSchedule.end.date

runSchedule.end.date

The specific date portion of when a campaign or campaign group is scheduled to stop running.

dimension

runSchedule.start

runSchedule.start

The inclusive start date and time for when a campaign or campaign group is scheduled to begin running.

metric

runSchedule.start.date

runSchedule.start.date

The specific date portion of when a campaign or campaign group is scheduled to begin running.

dimension

sends

sends

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

metric

seniority

seniority

The professional seniority level of a targeted audience member.

metric

seniority.name

seniority.name

The name of the professional seniority level for a targeted audience member.

dimension

servingStatuses

servingStatuses

The current serving statuses of an entity.

dimension

servingStatuses.{NUM}

servingStatuses.{NUM}

The serving statuses of the entity, indicating its current state in the advertising system.

dimension

shares

shares

The number of times Sponsored Content was shared by users.

dimension

shares_social_engagments

shares_social_engagments

The number of shares received on a social post or ad.

metric

social_ad_unit

social_ad_unit

The specific social media advertisement unit, such as a Sponsored Content post, Sponsored Messaging ad, or dynamic ad format.

dimension

social_comments

social_comments

The number of comments received on a social post or ad.

metric

social_costs

social_costs

The total cost associated with social interactions or ads.

metric

social_engagements

social_engagements

The total number of engagements (likes, comments, shares, clicks) on a social post or ad.

metric

social_follows

social_follows

The number of new followers gained as a result of a social post or ad.

metric

social_impressions

social_impressions

The total number of times a social post or ad was displayed to users.

metric

social_likes

social_likes

The number of ‘likes’ or ‘reactions’ received on a social post or ad.

dimension

social_other_clicks

social_other_clicks

Clicks on elements of the ad other than the primary call-to-action or URL.

metric

social_platform

social_platform

The social media platform used for advertising.

dimension

social_reactions

social_reactions

The number of reactions (like, celebrate, love, insightful, curious) received on a social post or ad.

metric

social_shares

social_shares

The number of times a social post or ad was shared by users.

metric

social_unit_size

social_unit_size

The size or format of the social ad unit.

dimension

social_url_clicks

social_url_clicks

The number of clicks on the URL within a social post or ad.

metric

social_video_starts

social_video_starts

The number of times a video ad started playing.

metric

social_video_views

social_video_views

The total number of views for a video ad.

metric

social_video_views_100

social_video_views_100

The number of times a video ad was viewed to 100% completion.

metric

social_video_views_25

social_video_views_25

The number of times a video ad was viewed to at least 25% completion.

metric

social_video_views_50

social_video_views_50

The number of times a video ad was viewed to at least 50% completion.

metric

social_video_views_75

social_video_views_75

The number of times a video ad was viewed to at least 75% completion.

metric

specific_product

specific_product

A detailed identification of the product featured in the advertisement.

dimension

spend.amount

spend.amount

The monetary amount spent on an ad campaign or creative.

metric

spend.currencyCode

spend.currencyCode

The currency code for the amount spent on an ad campaign.

dimension

spend_in_account_currency

spend_in_account_currency

The total amount spent, expressed in the currency of the advertising account.

dimension

startDate

startDate

The start date of the reporting period or campaign.

dimension

startViews

startViews

The number of times a video ad began playing.

metric

start_month

start_month

The month in which an activity or campaign started.

dimension

start_year

start_year

The year in which an activity or campaign started.

metric

storyDeliveryEnabled

storyDeliveryEnabled

Indicates if the ad creative is enabled for delivery as a LinkedIn Story ad format.

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

target_url

target_url

The primary URL to which the ad creative directs users upon clicking.

dimension

targeting.includedTargetingFacets.ageRanges.{NUM}

targeting.includedTargetingFacets.ageRanges.{NUM}

A specific age range included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.employers.{NUM}

targeting.includedTargetingFacets.employers.{NUM}

A specific employer included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.fieldsOfStudy.{NUM}

targeting.includedTargetingFacets.fieldsOfStudy.{NUM}

A specific field of study included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.industries.{NUM}

targeting.includedTargetingFacets.industries.{NUM}

A specific industry included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.interfaceLocales.{NUM}.country

targeting.includedTargetingFacets.interfaceLocales.{NUM}.country

The country of a specific interface locale included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.interfaceLocales.{NUM}.language

targeting.includedTargetingFacets.interfaceLocales.{NUM}.language

The language of a specific interface locale included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.jobFunctions.{NUM}

targeting.includedTargetingFacets.jobFunctions.{NUM}

A specific job function included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.locations.{NUM}

targeting.includedTargetingFacets.locations.{NUM}

A specific geographical location included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.schools.{NUM}

targeting.includedTargetingFacets.schools.{NUM}

A specific school included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.seniorities.{NUM}

targeting.includedTargetingFacets.seniorities.{NUM}

A specific seniority level included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.staffCountRanges.{NUM}

targeting.includedTargetingFacets.staffCountRanges.{NUM}

A specific staff count range (company size) included in the targeting criteria for an ad campaign.

dimension

targeting.includedTargetingFacets.titles.{NUM}

targeting.includedTargetingFacets.titles.{NUM}

A specific job title included in the targeting criteria for an ad campaign.

dimension

targetingCriteria

targetingCriteria

The criteria used to define the audience that an ad campaign will target.

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.

metric

thumbnail_url

thumbnail_url

The URL of the thumbnail image associated with the creative or post.

dimension

totalBudget.amount

totalBudget.amount

The total monetary budget allocated for an ad campaign.

metric

totalBudget.currencyCode

totalBudget.currencyCode

The currency code for the total budget of an ad campaign.

dimension

totalBudgetEndsAt

totalBudgetEndsAt

The timestamp when the total budget for an ad campaign is set to end.

metric

totalEngagements

totalEngagements

The total number of all user interactions with the ad unit, combining various engagement types.

metric

totalFollowerCount

totalFollowerCount

The total number of followers for a LinkedIn page or entity.

metric

total_conversion_value

total_conversion_value

The total monetary value generated from all conversions.

dimension

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 monetary amount of the unit cost for an ad impression or click.

metric

unitCost.currencyCode

unitCost.currencyCode

The currency code for the unit cost of an ad impression or click.

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

urn:li:activity:{ID}

urn:li:activity:{ID}

A Uniform Resource Name (URN) that uniquely identifies a specific activity on the LinkedIn platform.

dimension

urn:li:adInMailContent:{ID}

urn:li:adInMailContent:{ID}

A Uniform Resource Name (URN) identifying the content of a Sponsored InMail ad.

dimension

urn:li:digitalmediaAsset:{ID}

urn:li:digitalmediaAsset:{ID}

A Uniform Resource Name (URN) that uniquely identifies a digital media asset, such as an image or video.

dimension

urn:li:organization:{ID}

urn:li:organization:{ID}

A Uniform Resource Name (URN) identifying an organization or company associated with the ad account, campaign, or member.

dimension

urn:li:share:{ID}

urn:li:share:{ID}

A Uniform Resource Name (URN) identifying a specific shared post or content item on LinkedIn that is being promoted as sponsored content.

dimension

urn:li:sponsoredAccount:{ID}

urn:li:sponsoredAccount:{ID}

A Uniform Resource Name (URN) identifying a sponsored ad account in LinkedIn Campaign Manager.

dimension

urn:li:sponsoredCampaign:{ID}

urn:li:sponsoredCampaign:{ID}

A Uniform Resource Name (URN) identifying a specific sponsored campaign within an ad account.

dimension

urn:li:sponsoredCreative:{ID}

urn:li:sponsoredCreative:{ID}

A Uniform Resource Name (URN) identifying a specific ad creative, which is the actual ad content displayed to users.

dimension

urn:li:unknown:{ID}

urn:li:unknown:{ID}

A Uniform Resource Name (URN) that identifies an entity of an unknown or unspecified type.

dimension

utm_a/b_test

utm_a/b_test

The UTM tracking parameter for A/B testing variations.

dimension

utm_ad_type

utm_ad_type

The UTM tracking parameter for the type of ad.

dimension

utm_campaign

utm_campaign

The UTM tracking parameter for campaign name, used to identify a specific campaign.

dimension

utm_campaign_name

utm_campaign_name

The UTM parameter for the name of the campaign that generated the traffic.

dimension

utm_content

utm_content

The UTM tracking parameter for content, used to differentiate between specific ad contents or links.

dimension

utm_country

utm_country

The UTM tracking parameter for the country associated with the ad.

dimension

utm_format

utm_format

The UTM tracking parameter for the format of the ad.

dimension

utm_goal

utm_goal

The UTM tracking parameter for the goal or objective of the ad.

dimension

utm_language

utm_language

The UTM tracking parameter for the language of the ad or target audience.

dimension

utm_market

utm_market

The UTM tracking parameter for the market targeted by the ad.

dimension

utm_medium

utm_medium

The UTM tracking parameter for medium, indicating the advertising or marketing medium (e.g., cpc, banner, email).

dimension

utm_product

utm_product

The UTM tracking parameter for the product promoted in the ad.

dimension

utm_source

utm_source

The UTM tracking parameter for source, identifying the source of traffic (e.g., LinkedIn, Google).

dimension

utm_term

utm_term

The UTM tracking parameter for keywords or specific terms related to the ad.

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

value

value

The monetary value associated with a conversion or action. This can represent conversion value in local currency.

metric

variables.clickUri

variables.clickUri

The URL where users are directed when they click on the ad creative.

dimension

variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.activity

variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.activity

The activity associated with a Sponsored Update creative, often a URN referring to the original post.

dimension

variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent

variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent

Variables related to direct sponsored content within a Sponsored Update creative.

dimension

variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share

variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share

Variables related to the shared content within a Sponsored Update creative.

dimension

variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId

variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId

The identifier for the image used in a Text Ad creative.

dimension

variables.data.com.linkedin.ads.TextAdCreativeVariables.text

variables.data.com.linkedin.ads.TextAdCreativeVariables.text

The body text content of a Text Ad creative.

dimension

variables.data.com.linkedin.ads.TextAdCreativeVariables.title

variables.data.com.linkedin.ads.TextAdCreativeVariables.title

The title of a Text Ad creative.

dimension

version.versionTag

version.versionTag

A tag or identifier indicating the specific version of an ad creative or ad form.

metric

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.

dimension

video_completion_25

video_completion_25

The number of video plays that reached 25% completion.

metric

video_completion_50

video_completion_50

The number of video plays that reached 50% completion.

metric

video_completion_75

video_completion_75

The number of video plays that reached 75% completion.

metric

video_completions

video_completions

The total number of times a video was played to 100% completion.

metric

video_starts

video_starts

The number of times a video ad started playing.

metric

view_through_conversions

view_through_conversions

The number of conversions that occurred after a user viewed an ad but did not click on it.

metric

view_through_purchases

view_through_purchases

The number of purchases that occurred after a user viewed an ad but did not click on it.

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.

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.

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