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 group to which an advertiser belongs.

dimension

Audience

Audience

The target audience segment for an ad campaign.

dimension

AvailableImpressions

AvailableImpressions

metric

Bidding Strategy

Bidding Strategy

dimension

Bidding Type

Bidding Type

dimension

Buying Unit Type

Buying Unit Type

dimension

CAMPAIGN_STATUS

CAMPAIGN_STATUS

The current operational status of the ad campaign (e.g., ACTIVE, PAUSED, CANCELED).

dimension

CAMPAIGN_TYPE

CAMPAIGN_TYPE

The specific type or categorization of an ad campaign.

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

CONVERSION_DEVICE

CONVERSION_DEVICE

The type of device on which a conversion occurred.

dimension

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

dimension

Channel Harmonized

Channel Harmonized

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 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 associated with the ad or its target audience.

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

Market

Market

The geographical market targeted by an ad campaign.

dimension

MeasurableImpressions

MeasurableImpressions

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.

metric

OPTIMIZED

OPTIMIZED

dimension

Objective

Objective

The marketing objective of a campaign (e.g., brand awareness, lead generation).

dimension

Objective_Harmonized

Objective_Harmonized

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

dimension

Offer

Offer

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

dimension

PLACEMENT_LINKEDIN

PLACEMENT_LINKEDIN

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

dimension

Persona

Persona

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

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 origin of the ad traffic or data, typically ‘LinkedIn Ads’.

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

dimension

Spending Type

Spending Type

dimension

Stage

Stage

The marketing funnel stage targeted by the campaign.

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

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

Refers to the United States, typically used in geographic targeting or 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_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

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

["urn:li:adSegment:{ID}"]

["urn:li:adSegment:{ID}"]

A Uniform Resource Name (URN) identifying an advertising audience segment used for targeting.

dimension

["urn:li:country:gb"]

["urn:li:country:gb"]

A Uniform Resource Name (URN) identifying the country where the ad impression or interaction occurred, such as Great Britain (gb).

dimension

["urn:li:country:it"]

["urn:li:country:it"]

A Uniform Resource Name (URN) identifying the country where the ad impression or interaction occurred, such as Italy (it).

dimension

["urn:li:country:us"]

["urn:li:country:us"]

A Uniform Resource Name (URN) identifying the country where the ad impression or interaction occurred, such as United States (us).

dimension

["urn:li:degree:{ID}"]

["urn:li:degree:{ID}"]

A Uniform Resource Name (URN) identifying an educational degree held by the member, used for targeting or demographic insights.

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

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 local currency used for the ad account.

dimension

account.id

account.id

The unique identifier of the ad account.

metric

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 of the ad account, indicating its ability to serve ads.

dimension

account.status

account.status

dimension

account.totalBudget.amount

account.totalBudget.amount

The total budget amount allocated for the entire duration of 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

metric

account.type

account.type

dimension

account.version.versionTag

account.version.versionTag

The version tag associated with the ad account’s schema or data.

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

dimension

accounttype

accounttype

dimension

actionClicks

actionClicks

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

metric

adUnitClicks

adUnitClicks

The number of clicks on the ad unit itself, typically displayed with a Sponsored Messaging ad.

metric

ad_format

ad_format

The specific layout or presentation style of an ad.

dimension

ad_id_ad_format

ad_id_ad_format

The ad format associated with an ad’s identifier.

dimension

ad_id_country

ad_id_country

The country associated with an ad’s identifier.

dimension

ad_id_cta

ad_id_cta

The call-to-action associated with an ad’s identifier.

dimension

ad_id_language

ad_id_language

The language associated with an ad’s identifier.

dimension

ad_id_targeting

ad_id_targeting

The targeting criteria associated with an ad’s identifier.

dimension

ad_serving_method

ad_serving_method

dimension

advertiser

advertiser

The entity or company that is running the advertisement.

dimension

age

age

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

A reference to an advertising asset, such as an image, video, or document.

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

audience_segment

audience_segment

A specific segment of the audience targeted by an ad campaign.

dimension

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

business.line

business.line

dimension

business_line

business_line

dimension

buying_type

buying_type

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

dimension

campaign.dailyBudget.amount

campaign.dailyBudget.amount

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.

metric

campaign.locale.country

campaign.locale.country

The country code for the locale setting of the campaign.

dimension

campaign.locale.language

campaign.locale.language

The language code for the locale setting of the campaign.

dimension

campaign.name

campaign.name

The name of the ad 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

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

dimension

campaign.runSchedule.start

campaign.runSchedule.start

dimension

campaign.servingStatuses

campaign.servingStatuses

The current serving statuses of the campaign, indicating its ability to deliver ads.

dimension

campaign.status

campaign.status

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

Contextual ad sizes included in the campaign’s targeting criteria.

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

dimension

campaign.totalBudget.amount

campaign.totalBudget.amount

metric

campaign.totalBudget.currencyCode

campaign.totalBudget.currencyCode

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

metric

campaign.unitCost.currencyCode

campaign.unitCost.currencyCode

dimension

campaign.urn

campaign.urn

The Uniform Resource Name (URN) that uniquely identifies the campaign.

dimension

campaign.version.versionTag

campaign.version.versionTag

The version tag associated with the campaign’s schema or data.

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_end_date

campaign_end_date

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

dimension

campaign_group

campaign_group

A logical grouping of campaigns for organizational purposes.

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

metric

campaign_group.changeAuditStamps.lastModified.time

campaign_group.changeAuditStamps.lastModified.time

metric

campaign_group.id

campaign_group.id

The unique identifier of the campaign group.

metric

campaign_group.name

campaign_group.name

The name of the campaign group.

dimension

campaign_group.runSchedule.end

campaign_group.runSchedule.end

The exclusive end date and time for when a campaign group and its associated campaigns are scheduled to stop running.

metric

campaign_group.runSchedule.start

campaign_group.runSchedule.start

The inclusive start date and time for when a campaign group and its associated campaigns are scheduled to begin running.

metric

campaign_group.servingStatuses

campaign_group.servingStatuses

dimension

campaign_group.status

campaign_group.status

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_grouping

campaign_grouping

A category or identifier used to group campaigns for reporting or management.

dimension

campaign_id

campaign_id

The unique identifier for the advertising campaign.

dimension

campaign_name

campaign_name

The name of the advertising campaign.

dimension

campaign_objective

campaign_objective

The primary goal or objective set for the advertising campaign.

dimension

campaign_start_date

campaign_start_date

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

dimension

campaigncostType

campaigncostType

The cost model used for the campaign, such as CPC (cost per click) or CPM (cost per mille).

dimension

campaigncreativeSelection

campaigncreativeSelection

dimension

campaigntype

campaigntype

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

dimension

campaignunitCost.amount

campaignunitCost.amount

The monetary amount representing the unit cost 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.

dimension

changeAuditStamps.created.time.date

changeAuditStamps.created.time.date

The date component of the timestamp indicating when an entity was originally created.

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.

metric

commentLikes

commentLikes

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

metric

comments

comments

The number of comments received on Sponsored Content.

metric

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 category of the company, typically used for demographic targeting.

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 reference to the content associated with an ad, such as a post URN.

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

dimension

conversion.lastCallbackAt

conversion.lastCallbackAt

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

metric

conversion.lastModified

conversion.lastModified

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.

metric

conversion.value.currencyCode

conversion.value.currencyCode

The currency code (e.g., USD, EUR) for the monetary value of a conversion event.

dimension

conversion.viewThroughAttributionWindowSize

conversion.viewThroughAttributionWindowSize

The duration, in days, after an impression (view) during which a conversion can be attributed to that impression.

metric

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 monetary amount of ad spend per conversion.

metric

conversionRates.adSpendPerConversion.currencyCode

conversionRates.adSpendPerConversion.currencyCode

The currency code for the ad spend per conversion.

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

conversions

conversions

The total number of conversions attributed to an ad campaign.

metric

costInLocalCurrency

costInLocalCurrency

The total cost of the ad campaign in the account’s local currency, broken down by selected pivots and time granularity.

metric

costInUsd

costInUsd

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

metric

costType

costType

The 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

cpc_link

cpc_link

The cost-per-click for link clicks on an ad.

metric

cpl_lead

cpl_lead

The cost-per-lead for leads generated by an ad campaign.

metric

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 LinkedIn activity (e.g., post, share) that the creative is sponsoring.

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

dimension

creative.call_to_action_target

creative.call_to_action_target

dimension

creative.campaign

creative.campaign

The unique identifier of the campaign to which this creative belongs.

dimension

creative.changeAuditStamps.created.time

creative.changeAuditStamps.created.time

The timestamp indicating when the ad creative was originally created.

dimension

creative.changeAuditStamps.lastModified.time

creative.changeAuditStamps.lastModified.time

The timestamp indicating when the ad creative was last modified.

dimension

creative.company_name

creative.company_name

The name of the company associated with the ad creative.

dimension

creative.contentLandingPageUri

creative.contentLandingPageUri

The URI of the landing page where users are directed when interacting with the creative content.

dimension

creative.created_timestamp

creative.created_timestamp

The timestamp when the ad creative was initially created.

dimension

creative.description

creative.description

dimension

creative.headline

creative.headline

The main headline text displayed on the ad creative.

dimension

creative.id

creative.id

The unique identifier of the ad creative.

metric

creative.inmail_account

creative.inmail_account

The LinkedIn account used to send the Sponsored 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

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 assigned to the ad creative for identification.

dimension

creative.owner

creative.owner

dimension

creative.reference

creative.reference

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

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 (e.g., image, video, article) within the shared content promoted by the creative.

dimension

creative.sponsor_company

creative.sponsor_company

The company profile that is sponsoring the ad creative.

dimension

creative.sponsor_logo

creative.sponsor_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

dimension

creative.spotlight_logo

creative.spotlight_logo

dimension

creative.status

creative.status

dimension

creative.subject

creative.subject

dimension

creative.text

creative.text

The primary body text content of the ad creative.

dimension

creative.text_click_uri

creative.text_click_uri

The URI associated with clickable text elements within the ad creative.

dimension

creative.text_vector_image

creative.text_vector_image

dimension

creative.title

creative.title

The title displayed for the ad creative.

dimension

creative.type

creative.type

The specific type or format of the ad creative, distinct from the campaign type.

dimension

creative.variables.clickUri

creative.variables.clickUri

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

Data related to user activity or engagement with 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

Data related to user activity or engagement with a Sponsored Update creative.

dimension

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

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

The direct sponsored content associated with a Sponsored Update creative.

dimension

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

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

Information related to the organic or sponsored share that forms the basis of the Sponsored Update creative.

dimension

creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.directSponsoredContent

creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.directSponsoredContent

The direct sponsored content associated with a Sponsored Video creative.

dimension

creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.durationMicro

creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.durationMicro

The duration of the video creative in microseconds.

metric

creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.mediaAsset

creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.mediaAsset

The URN of the media asset (video file) used in the Sponsored Video creative.

dimension

creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.userGeneratedContentPost

creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.userGeneratedContentPost

dimension

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

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

The call-to-action details specific to a Spotlight Creative V2 ad.

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 Creative V2 ad.

dimension

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

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

The descriptive text for a Spotlight Creative V2 ad.

dimension

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

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

The forum name associated with a Spotlight Creative V2 ad.

dimension

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

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

The headline text for a Spotlight Creative V2 ad.

dimension

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

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

The logo used in a Spotlight Creative V2 ad.

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 Creative V2 ad.

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 main text content of a Text Ad creative.

dimension

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

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

The title of a Text Ad creative.

dimension

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

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

The vector image data used in a Text Ad creative, if applicable.

dimension

creative.version.versionTag

creative.version.versionTag

The version tag associated with the creative’s schema or data.

dimension

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

dimension

creative.video_primary_landing_page_url

creative.video_primary_landing_page_url

The primary landing page URL associated with a video ad creative.

dimension

creative.video_share_commentary

creative.video_share_commentary

dimension

creative.video_share_media

creative.video_share_media

dimension

creative.video_share_media_category

creative.video_share_media_category

dimension

creative.video_share_media_description

creative.video_share_media_description

dimension

creative.video_share_media_landing_page

creative.video_share_media_landing_page

dimension

creative.video_share_media_text

creative.video_share_media_text

dimension

creative.video_share_media_title

creative.video_share_media_title

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

dimension

creative.video_visibility

creative.video_visibility

dimension

creative_grouping

creative_grouping

A category or identifier used to group ad creatives for reporting or management.

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

ctr

The click-through rate, calculated as clicks divided by impressions.

metric

ctr_calculated

ctr_calculated

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

metric

ctr_link

ctr_link

The click-through rate specifically for link clicks.

metric

cvr_lead

cvr_lead

The conversion rate for leads, calculated as leads divided by clicks or impressions.

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

data_type

data_type

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

The specific day of the year for which the report data is aggregated.

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

metric

documentFirstQuartileCompletions

documentFirstQuartileCompletions

metric

documentMidpointCompletions

documentMidpointCompletions

metric

documentThirdQuartileCompletions

documentThirdQuartileCompletions

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 inclusive end date for the reporting period, typically part of a date range.

dimension

engagement

engagement

A general measure of user interaction with the ad.

metric

entity_id

entity_id

dimension

entity_type

entity_type

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.

metric

final_target_url

final_target_url

The ultimate landing page URL where users are directed after clicking on an ad.

dimension

follows

follows

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

metric

format

format

The specific display format or type of an ad creative or content.

dimension

format_size

format_size

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

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.

metric

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

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.

metric

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

maxage

maxage

metric

media_cost

media_cost

The cost associated with media placements for an ad campaign.

metric

media_platform_id

media_platform_id

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

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

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 localized name of the industry a member works in, typically in English (en_US), used for demographic reporting. This is a pivot for grouping ad analytics data.

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 localized name of a member’s job function, typically in English (en_US), used for demographic reporting. This is a pivot for grouping ad analytics data.

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 localized name of a member’s job title, typically in English (en_US), used for demographic reporting.

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 localized name of a member’s seniority level, typically in English (en_US), used for demographic reporting.

dimension

minage

minage

metric

name

name

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

dimension

nonchargeableClicks

nonchargeableClicks

metric

objectiveType

objectiveType

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

dimension

offsiteDeliveryEnabled

offsiteDeliveryEnabled

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

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

The location where an ad is displayed (e.g., LinkedIn feed, Audience Network).

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 attributed to a view of an ad, rather than a direct click.

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 attributed to a view of an ad, rather than a direct click.

metric

post_id

post_id

A unique identifier for a social post or share that is being promoted.

dimension

post_publish_date

post_publish_date

dimension

post_text

post_text

dimension

post_type

post_type

dimension

post_url

post_url

dimension

post_url_path

post_url_path

dimension

post_url_transfer_protocol

post_url_transfer_protocol

dimension

post_url_without_path

post_url_without_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

publisher

publisher

The entity or platform that published the ad.

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

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 unique identifier or reference for an entity, such as an ad creative or campaign.

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.

dimension

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.

dimension

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

servingHoldReasons

servingHoldReasons

dimension

servingStatuses

servingStatuses

A collection of statuses indicating whether an ad or campaign is active, paused, or facing other serving conditions.

dimension

servingStatuses.{NUM}

servingStatuses.{NUM}

A specific serving status for an ad or campaign, indicating whether it is active or paused.

dimension

shares

shares

The number of times Sponsored Content was shared by users.

metric

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 type of social ad unit.

dimension

social_comments

social_comments

The total number of comments on a social post or ad, including both direct and viral interactions.

metric

social_costs

social_costs

metric

social_engagements

social_engagements

The total number of interactions users had with social content or ads, encompassing clicks, likes, comments, and shares.

metric

social_follows

social_follows

The count of new followers gained through social content or ads.

metric

social_impressions

social_impressions

The total number of times social content or ads were displayed to users.

metric

social_likes

social_likes

The total number of likes received on social content or ads.

dimension

social_other_clicks

social_other_clicks

metric

social_platform

social_platform

The social media platform used for advertising.

dimension

social_reactions

social_reactions

The total count of positive reactions (e.g., likes, insightful, curious) on social content or ads.

metric

social_shares

social_shares

The total number of times social content or ads were shared by users.

metric

social_unit_size

social_unit_size

The size dimension of the social ad unit.

dimension

social_url_clicks

social_url_clicks

metric

social_video_starts

social_video_starts

The total number of times a video in social content or an ad began playing.

metric

social_video_views

social_video_views

The total number of times a video in social content or an ad was viewed, defined as playing for at least 2 continuous seconds with 50% in-view, or a CTA click.

metric

social_video_views_100

social_video_views_100

The total count of times a video in social content or an ad was viewed 97-100% of its duration.

metric

social_video_views_25

social_video_views_25

The total count of times a video in social content or an ad was viewed through the first quartile (25%) of its duration.

metric

social_video_views_50

social_video_views_50

The total count of times a video in social content or an ad was viewed through the midpoint (50%) of its duration.

metric

social_video_views_75

social_video_views_75

The total count of times a video in social content or an ad was viewed through the third quartile (75%) of its duration.

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 inclusive start date for the reporting period, typically part of a date range.

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

status

status

The current operational status of an entity, such as an ad account, campaign, or creative.

dimension

storyDeliveryEnabled

storyDeliveryEnabled

A boolean indicating whether delivery to LinkedIn Stories is enabled for an ad.

dimension

subscriptionClicks

subscriptionClicks

metric

talentLeads

talentLeads

The number of leads generated for talent acquisition purposes through advertising campaigns.

metric

target_url

target_url

The URL that users are directed to after interacting with an ad.

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

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) identifying a specific activity on LinkedIn, which could include a post or interaction.

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) identifying a digital media asset, such as an image or video, used in an ad creative.

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) representing an unknown or unidentifiable LinkedIn entity.

dimension

utm_a/b_test

utm_a/b_test

The UTM parameter indicating if the traffic originated from an A/B test.

dimension

utm_ad_type

utm_ad_type

The UTM parameter indicating the type of ad that generated the traffic.

dimension

utm_campaign

utm_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

dimension

utm_country

utm_country

The UTM parameter for the country from which the traffic originated.

dimension

utm_format

utm_format

The UTM parameter for the format of the ad that generated the traffic.

dimension

utm_goal

utm_goal

The UTM parameter indicating the goal associated with the campaign.

dimension

utm_language

utm_language

The UTM parameter for the language used in the campaign.

dimension

utm_market

utm_market

The UTM parameter for the market targeted by the campaign.

dimension

utm_medium

utm_medium

dimension

utm_product

utm_product

The UTM parameter for the product promoted in the campaign.

dimension

utm_source

utm_source

dimension

utm_term

utm_term

dimension

value

value

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

Represents the activity associated with a Sponsored Update creative, often linking to an organic post.

dimension

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

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

Indicates whether the creative is Direct Sponsored Content (dark post) not published organically on a LinkedIn Page.

dimension

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

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

The share associated with a Sponsored Update creative, which is the content being promoted.

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

vcr

vcr

The video completion rate, indicating how often a video is watched to its completion.

metric

version.versionTag

version.versionTag

A tag or identifier for the version of an API object or creative.

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.

metric

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

video_views

video_views

The total number of views for a video ad.

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 a document shared virally (organically after initial paid promotion) was completed.

metric

viralDocumentFirstQuartileCompletions

viralDocumentFirstQuartileCompletions

The number of times a document shared virally was viewed for at least the first 25% of its duration.

metric

viralDocumentMidpointCompletions

viralDocumentMidpointCompletions

The number of times a document shared virally was viewed for at least 50% of its duration.

metric

viralDocumentThirdQuartileCompletions

viralDocumentThirdQuartileCompletions

The number of times a document shared virally was viewed for at least 75% of its duration.

metric

viralDownloadClicks

viralDownloadClicks

The number of times users clicked to download media from a viral ad, available for ads supporting media downloads.

metric

viralExternalWebsiteConversions

viralExternalWebsiteConversions

The number of organic conversions that occurred on an external website after users engaged with an ad.

metric

viralExternalWebsitePostClickConversions

viralExternalWebsitePostClickConversions

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

metric

viralExternalWebsitePostViewConversions

viralExternalWebsitePostViewConversions

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

metric

viralFollows

viralFollows

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

metric

viralFullScreenPlays

viralFullScreenPlays

The number of organic full-screen plays for a video ad.

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 attributed to organic shares of a sponsored job post.

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 attributed to organic views of a sponsored job post.

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 attributed to organic views of a sponsored post with a registration goal.

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 attributed to organic shares of a sponsored post with a registration goal.

metric

viralShares

viralShares

The number of organic shares of an ad or sponsored content.

metric

viralSubscriptionClicks

viralSubscriptionClicks

The number of clicks on subscription links attributed to organic shares of a sponsored post.

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

year

year

The year associated with reporting data or a date.

dimension