LinkedIn Ads: Most-used fields#
The table below gives information about most-used fields that you can import from LinkedIn Ads. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
ADVERTISER_ID |
ADVERTISER_ID |
The unique identifier for the advertiser. |
dimension |
ADVERTISER_NAME |
ADVERTISER_NAME |
The name of the advertiser. |
dimension |
APPROVED |
APPROVED |
Indicates that an ad creative or campaign has been approved to run. |
dimension |
ASSET_ID |
ASSET_ID |
The unique identifier for an advertising asset, such as an image or video. |
dimension |
ATTRIBUTION_WINDOW |
ATTRIBUTION_WINDOW |
The time frame within which a conversion or action is attributed to an ad interaction. |
dimension |
Account Name |
Account Name |
The human-readable name of the advertising account. |
dimension |
Active |
ACTIVE |
Indicates that a campaign or ad is currently running. |
dimension |
Ad Format |
Ad Format |
The specific format of the advertisement (e.g., Text Ad, Sponsored Content). |
dimension |
Ad ID |
Ad ID |
The unique identifier for an ad creative. |
metric |
Ad Type |
Ad Type |
The specific classification of an advertisement. |
dimension |
Ad_type |
Ad_type |
The format or type of the ad, such as single image, video, carousel, text ad, or message ad. |
dimension |
Advertiser Group Name |
Advertiser Group Name |
The name of the advertiser group. |
dimension |
Audience |
Audience |
The target audience segment for an ad campaign. |
dimension |
AvailableImpressions |
AvailableImpressions |
The number of impressions that were available for the ad, representing the total opportunities for the ad to be shown to users. |
metric |
Bidding Strategy |
Bidding Strategy |
The bidding strategy set for a campaign, which determines how bids are optimized to achieve campaign objectives. Examples include Maximum Delivery or Target Cost. |
dimension |
Bidding Type |
Bidding Type |
The specific method used for bidding, such as CPM (Cost Per Mille/Thousand Impressions), CPC (Cost Per Click), or oCPM (optimized Cost Per Mille). |
dimension |
Buying Unit Type |
Buying Unit Type |
The type of buying unit used for the ad campaign, such as bidding strategy or pricing model. |
dimension |
CARD_CLICKS |
CARD_CLICKS |
The number of clicks on a card within a carousel ad or similar interactive format. |
dimension |
CARD_ENGAGEMENTS |
CARD_ENGAGEMENTS |
The number of engagements with cards in an interactive ad format. |
dimension |
CAROUSEL_SWIPES |
CAROUSEL_SWIPES |
The number of times users swiped through a carousel ad. |
dimension |
COMPLETED |
COMPLETED |
Indicates that a campaign or ad has finished running. |
dimension |
CONVERSIONS |
CONVERSIONS |
The total number of desired actions users took after interacting with or viewing an ad, such as website purchases, registrations, or lead form submissions. |
dimension |
CONVERSION_DEVICE |
CONVERSION_DEVICE |
The type of device on which a conversion occurred. |
dimension |
COST |
COST |
The cost incurred for the advertising activities. |
metric |
CPC |
CPC |
The average cost per click (CPC) for the ad. |
dimension |
CPM |
CPM |
The average cost per mille (CPM) or cost per thousand impressions for the ad. |
dimension |
CREATIVE |
CREATIVE |
A pivot used to group ad analytics results by individual ad creative. |
dimension |
Campaign ID |
Campaign ID |
The unique identifier for the advertising campaign. |
metric |
Campaign Name |
Campaign Name |
The human-readable name of the advertising campaign. |
dimension |
Campaign Objective Normalized |
Campaign Objective Normalized |
A standardized or normalized representation of the campaign’s objective, such as lead generation or website traffic. |
dimension |
Campaign Product |
Campaign Product |
The product or service promoted within a specific campaign. |
dimension |
Campaign Type |
Campaign Type |
The type of campaign, such as Sponsored Updates, Sponsored InMails, or Text Ads. This can also be used as a filter for analytics data. |
dimension |
Channel Grouping |
Channel Grouping |
A categorization of marketing channels for reporting purposes. |
dimension |
Channel Harmonized |
Channel Harmonized |
A standardized or harmonized categorization of marketing channels. |
dimension |
Company Name |
Company Name |
The name of the company associated with a LinkedIn member who engaged with the ads, or the advertiser’s company name. |
dimension |
Country |
Country |
The country associated with the ad’s audience or targeting. This can be used as a pivot for demographic reporting. |
dimension |
Creative Duration |
Creative Duration |
The duration of the creative, particularly relevant for video or document ads, potentially reflecting metrics like video completion rates or average user dwell time. |
dimension |
Creative Engagement |
CREATIVE_ENGAGEMENT |
A campaign objective focused on driving user engagement with ad creatives, such as likes, comments, and shares. |
dimension |
Currency |
Currency |
The currency code used for financial metrics like cost and spend. |
dimension |
DAY |
DAY |
The specific day for which the reporting data is aggregated. |
dimension |
DOWNLOADS |
DOWNLOADS |
The number of times a downloadable asset, such as a document or app, was downloaded. |
dimension |
Date End |
Date End |
The inclusive end date of the reporting period for ad analytics. |
dimension |
Date Start |
Date Start |
The inclusive start date of the reporting period for ad analytics. |
dimension |
Date Stop |
Date Stop |
The end date when an ad or campaign stopped running. |
dimension |
DayofWeek |
DayofWeek |
The day of the week for reporting data. |
dimension |
DestinationURL |
DestinationURL |
The final URL where users are directed after clicking on an ad. |
dimension |
Device Type |
Device Type |
The type of device on which an ad was displayed (e.g., desktop, mobile). |
dimension |
ENGAGEMENTS |
ENGAGEMENTS |
The total number of interactions with an ad, including clicks, likes, comments, and shares. |
metric |
EUR |
EUR |
Indicates that the cost or other financial metric is in Euros. |
dimension |
First Touch Campaign |
First Touch Campaign |
The campaign that received the first recorded interaction in a conversion path. |
dimension |
First Touch Medium |
First Touch Medium |
The marketing channel that received the first recorded interaction in a conversion path. |
dimension |
First Touch Source |
First Touch Source |
The origin of the first recorded interaction in a conversion path. |
dimension |
GBP |
GBP |
Indicates that the cost or other financial metric is in British Pounds. |
dimension |
ID Advertiser Group |
ID Advertiser Group |
The unique identifier for the advertiser group. |
metric |
IMPRESSION_DEVICE |
IMPRESSION_DEVICE |
The type of device on which an ad impression was served. |
dimension |
LEADS |
LEADS |
The total number of leads generated through advertising efforts. |
dimension |
LINK_CLICKS |
LINK_CLICKS |
The number of clicks on a link within an ad that leads to an external destination. |
dimension |
LandingPage |
LandingPage |
The URL of the landing page associated with an ad. |
dimension |
Language |
Language |
The language target of the campaign or creative. |
dimension |
Last Touch Campaign |
Last Touch Campaign |
The campaign that received the last recorded interaction before a conversion. |
dimension |
Last Touch Medium |
Last Touch Medium |
The marketing channel that received the last recorded interaction before a conversion. |
dimension |
Last Touch Source |
Last Touch Source |
The origin of the last recorded interaction before a conversion. |
dimension |
MEDIA_TYPE |
MEDIA_TYPE |
The type of media used in the ad creative (e.g., image, video, text). |
dimension |
MeasurableImpressions |
MeasurableImpressions |
The number of impressions that were measurable, meaning they met industry standards for viewability. |
metric |
Media Cost |
Media Cost |
The total cost associated with media placements for an ad campaign. |
dimension |
Month |
Month |
The month in which the ad performance data was recorded. Data can be grouped by month. |
dimension |
OPTIMIZED |
OPTIMIZED |
Indicates whether a campaign is optimized for a specific objective. |
dimension |
Objective_Harmonized |
Objective_Harmonized |
A harmonized or standardized name for the campaign’s objective. |
dimension |
Offer |
Offer |
The specific offer or promotion presented in the ad. |
dimension |
Overall_Clicks |
Overall_Clicks |
The total count of all clicks on the ad unit. |
metric |
Overall_Impressions |
Overall_Impressions |
The total number of times an ad was displayed. |
metric |
PAID_ORGANIC |
PAID_ORGANIC |
A dimension indicating whether the impression or engagement originated from paid advertising or organic reach. |
dimension |
PLACEMENT_LINKEDIN |
PLACEMENT_LINKEDIN |
A specific placement where the ad was shown within the LinkedIn platform. |
dimension |
Persona |
Persona |
The target persona or audience segment for the campaign. |
dimension |
Platform |
Platform |
The advertising platform where the ad was run, which is LinkedIn in this context. |
dimension |
Platform Engagements |
Platform Engagements |
The total number of user interactions with an ad on the advertising platform. |
metric |
Post_Click_Conversions |
Post_Click_Conversions |
The total number of conversions attributed to users who clicked on an ad. |
metric |
Post_View_Conversions |
Post_View_Conversions |
The total number of conversions attributed to users who viewed an ad but did not click on it. |
metric |
Product/Brand |
Product/Brand |
The product or brand being advertised in a campaign. |
dimension |
Product/Theme |
Product/Theme |
The product category or theme associated with an ad campaign. |
dimension |
Publisher |
Publisher |
dimension |
|
Report Date |
Report Date |
The date for which the report data is generated. |
dimension |
SPONSORED_INMAILS |
SPONSORED_INMAILS |
A campaign type for Sponsored Messaging ads (InMails). |
dimension |
SPONSORED_STATUS_UPDATE |
SPONSORED_STATUS_UPDATE |
A campaign type for Sponsored Content that appears in the feed. |
dimension |
SPONSORED_UPDATES |
SPONSORED_UPDATES |
A campaign type for Sponsored Content that appears in the feed. |
dimension |
Social Platform |
Social Platform |
The social media platform where the ad is served, which is LinkedIn in this context. |
dimension |
Social Unit Size |
Social Unit Size |
The size or format of the social ad unit. |
dimension |
Source |
Source |
The source of ad traffic or data, such as ‘LinkedIn’. |
dimension |
Specific Product |
Specific Product |
A more granular designation of the product being advertised. |
dimension |
Spend |
Spend |
The total amount of money spent on the ad campaign. |
metric |
Spending Category |
Spending Category |
The category of spending associated with the ad campaign. |
dimension |
Spending Type |
Spending Type |
The type of spending incurred for the ad campaign. |
dimension |
Stage |
Stage |
The stage of a live event associated with an ad campaign, such as ‘PRE_LIVE’, ‘LIVE’, or ‘POST_LIVE’. |
dimension |
Start |
Start |
The start date for the reporting period. |
dimension |
Start Month |
Start Month |
The starting month for an ad campaign or reporting period. |
dimension |
Start Year |
Start Year |
The starting year for an ad campaign or reporting period. |
metric |
Starting Month |
Starting Month |
The calendar month in which a campaign or reporting period begins. |
dimension |
Status |
Status |
The current operational state or approval status of an ad campaign, creative, or account within the LinkedIn Ads platform (e.g., Active, Paused, Archived). |
dimension |
TEXT_AD |
TEXT_AD |
A campaign type for text-based ads. |
dimension |
THRUPLAY |
THRUPLAY |
A video metric indicating plays that are completed or played for a significant duration (e.g., 15 seconds). |
dimension |
TOTAL_CONVERSIONS |
TOTAL_CONVERSIONS |
The aggregate count of all conversions recorded for a campaign or ad. |
dimension |
Targeting |
Targeting |
The audience targeting criteria applied to a campaign. |
dimension |
Targeting Type |
Targeting Type |
The type of targeting used for an ad campaign (e.g., audience, demographic). |
dimension |
Total Clicks |
Total Clicks |
The aggregate count of all clicks on the ad unit. |
metric |
URL_LINK |
URL_LINK |
The URL link associated with the ad or creative. |
dimension |
US |
US |
Indicates whether the ad performance data is specifically for users located in the United States, often used as a geographic breakdown for reporting. |
dimension |
USD |
USD |
Indicates that the cost or other financial metric is in United States Dollars. |
dimension |
UTM_ID |
UTM_ID |
The UTM tracking parameter for campaign identification. |
dimension |
VIDEO_PLAYS |
VIDEO_PLAYS |
The total number of times a video ad started playing. |
dimension |
VIDEO_VIEWS |
VIDEO_VIEWS |
The number of times a video ad has been played for at least 2 continuous seconds with 50% in-view, or when a call-to-action is clicked. |
metric |
VIDEO_VIEWS_100 |
VIDEO_VIEWS_100 |
The number of video views that reached 100% completion. |
metric |
VIDEO_VIEWS_25 |
VIDEO_VIEWS_25 |
The number of video views that reached 25% completion. |
metric |
VIDEO_VIEWS_3S |
VIDEO_VIEWS_3S |
The number of video views that lasted for at least 3 seconds. |
dimension |
VIDEO_VIEWS_50 |
VIDEO_VIEWS_50 |
The number of video views that reached 50% completion. |
metric |
VIDEO_VIEWS_75 |
VIDEO_VIEWS_75 |
The number of video views that reached 75% completion. |
metric |
Video View |
VIDEO_VIEW |
A campaign objective focused on optimizing for video views. |
dimension |
View_100 |
View_100 |
The count of times a video ad was viewed 97-100% of its duration. |
metric |
View_25 |
View_25 |
The count of times a video ad was viewed through the first quartile (25%) of its duration. |
metric |
View_50 |
View_50 |
The count of times a video ad was viewed through the midpoint (50%) of its duration. |
metric |
View_75 |
View_75 |
The count of times a video ad was viewed through the third quartile (75%) of its duration. |
metric |
ViewableImpressions |
ViewableImpressions |
The number of impressions that were deemed viewable according to industry standards, meaning a certain percentage of the ad was on screen for a minimum duration. |
metric |
Website Traffic |
WEBSITE_TRAFFIC |
A campaign objective focused on driving traffic to a website. |
dimension |
WeekAsDate |
WeekAsDate |
A date representing the start or end of a reporting week. |
dimension |
WeekNum |
WeekNum |
The week number within a year for reporting data. |
metric |
Year |
Year |
The year associated with the reported data, used for aggregating performance metrics on an annual basis. |
metric |
account.changeAuditStamps.created.actor |
account.changeAuditStamps.created.actor |
The actor (e.g., user URN) who created the ad account. |
dimension |
account.changeAuditStamps.created.time |
account.changeAuditStamps.created.time |
The timestamp when the ad account was created. |
metric |
account.changeAuditStamps.lastModified.actor |
account.changeAuditStamps.lastModified.actor |
The actor (e.g., user URN) who last modified the ad account. |
dimension |
account.changeAuditStamps.lastModified.time |
account.changeAuditStamps.lastModified.time |
The timestamp when the ad account was last modified. |
metric |
account.currency |
account.currency |
The default currency used for the ad account. |
dimension |
account.id |
account.id |
The unique identifier of the ad account. |
dimension |
account.name |
account.name |
The name of the ad account. |
dimension |
account.notifiedOnCampaignOptimization |
account.notifiedOnCampaignOptimization |
Indicates if the account contact receives notifications about campaign optimization opportunities. |
dimension |
account.notifiedOnCreativeApproval |
account.notifiedOnCreativeApproval |
Indicates if the account contact receives notifications when a creative has been reviewed and approved. |
dimension |
account.notifiedOnCreativeRejection |
account.notifiedOnCreativeRejection |
Indicates if the account contact receives notifications when a creative has been rejected. |
dimension |
account.notifiedOnEndOfCampaign |
account.notifiedOnEndOfCampaign |
Indicates if the account contact receives notifications when an associated campaign has ended. |
dimension |
account.reference |
account.reference |
A unique identifier or reference for the ad account. |
dimension |
account.reference.id |
account.reference.id |
The identifier for the referenced ad account. |
metric |
account.reference.name |
account.reference.name |
The name of the referenced ad account. |
dimension |
account.servingStatuses |
account.servingStatuses |
The current serving statuses for the ad account, indicating if it’s active, paused, or in review. |
dimension |
account.status |
account.status |
The overall status of the ad account, such as ‘ACTIVE’ or ‘CLOSED’. |
dimension |
account.totalBudget.amount |
account.totalBudget.amount |
The total budget amount set for the ad account. |
metric |
account.totalBudget.currencyCode |
account.totalBudget.currencyCode |
The currency code (e.g., USD, EUR) for the ad account’s total budget amount. |
dimension |
account.totalBudgetEndsAt |
account.totalBudgetEndsAt |
The date and time when the total budget allocated for the ad account is set to end. |
metric |
account.type |
account.type |
The type of the ad account, such as ‘BUSINESS’ or ‘PERSONAL’. |
dimension |
account.version.versionTag |
account.version.versionTag |
A unique identifier or tag representing the version of the ad account object within the API. |
metric |
accountName |
accountName |
The name of the advertising account. |
dimension |
account_id |
account_id |
The unique identifier for the advertising account. |
dimension |
account_name |
account_name |
The name of the ad account. |
dimension |
accountcurrency |
accountcurrency |
The currency in which the ad account operates. |
dimension |
accountid |
accountid |
The unique identifier for the advertising account. |
metric |
accountstatus |
accountstatus |
The current status of the ad account, such as ‘ACTIVE’ or ‘CLOSED’. |
dimension |
accounttype |
accounttype |
The type of the ad account, such as ‘BUSINESS’ or ‘PERSONAL’. |
dimension |
actionClicks |
actionClicks |
The number of clicks on the action button within a Sponsored Messaging ad. |
dimension |
adUnitClicks |
adUnitClicks |
The number of clicks recorded on an ad unit. |
metric |
ad_id_ad_format |
ad_id_ad_format |
The ad format type associated with the ad’s unique identifier. |
dimension |
ad_id_country |
ad_id_country |
The country associated with the ad’s unique identifier, often indicating targeting. |
dimension |
ad_id_cta |
ad_id_cta |
The Call-to-Action (CTA) label associated with the ad’s unique identifier. |
dimension |
ad_id_language |
ad_id_language |
The language associated with the ad’s unique identifier, often indicating targeting. |
dimension |
ad_id_targeting |
ad_id_targeting |
The targeting criteria associated with the ad’s unique identifier. |
dimension |
ad_serving_method |
ad_serving_method |
Specifies the method by which an ad is served or displayed to users, influencing ad delivery and visibility. |
dimension |
advertiser |
advertiser |
The unique identifier for the advertiser. |
dimension |
age |
age |
The age demographic of the target audience for the campaign. |
dimension |
approximateMemberReach |
approximateMemberReach |
The estimated number of unique LinkedIn members who saw an ad at least once. This metric is available for date ranges up to 92 days and is an updated version of approximateUniqueImpressions. |
metric |
approximateUniqueImpressions |
approximateUniqueImpressions |
A legacy metric representing the estimated number of unique users who saw an ad at least once. |
metric |
asset |
asset |
The unique identifier for an advertising asset, such as an image or video. |
dimension |
audienceExpansionEnabled |
audienceExpansionEnabled |
Indicates whether audience expansion is enabled for the campaign, allowing ads to reach a broader but similar audience beyond specified targeting. |
dimension |
audiencePenetration |
audiencePenetration |
The approximate number of unique members reached by the advertiser divided by the approximate total target audience size. This metric is available for date ranges of up to 92 days and supports account, campaign group, or campaign pivots. |
metric |
averageDwellTime |
averageDwellTime |
The average time, in seconds, that users spend viewing the ad when at least 50% of its pixels are present on the screen. |
metric |
buying_type |
buying_type |
The buying type of the campaign, such as auction or fixed price. |
dimension |
callToAction.labelType |
callToAction.labelType |
The type of label used for the call-to-action button on an ad, such as ‘Learn More’ or ‘Sign Up’. |
dimension |
callToAction.target |
callToAction.target |
The destination URL or action associated with the call-to-action button. |
dimension |
campaign.account |
campaign.account |
The unique identifier of the ad account to which the campaign belongs. |
dimension |
campaign.associatedEntity |
campaign.associatedEntity |
The entity, such as an organization or member, that the campaign is associated with. |
dimension |
campaign.audienceExpansionEnabled |
campaign.audienceExpansionEnabled |
Indicates whether audience expansion is enabled for the campaign, which broadens targeting criteria. |
dimension |
campaign.campaignGroup |
campaign.campaignGroup |
The campaign group to which a specific campaign belongs. This is a pivot for grouping ad analytics data. |
dimension |
campaign.changeAuditStamps.created.time |
campaign.changeAuditStamps.created.time |
The timestamp when the campaign was created. |
metric |
campaign.changeAuditStamps.lastModified.time |
campaign.changeAuditStamps.lastModified.time |
The timestamp when the campaign was last modified. |
metric |
campaign.costType |
campaign.costType |
The method by which the cost of a campaign is determined, such as CPC (Cost Per Click) or CPM (Cost Per Mille). |
dimension |
campaign.creativeSelection |
campaign.creativeSelection |
The method or strategy used to select and deliver creatives within a campaign. |
dimension |
campaign.dailyBudget.amount |
campaign.dailyBudget.amount |
The daily budget amount set for the campaign. |
metric |
campaign.dailyBudget.currencyCode |
campaign.dailyBudget.currencyCode |
The currency code (e.g., USD, EUR) used for the campaign’s daily budget. |
dimension |
campaign.id |
campaign.id |
The unique identifier of the campaign. |
dimension |
campaign.locale.country |
campaign.locale.country |
The country target associated with the campaign’s locale. |
dimension |
campaign.locale.language |
campaign.locale.language |
The language target associated with the campaign’s locale. |
dimension |
campaign.name |
campaign.name |
The name of the campaign. |
dimension |
campaign.objectiveType |
campaign.objectiveType |
The primary marketing objective of the campaign, such as Lead Generation, Website Traffic, or Brand Awareness. |
dimension |
campaign.offsiteDeliveryEnabled |
campaign.offsiteDeliveryEnabled |
Indicates if the campaign is enabled for delivery on the LinkedIn Audience Network (off-site placements). |
dimension |
campaign.offsitePreferences.iabCategories.exclude |
campaign.offsitePreferences.iabCategories.exclude |
A list of IAB (Interactive Advertising Bureau) categories to exclude for offsite ad placements, preventing ads from appearing on certain content types. |
dimension |
campaign.optimizationTargetType |
campaign.optimizationTargetType |
The primary goal or objective that the campaign is optimized for, such as lead generation or brand awareness. |
dimension |
campaign.runSchedule.end |
campaign.runSchedule.end |
The end date and time of the campaign’s run schedule. |
metric |
campaign.runSchedule.start |
campaign.runSchedule.start |
The start date and time of the campaign’s run schedule. |
metric |
campaign.servingStatuses |
campaign.servingStatuses |
The current serving statuses of the campaign, indicating if it’s active, paused, or pending. Can include multiple statuses. |
dimension |
campaign.status |
campaign.status |
The current status of the campaign, such as ‘ACTIVE’, ‘PAUSED’, ‘DRAFT’. |
dimension |
campaign.targeting.excludedTargetingFacets.audienceMatchingSegments |
campaign.targeting.excludedTargetingFacets.audienceMatchingSegments |
A list of audience matching segments that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.degrees |
campaign.targeting.excludedTargetingFacets.degrees |
Specific academic degrees excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.employers |
campaign.targeting.excludedTargetingFacets.employers |
A list of employer organizations that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.employersAll |
campaign.targeting.excludedTargetingFacets.employersAll |
All employers specifically excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.firstDegreeConnectionCompanies |
campaign.targeting.excludedTargetingFacets.firstDegreeConnectionCompanies |
Companies that are first-degree connections of the advertiser and are excluded from targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.followedCompanies |
campaign.targeting.excludedTargetingFacets.followedCompanies |
A list of companies that, if followed by a member, would exclude them from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.groups |
campaign.targeting.excludedTargetingFacets.groups |
LinkedIn groups whose members are excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.industries |
campaign.targeting.excludedTargetingFacets.industries |
A list of industries that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.jobFunctions |
campaign.targeting.excludedTargetingFacets.jobFunctions |
Specific job functions excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.locations |
campaign.targeting.excludedTargetingFacets.locations |
Geographic locations excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.profileLocations |
campaign.targeting.excludedTargetingFacets.profileLocations |
Profile-based locations explicitly excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.retargetingSegments |
campaign.targeting.excludedTargetingFacets.retargetingSegments |
A list of retargeting segments that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.schools |
campaign.targeting.excludedTargetingFacets.schools |
Educational institutions explicitly excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.segments |
campaign.targeting.excludedTargetingFacets.segments |
Audience segments explicitly excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.seniorities |
campaign.targeting.excludedTargetingFacets.seniorities |
A list of professional seniorities that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.skills |
campaign.targeting.excludedTargetingFacets.skills |
Specific skills explicitly excluded from the campaign’s target audience. |
dimension |
campaign.targeting.excludedTargetingFacets.staffCountRanges |
campaign.targeting.excludedTargetingFacets.staffCountRanges |
A list of staff count ranges (company sizes) that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.titles |
campaign.targeting.excludedTargetingFacets.titles |
A list of job titles that are explicitly excluded from the campaign’s targeting. |
dimension |
campaign.targeting.excludedTargetingFacets.titlesAll |
campaign.targeting.excludedTargetingFacets.titlesAll |
All job titles explicitly excluded from the campaign’s target audience. |
dimension |
campaign.targeting.includedTargetingFacets.ageRanges |
campaign.targeting.includedTargetingFacets.ageRanges |
A list of age ranges that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.audienceMatchingSegments |
campaign.targeting.includedTargetingFacets.audienceMatchingSegments |
A list of audience matching segments that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.contextualAdSizes |
campaign.targeting.includedTargetingFacets.contextualAdSizes |
The contextual ad sizes included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.degrees |
campaign.targeting.includedTargetingFacets.degrees |
Specific academic degrees included in the campaign’s target audience. |
dimension |
campaign.targeting.includedTargetingFacets.employers |
campaign.targeting.includedTargetingFacets.employers |
A list of employer organizations that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.employersAll |
campaign.targeting.includedTargetingFacets.employersAll |
All employers specifically included in the campaign’s target audience. |
dimension |
campaign.targeting.includedTargetingFacets.employersPast |
campaign.targeting.includedTargetingFacets.employersPast |
Past employers included in the campaign’s target audience. |
dimension |
campaign.targeting.includedTargetingFacets.fieldsOfStudy |
campaign.targeting.includedTargetingFacets.fieldsOfStudy |
Specific fields of study included in the campaign’s target audience. |
dimension |
campaign.targeting.includedTargetingFacets.firstDegreeConnectionCompanies |
campaign.targeting.includedTargetingFacets.firstDegreeConnectionCompanies |
Companies that are first-degree connections of the advertiser and are included in targeting. |
dimension |
campaign.targeting.includedTargetingFacets.followedCompanies |
campaign.targeting.includedTargetingFacets.followedCompanies |
A list of companies that, if followed by a member, would include them in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.genders |
campaign.targeting.includedTargetingFacets.genders |
A list of genders that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.groups |
campaign.targeting.includedTargetingFacets.groups |
A list of LinkedIn groups that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.industries |
campaign.targeting.includedTargetingFacets.industries |
A list of industries that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.interests |
campaign.targeting.includedTargetingFacets.interests |
User interests included in the campaign’s target audience. |
dimension |
campaign.targeting.includedTargetingFacets.interfaceLocales |
campaign.targeting.includedTargetingFacets.interfaceLocales |
A list of interface locales (language settings) that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.jobFunctions |
campaign.targeting.includedTargetingFacets.jobFunctions |
A list of job functions that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.locations |
campaign.targeting.includedTargetingFacets.locations |
A list of geographical locations that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.profileLocations |
campaign.targeting.includedTargetingFacets.profileLocations |
A list of profile-based geographical locations that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.retargetingSegments |
campaign.targeting.includedTargetingFacets.retargetingSegments |
A list of retargeting segments that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.schools |
campaign.targeting.includedTargetingFacets.schools |
Educational institutions included in the campaign’s target audience. |
dimension |
campaign.targeting.includedTargetingFacets.segments |
campaign.targeting.includedTargetingFacets.segments |
A list of audience segments that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.seniorities |
campaign.targeting.includedTargetingFacets.seniorities |
A list of professional seniorities that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.skills |
campaign.targeting.includedTargetingFacets.skills |
A list of professional skills that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.staffCountRanges |
campaign.targeting.includedTargetingFacets.staffCountRanges |
A list of staff count ranges (company sizes) that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.titles |
campaign.targeting.includedTargetingFacets.titles |
A list of job titles that are explicitly included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.titlesAll |
campaign.targeting.includedTargetingFacets.titlesAll |
All job titles specifically included in the campaign’s target audience. |
dimension |
campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.end |
campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.end |
The end value for the range of years of professional experience included in the campaign’s targeting. |
dimension |
campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.start |
campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.start |
The start value for the range of years of professional experience included in the campaign’s targeting. |
metric |
campaign.targetingCriteria.exclude |
campaign.targetingCriteria.exclude |
Specifies the criteria used to exclude certain audiences from a campaign’s targeting. |
dimension |
campaign.targetingCriteria.include |
campaign.targetingCriteria.include |
The criteria used to include specific demographics or attributes for campaign targeting. |
dimension |
campaign.totalBudget.amount |
campaign.totalBudget.amount |
The total budget amount set for the campaign. |
metric |
campaign.totalBudget.currencyCode |
campaign.totalBudget.currencyCode |
The currency code for the total budget amount of the campaign. |
dimension |
campaign.type |
campaign.type |
The type of ad campaign, such as Text Ad, Sponsored Updates, Sponsored InMails, or Dynamic Ads. |
dimension |
campaign.unitCost.amount |
campaign.unitCost.amount |
The unit cost amount, such as cost per click or cost per impression, for the campaign. |
metric |
campaign.unitCost.currencyCode |
campaign.unitCost.currencyCode |
The currency code for the campaign’s unit cost. |
dimension |
campaign.urn |
campaign.urn |
The Uniform Resource Name (URN) that uniquely identifies the campaign. |
dimension |
campaign.version.versionTag |
campaign.version.versionTag |
A unique identifier or tag representing the version of the campaign object within the API. |
metric |
campaignGroup |
campaignGroup |
The unique identifier (URN) of the campaign group to which a campaign belongs. |
dimension |
campaignID |
campaignID |
The unique identifier for the advertising campaign. |
metric |
campaignName |
campaignName |
The human-readable name of the advertising campaign. |
dimension |
campaignStatus |
campaignStatus |
The current operational status of the campaign (e.g., active, paused, completed). |
dimension |
campaign_account |
campaign_account |
The unique identifier for the ad account associated with the campaign. |
dimension |
campaign_associatedEntity |
campaign_associatedEntity |
The entity (e.g., a LinkedIn Page or organization) associated with and sponsoring the ad campaign. |
dimension |
campaign_audienceExpansionEnabled |
campaign_audienceExpansionEnabled |
Indicates whether audience expansion is enabled for the campaign, allowing LinkedIn to automatically reach additional relevant audiences beyond the initial targeting. |
dimension |
campaign_changeAuditStamps_created_time |
campaign_changeAuditStamps_created_time |
The timestamp indicating when the campaign was originally created. |
metric |
campaign_changeAuditStamps_lastModified_time |
campaign_changeAuditStamps_lastModified_time |
The timestamp indicating the last time the campaign was modified. |
metric |
campaign_costType |
campaign_costType |
The cost type of the campaign, such as impressions (CPM) or clicks (CPC). |
dimension |
campaign_creativeSelection |
campaign_creativeSelection |
The method used to select and deliver creatives within a campaign, often involving optimization or sequential rotation. |
dimension |
campaign_dailyBudget_amount |
campaign_dailyBudget_amount |
The daily budget amount allocated for the campaign. |
dimension |
campaign_dailyBudget_currencyCode |
campaign_dailyBudget_currencyCode |
The currency code for the daily budget amount (e.g., USD, EUR). |
dimension |
campaign_end_date |
campaign_end_date |
The date on which the advertising campaign is scheduled to end. |
dimension |
campaign_group |
campaign_group |
An organizational unit used to group related campaigns, often representing a larger advertising initiative. |
dimension |
campaign_group.backfilled |
campaign_group.backfilled |
A system-set flag indicating if the campaign group was created organically or to backfill existing campaigns. |
dimension |
campaign_group.changeAuditStamps.created.time |
campaign_group.changeAuditStamps.created.time |
The timestamp indicating when the campaign group was created. |
metric |
campaign_group.changeAuditStamps.lastModified.time |
campaign_group.changeAuditStamps.lastModified.time |
The timestamp indicating when the campaign group was last modified. |
metric |
campaign_group.id |
campaign_group.id |
The unique identifier of the campaign group. |
metric |
campaign_group.name |
campaign_group.name |
The name of the campaign group. |
dimension |
campaign_group.runSchedule.end |
campaign_group.runSchedule.end |
The exclusive end date and time for when a campaign group and its associated campaigns are scheduled to stop running. |
dimension |
campaign_group.runSchedule.start |
campaign_group.runSchedule.start |
The inclusive start date and time for when a campaign group and its associated campaigns are scheduled to begin running. |
dimension |
campaign_group.servingStatuses |
campaign_group.servingStatuses |
The serving statuses of the campaign group. |
dimension |
campaign_group.status |
campaign_group.status |
The current operational status of the campaign group. |
dimension |
campaign_group.totalBudget.amount |
campaign_group.totalBudget.amount |
The maximum amount to spend across all associated campaigns and creatives for the duration of the campaign group. |
metric |
campaign_group.totalBudget.currencyCode |
campaign_group.totalBudget.currencyCode |
The currency code (e.g., USD, EUR) for the campaign group’s total budget amount. |
dimension |
campaign_group_name |
campaign_group_name |
The name of the campaign group to which this campaign belongs. |
dimension |
campaign_grouping |
campaign_grouping |
A grouping or categorization applied to campaigns for reporting. |
dimension |
campaign_id |
campaign_id |
The unique identifier for the advertising campaign. |
dimension |
campaign_locale_country |
campaign_locale_country |
The country target associated with the campaign’s locale. |
dimension |
campaign_locale_language |
campaign_locale_language |
The language target associated with the campaign’s locale. |
dimension |
campaign_name |
campaign_name |
The name of the advertising campaign. |
dimension |
campaign_objective |
campaign_objective |
The primary goal or objective set for the advertising campaign. |
dimension |
campaign_objectiveType |
campaign_objectiveType |
The primary objective of the campaign, such as ‘Brand Awareness’, ‘Website Visits’, ‘Lead Generation’, or ‘Conversions’. |
dimension |
campaign_offsiteDeliveryEnabled |
campaign_offsiteDeliveryEnabled |
Indicates if the campaign is enabled for delivery on the LinkedIn Audience Network (off-site placements). |
dimension |
campaign_offsitePreferences_iabCategories_exclude |
campaign_offsitePreferences_iabCategories_exclude |
List of IAB content categories excluded for off-site placements within the LinkedIn Audience Network. |
dimension |
campaign_runSchedule_end |
campaign_runSchedule_end |
The end date and time of the campaign’s run schedule. |
metric |
campaign_runSchedule_start |
campaign_runSchedule_start |
The start date and time of the campaign’s run schedule. |
metric |
campaign_servingStatuses |
campaign_servingStatuses |
The current serving statuses of the campaign, indicating if it’s active, paused, or pending. Can include multiple statuses. |
dimension |
campaign_start_date |
campaign_start_date |
The date on which the advertising campaign is scheduled to begin. |
dimension |
campaign_status |
campaign_status |
The overall status of the campaign, such as ACTIVE, PAUSED, DRAFT, ARCHIVED. |
dimension |
campaign_totalBudget_amount |
campaign_totalBudget_amount |
The total budget amount allocated for the entire duration of the campaign. |
metric |
campaign_totalBudget_currencyCode |
campaign_totalBudget_currencyCode |
The currency code for the total budget amount (e.g., USD, EUR). |
dimension |
campaign_type |
campaign_type |
The type of the campaign, defining its structure and available features. |
dimension |
campaign_unitCost_amount |
campaign_unitCost_amount |
The unit cost amount, such as cost per click or cost per impression, for the campaign. |
metric |
campaign_unitCost_currencyCode |
campaign_unitCost_currencyCode |
The currency code for the campaign’s unit cost. |
dimension |
campaign_urn |
campaign_urn |
The Uniform Resource Name (URN) that uniquely identifies the campaign. |
dimension |
campaign_version_versionTag |
campaign_version_versionTag |
A unique identifier or tag representing the version of the campaign object within the API. |
metric |
campaigncostType |
campaigncostType |
The cost type of the campaign, such as impressions (CPM) or clicks (CPC). |
dimension |
campaigncreativeSelection |
campaigncreativeSelection |
The method used to select and deliver creatives within a campaign, often involving optimization or sequential rotation. |
dimension |
campaigntype |
campaigntype |
The type or format of the advertising campaign (e.g., Sponsored Updates, Text Ad). |
dimension |
campaignunitCost.amount |
campaignunitCost.amount |
The unit cost amount for the campaign. |
metric |
campaignunitCost.currencyCode |
campaignunitCost.currencyCode |
The currency code for the campaign’s unit cost. |
dimension |
cardClicks |
cardClicks |
The number of clicks on individual cards within a carousel ad creative, applicable for non-demographic pivots. |
metric |
cardImpressions |
cardImpressions |
The number of impressions recorded for each individual card within a carousel ad, applicable for non-demographic pivots. |
metric |
changeAuditStamps.created.actor |
changeAuditStamps.created.actor |
The URN of the actor who created the entity, as recorded in audit logs. |
dimension |
changeAuditStamps.created.time |
changeAuditStamps.created.time |
The timestamp indicating when an entity (e.g., ad, campaign, creative) was originally created. |
metric |
changeAuditStamps.created.time.date |
changeAuditStamps.created.time.date |
The date when the entity was created, as part of its change audit stamps. |
dimension |
changeAuditStamps.lastModified.actor |
changeAuditStamps.lastModified.actor |
The URN of the actor who last modified the entity, as recorded in audit logs. |
dimension |
changeAuditStamps.lastModified.time |
changeAuditStamps.lastModified.time |
The timestamp indicating when the entity was last modified. |
metric |
changeAuditStamps.lastModified.time.date |
changeAuditStamps.lastModified.time.date |
The date of the last modification recorded in the change audit trail for an entity. |
dimension |
chargeableClicks |
chargeableClicks |
The count of clicks for which the advertiser is charged. |
metric |
click_through_conversions |
click_through_conversions |
The number of conversions that occurred after a user clicked on an ad. |
metric |
click_through_purchases |
click_through_purchases |
The number of purchases that occurred after a user clicked on an ad. |
metric |
clicks |
clicks |
The total number of chargeable clicks on an ad, representing interactions like landing page views or company page visits. |
dimension |
commentLikes |
commentLikes |
The number of likes received on comments made on Sponsored Content. |
metric |
comments |
comments |
The number of comments received on Sponsored Content. |
dimension |
comments_social_engagments |
comments_social_engagments |
The number of comments received on a social post or ad. |
metric |
company |
company |
Information about the company associated with the ad or its target audience. |
dimension |
company.id |
company.id |
The unique identifier for the company. |
metric |
company.name |
company.name |
The name of the company. |
dimension |
companyPageClicks |
companyPageClicks |
The number of clicks that directed users to the company page associated with the ad. |
metric |
companySize |
companySize |
The size of the company targeted by the ad, or associated with the member. This can be used as a pivot for demographic reporting. |
dimension |
companySize.name |
companySize.name |
The name of the company size category. |
dimension |
company_size |
company_size |
The size category of the company, used for demographic reporting or targeting. |
dimension |
content.reference |
content.reference |
A URN (Uniform Resource Name) referring to the content of an ad creative or shared post. |
dimension |
conversion.account |
conversion.account |
The ad account to which the conversion event is attributed. |
dimension |
conversion.attributionType |
conversion.attributionType |
The method or model used to assign credit for a conversion to various touchpoints in the customer journey. |
dimension |
conversion.enabled |
conversion.enabled |
Indicates whether the conversion tracking or specific conversion rule is active. |
dimension |
conversion.id |
conversion.id |
A unique identifier for the conversion event or conversion rule. |
metric |
conversion.imagePixelTag |
conversion.imagePixelTag |
The identifier or configuration of the image pixel tag used to track specific conversion events on an advertiser’s website. |
dimension |
conversion.lastCallbackAt |
conversion.lastCallbackAt |
The timestamp of the last time a conversion tracking event was reported back to the server. |
dimension |
conversion.lastModified |
conversion.lastModified |
The timestamp indicating when the conversion entity was last modified. |
metric |
conversion.name |
conversion.name |
The name given to the conversion event or conversion rule for identification. |
dimension |
conversion.postClickAttributionWindowSize |
conversion.postClickAttributionWindowSize |
The duration, in days, after a click during which a conversion can be attributed to that click. |
metric |
conversion.type |
conversion.type |
The category or classification of the conversion event (e.g., Lead, Purchase). |
dimension |
conversion.urlRules |
conversion.urlRules |
The rules based on URLs that define when a conversion event should be triggered. |
dimension |
conversion.value.amount |
conversion.value.amount |
The monetary value associated with a conversion event. |
dimension |
conversion.value.currencyCode |
conversion.value.currencyCode |
The currency code (e.g., USD, EUR) for the monetary value of a conversion event. |
dimension |
conversion.viewThroughAttributionWindowSize |
conversion.viewThroughAttributionWindowSize |
The duration, in days, after an impression (view) during which a conversion can be attributed to that impression. |
metric |
conversionCost.amount |
conversionCost.amount |
The monetary amount representing the cost per conversion. |
metric |
conversionCost.currencyCode |
conversionCost.currencyCode |
The currency code for the cost per conversion. |
dimension |
conversionCount |
conversionCount |
The total number of conversions recorded for the ad campaign. |
metric |
conversionRates.adSpendPerConversion.amount |
conversionRates.adSpendPerConversion.amount |
The amount of ad spend per conversion. |
metric |
conversionRates.adSpendPerConversion.currencyCode |
conversionRates.adSpendPerConversion.currencyCode |
The currency code for the ad spend per conversion amount. |
dimension |
conversionRates.advertiserROAS |
conversionRates.advertiserROAS |
The Return on Ad Spend (ROAS) for the advertiser, indicating the revenue generated per unit of ad spend. |
metric |
conversionRates.postClickConversionRate |
conversionRates.postClickConversionRate |
The rate of conversions that occurred after a user clicked on an ad. |
metric |
conversionRates.viewThroughConversionRate |
conversionRates.viewThroughConversionRate |
The rate of conversions that occurred after a user viewed an ad but did not click on it. |
metric |
conversionStatistics.postClickConversions |
conversionStatistics.postClickConversions |
Statistical count of conversions attributed to users who clicked on an ad. |
metric |
conversionStatistics.viewThroughConversions |
conversionStatistics.viewThroughConversions |
Statistical count of conversions attributed to users who viewed an ad but did not click on it. |
metric |
conversionValue.amount |
conversionValue.amount |
The monetary value generated by conversions. |
metric |
conversionValue.currencyCode |
conversionValue.currencyCode |
The currency code for the conversion value. |
dimension |
conversionValueInLocalCurrency |
conversionValueInLocalCurrency |
The monetary value of conversions recorded in the ad account’s local currency, based on advertiser-defined rules, applicable for non-demographic pivots. |
metric |
costInLocalCurrency |
costInLocalCurrency |
The total cost of the ad campaign in the account’s local currency, broken down by selected pivots and time granularity. |
dimension |
costInUsd |
costInUsd |
The total cost of the ad campaign in USD, broken down by selected pivots and time granularity. |
metric |
costType |
costType |
The method by which the cost is calculated for an ad or campaign. |
dimension |
cost_USD |
cost_USD |
The cost in United States Dollars (USD) based on the pivot and time granularity. |
metric |
country.name |
country.name |
The name of the country. This can be used as a pivot for demographic reporting. |
dimension |
country_name |
country_name |
The name of the country associated with reporting data or targeting. |
dimension |
createdAt |
createdAt |
The timestamp when an entity, such as an ad or campaign, was created. |
dimension |
createdAt.date |
createdAt.date |
The date when an entity, such as an ad or campaign, was created. |
dimension |
createdBy |
createdBy |
The identifier of the user who created the entity. |
dimension |
creative.activity |
creative.activity |
The activity associated with the creative, often referring to a sponsored update or social share. |
dimension |
creative.callToAction.labelType |
creative.callToAction.labelType |
The type of label used for the call-to-action button within an ad creative. |
dimension |
creative.callToAction.target |
creative.callToAction.target |
The destination URL or action associated with the call-to-action button within an ad creative. |
dimension |
creative.call_to_action |
creative.call_to_action |
The call-to-action (CTA) text displayed on the creative (e.g., ‘Learn More’, ‘Apply Now’). |
dimension |
creative.call_to_action_target |
creative.call_to_action_target |
The target URL or destination for the creative’s call-to-action. |
dimension |
creative.campaign |
creative.campaign |
The unique identifier of the campaign to which this creative belongs. |
dimension |
creative.changeAuditStamps.created.time |
creative.changeAuditStamps.created.time |
The timestamp indicating when the ad creative was originally created. |
metric |
creative.changeAuditStamps.lastModified.time |
creative.changeAuditStamps.lastModified.time |
The timestamp indicating the last time the creative was modified. |
metric |
creative.company_name |
creative.company_name |
The name of the company associated with the creative. |
dimension |
creative.contentLandingPageUri |
creative.contentLandingPageUri |
The URI of the landing page for the content associated with the creative. |
dimension |
creative.created_timestamp |
creative.created_timestamp |
The timestamp when the creative was created. |
metric |
creative.description |
creative.description |
The descriptive text for the creative, providing details about the ad. |
dimension |
creative.headline |
creative.headline |
The headline text for the creative. |
dimension |
creative.id |
creative.id |
The unique identifier of the ad creative. |
metric |
creative.inmail_account |
creative.inmail_account |
The InMail account associated with an InMail creative. |
dimension |
creative.inmail_html_body |
creative.inmail_html_body |
The HTML body content of a Sponsored InMail creative. |
dimension |
creative.inmail_legal_text |
creative.inmail_legal_text |
The legal text or disclaimer included in a Sponsored InMail creative. |
dimension |
creative.inmail_sender |
creative.inmail_sender |
The sender’s profile associated with a Sponsored InMail creative. |
dimension |
creative.is_direct_sponsored_content |
creative.is_direct_sponsored_content |
Indicates if the creative is a direct sponsored content, meaning it’s only shown as an ad and not as an organic post on a company page. |
dimension |
creative.job_ad_button_label |
creative.job_ad_button_label |
The text label displayed on the call-to-action button for a job ad creative. |
dimension |
creative.name |
creative.name |
The name of the creative. |
dimension |
creative.owner |
creative.owner |
The URN of the entity (e.g., organization or ad account) that owns or is associated with the ad creative. |
dimension |
creative.reference |
creative.reference |
A reference to the underlying asset or post that the creative is built upon, identified by a URN. |
dimension |
creative.resolved_url |
creative.resolved_url |
The final, resolved landing page URL for the ad creative after all redirects. |
dimension |
creative.review.reviewStatus |
creative.review.reviewStatus |
The editorial review status of the creative (e.g., approved, rejected, pending). |
dimension |
creative.servingStatuses |
creative.servingStatuses |
The current serving statuses of the creative, indicating if it’s active, paused, or pending. Can include multiple statuses. |
dimension |
creative.share |
creative.share |
The unique identifier (URN) of the LinkedIn share (post) that the ad creative is promoting. |
dimension |
creative.share_media_category |
creative.share_media_category |
The category of media being shared by the creative, such as IMAGE or VIDEO. |
dimension |
creative.sponsor_company |
creative.sponsor_company |
The company sponsoring the creative. |
dimension |
creative.sponsor_logo |
creative.sponsor_logo |
The URL of the sponsor company’s logo. |
dimension |
creative.spotlight_custom_background |
creative.spotlight_custom_background |
The custom background image used for a Dynamic Spotlight ad. |
dimension |
creative.spotlight_forum_name |
creative.spotlight_forum_name |
The forum name displayed in a Spotlight ad creative. |
dimension |
creative.spotlight_logo |
creative.spotlight_logo |
The logo used for a Spotlight ad creative. |
dimension |
creative.status |
creative.status |
The current status of the creative, such as ‘ACTIVE’, ‘PAUSED’, ‘DRAFT’. |
dimension |
creative.subject |
creative.subject |
The subject line of the creative, often used for InMail ads. |
dimension |
creative.text |
creative.text |
The main body text content of the creative. |
dimension |
creative.text_click_uri |
creative.text_click_uri |
The URI associated with a click on the text component of the creative. |
dimension |
creative.text_vector_image |
creative.text_vector_image |
The vector image used for a text ad creative. |
dimension |
creative.title |
creative.title |
The title of the creative. |
dimension |
creative.type |
creative.type |
The type of the creative, such as ‘SponsoredUpdateCreative’, ‘TextAdCreative’, ‘VideoAdCreative’. |
dimension |
creative.variables.clickUri |
creative.variables.clickUri |
The click-through URI defined within the creative’s variables. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredInMailCreativeVariables.content |
creative.variables.data.com.linkedin.ads.SponsoredInMailCreativeVariables.content |
The content body of a Sponsored InMail creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.activity |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.activity |
The activity URN for a sponsored update carousel creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.directSponsoredContent |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.directSponsoredContent |
The direct sponsored content associated with a Sponsored Update Carousel creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.share |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.share |
Information related to the organic or sponsored share that forms the basis of the Sponsored Update Carousel creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.activity |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.activity |
The activity URN for a sponsored update creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent |
The direct sponsored content associated with a Sponsored Update creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share |
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share |
Information related to the organic or sponsored share that forms the basis of the Sponsored Update creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.directSponsoredContent |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.directSponsoredContent |
The direct sponsored content associated with a Sponsored Video creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.durationMicro |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.durationMicro |
The duration of the video creative in microseconds. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.mediaAsset |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.mediaAsset |
The URN of the media asset (video file) used in the Sponsored Video creative. |
dimension |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.userGeneratedContentPost |
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.userGeneratedContentPost |
The URN of the user-generated content post associated with a sponsored video creative. |
dimension |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.callToAction |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.callToAction |
The call-to-action text for a Spotlight Creative V2. |
dimension |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.customBackground |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.customBackground |
The custom background image or color used for a Spotlight ad creative. |
dimension |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.description |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.description |
The description for a Spotlight Creative V2. |
dimension |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.forumName |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.forumName |
The forum name specified within the variables of a Spotlight ad creative. |
dimension |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.headline |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.headline |
The headline for a Spotlight Creative V2. |
dimension |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.logo |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.logo |
The logo URN for a Spotlight Creative V2. |
dimension |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.showMemberProfilePhoto |
creative.variables.data.com.linkedin.ads.SpotlightCreativeVariablesV2.showMemberProfilePhoto |
Indicates whether the member’s profile photo is shown in a Spotlight ad creative. |
dimension |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId |
The identifier of the image used in a Text Ad creative. |
dimension |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.text |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.text |
The text content for a Text Ad Creative. |
dimension |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.title |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.title |
The title for a Text Ad Creative. |
dimension |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.vectorImage |
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.vectorImage |
The vector image URN for a Text Ad Creative. |
dimension |
creative.version.versionTag |
creative.version.versionTag |
A unique identifier or tag representing the version of the creative object within the API. |
metric |
creative.video_external_distribution_channel_type |
creative.video_external_distribution_channel_type |
The type of external distribution channel used for the video creative. |
dimension |
creative.video_lifecycle_state |
creative.video_lifecycle_state |
The lifecycle state of a video creative, indicating its processing or availability status. |
dimension |
creative.video_primary_landing_page_url |
creative.video_primary_landing_page_url |
The primary landing page URL for a video creative. |
dimension |
creative.video_share_commentary |
creative.video_share_commentary |
The commentary text accompanying a video share creative. |
dimension |
creative.video_share_media |
creative.video_share_media |
The media URN for the video being shared by the creative. |
dimension |
creative.video_share_media_category |
creative.video_share_media_category |
The category of the video media being shared by the creative. |
dimension |
creative.video_share_media_description |
creative.video_share_media_description |
The description for the video media being shared by the creative. |
dimension |
creative.video_share_media_landing_page |
creative.video_share_media_landing_page |
The landing page URL for the video media being shared by the creative. |
dimension |
creative.video_share_media_text |
creative.video_share_media_text |
The text content associated with the video media being shared by the creative. |
dimension |
creative.video_share_media_title |
creative.video_share_media_title |
The title for the video media being shared by the creative. |
dimension |
creative.video_target_audience |
creative.video_target_audience |
The intended target audience for the video creative. |
dimension |
creative.video_ugc_origin |
creative.video_ugc_origin |
The origin of the user-generated content (UGC) video. |
dimension |
creative.video_visibility |
creative.video_visibility |
The visibility setting of a video ad creative, determining who can view it (e.g., public, unlisted). |
dimension |
creative_grouping |
creative_grouping |
The method or category used to organize and group different ad creatives for reporting and analysis. |
dimension |
creative_id |
creative_id |
The unique identifier for an ad creative. |
dimension |
creative_name |
creative_name |
The name assigned to an ad creative. |
dimension |
creative_title |
creative_title |
The title displayed as part of the ad creative. |
dimension |
ctr_calculated |
ctr_calculated |
The calculated click-through rate (CTR) for the ad. |
metric |
dailyBudget.amount |
dailyBudget.amount |
The monetary amount set as the daily budget for a campaign. |
metric |
dailyBudget.currencyCode |
dailyBudget.currencyCode |
The currency code for the daily campaign budget. |
dimension |
data_currency |
data_currency |
The currency in which monetary data is reported. |
dimension |
date |
date |
The specific date for which the ad performance data is reported. Data can be grouped by day. |
dimension |
dateRange |
dateRange |
The inclusive date range for which the report data is requested or provided, specified in UTC. |
dimension |
day_of_the_year |
day_of_the_year |
A dimension representing the day of the year for reporting purposes. |
metric |
device |
device |
The specific device used to view an ad. |
dimension |
device_type |
device_type |
The general type of device used to view an ad (e.g., mobile, desktop). |
dimension |
documentCompletions |
documentCompletions |
The number of times a document ad was fully completed/read. |
metric |
documentFirstQuartileCompletions |
documentFirstQuartileCompletions |
The number of times a document ad was read through its first quartile (25%). |
metric |
documentMidpointCompletions |
documentMidpointCompletions |
The number of times a document ad was read through its midpoint (50%). |
metric |
documentThirdQuartileCompletions |
documentThirdQuartileCompletions |
The number of times a document ad was read through its third quartile (75%). |
metric |
downloadClicks |
downloadClicks |
The number of times users clicked to indicate an intent to download media from an ad, available for ad formats supporting media downloads. |
metric |
endDate |
endDate |
The end date of the reporting period or campaign. |
dimension |
engagement |
engagement |
A general measure of user interaction with the ad. |
metric |
entity_id |
entity_id |
The unique identifier for an entity, often part of a Uniform Resource Name (URN). |
dimension |
entity_type |
entity_type |
The type of the entity, such as an ad account, campaign, or creative. |
dimension |
externalWebsiteConversions |
externalWebsiteConversions |
The total number of desired actions taken by users on an external website after interacting with or viewing an ad. |
metric |
externalWebsitePostClickConversions |
externalWebsitePostClickConversions |
The total number of desired actions taken by users on an external website specifically after clicking on an ad. |
dimension |
externalWebsitePostViewConversions |
externalWebsitePostViewConversions |
The total number of desired actions taken by users on an external website specifically after viewing an ad. |
dimension |
final_target_url |
final_target_url |
The final URL where users are directed after clicking on an ad, after all redirects. |
dimension |
follows |
follows |
The number of new followers gained, applicable to Sponsored Content and Follower ads. |
metric |
format |
format |
The ad format used for the creative or campaign, such as Text Ad, Sponsored Content, or Video Ad. |
dimension |
format_size |
format_size |
The size or format specifications of the creative, such as image dimensions. |
dimension |
format_type |
format_type |
The category or type of ad creative format, such as video, image, or text. |
dimension |
fullScreenPlays |
fullScreenPlays |
The number of times members engaged with a video ad by entering full screen mode. |
metric |
function |
function |
The professional function or department of a LinkedIn member, used for audience targeting or demographic reporting. |
metric |
function.name |
function.name |
The name of a job function. |
dimension |
fy |
fy |
The fiscal year associated with the reporting period for ad performance data. |
dimension |
headlineClicks |
headlineClicks |
The number of clicks on the headline of conversation ads. |
metric |
headlineImpressions |
headlineImpressions |
The number of impressions recorded for an ad’s headline. |
metric |
id |
id |
A unique identifier for the entity, such as an ad account, campaign, or creative. |
dimension |
impressionCount |
impressionCount |
The total number of times an ad was displayed. |
metric |
impression_device_type.value |
impression_device_type.value |
The type of device on which an ad impression occurred, such as desktop or mobile. This is a pivot for grouping ad analytics data. |
dimension |
impressions |
impressions |
The number of times an ad, particularly Sponsored Content, was displayed to users, or the number of sends for Sponsored Messaging. |
dimension |
industry |
industry |
The industry associated with a member or company. |
metric |
industry.name |
industry.name |
The name of the industry. |
dimension |
intendedStatus |
intendedStatus |
The desired or planned status for an ad or campaign (e.g., ACTIVE, PAUSED). |
dimension |
inventory_type |
inventory_type |
The type of inventory where ads are shown, such as LinkedIn Feed, Audience Network, etc. |
dimension |
isServing |
isServing |
A boolean indicating whether the ad or campaign is currently serving impressions. |
dimension |
isTest |
isTest |
A boolean indicating whether the ad account or campaign is a test entity, not served to real users. |
dimension |
jobApplications |
jobApplications |
The number of times users applied for a job advertised through a LinkedIn Ads campaign. |
metric |
jobApplyClicks |
jobApplyClicks |
The number of times a member clicked the ‘apply’ button on a LinkedIn jobs page after engaging with an ad that leads to a LinkedIn job landing page. |
metric |
landingPageClicks |
landingPageClicks |
The number of clicks that directed users to the ad creative’s designated landing page. |
metric |
lastModifiedAt |
lastModifiedAt |
The timestamp when the entity was last modified. |
dimension |
lastModifiedAt.date |
lastModifiedAt.date |
The date when the entity was last modified. |
dimension |
lastModifiedBy |
lastModifiedBy |
The identifier of the user who last modified the entity. |
dimension |
last_refresh_date |
last_refresh_date |
dimension |
|
leadGenerationMailContactInfoShares |
leadGenerationMailContactInfoShares |
The number of times contact information was shared via Lead Gen Forms in Sponsored Messaging campaigns. |
metric |
leadGenerationMailInterestedClicks |
leadGenerationMailInterestedClicks |
The number of clicks by recipients of Sponsored Messaging ads indicating interest in a lead generation offer. |
metric |
li_clicks |
li_clicks |
The number of clicks on LinkedIn ads. |
metric |
li_impressions |
li_impressions |
The number of impressions served for LinkedIn ads. |
metric |
likes |
likes |
The number of ‘likes’ received on Sponsored Content. |
dimension |
likes_social_engagments |
likes_social_engagments |
The number of likes received on a social post or ad. |
metric |
linkedin_clicks |
linkedin_clicks |
The number of clicks on LinkedIn-specific elements of an ad. |
metric |
linkedin_costs |
linkedin_costs |
The costs incurred for advertising on the LinkedIn platform. |
metric |
linkedin_creative_id |
linkedin_creative_id |
The unique identifier for an ad creative on LinkedIn. |
dimension |
linkedin_form_leads |
linkedin_form_leads |
The number of leads generated through LinkedIn Lead Gen Forms. |
metric |
linkedin_impressions |
linkedin_impressions |
The number of impressions served specifically on the LinkedIn platform. |
metric |
linkedin_leads |
linkedin_leads |
The number of leads generated directly through LinkedIn. |
metric |
linkedin_platform_campaign |
linkedin_platform_campaign |
The campaign identifier specific to the LinkedIn advertising platform. |
dimension |
linkedin_video_100 |
linkedin_video_100 |
The number of LinkedIn video plays that reached 100% completion. |
metric |
linkedin_video_25 |
linkedin_video_25 |
The number of LinkedIn video plays that reached 25% completion. |
metric |
linkedin_video_50 |
linkedin_video_50 |
The number of LinkedIn video plays that reached 50% completion. |
metric |
linkedin_video_75 |
linkedin_video_75 |
The number of LinkedIn video plays that reached 75% completion. |
metric |
linkedin_video_starts |
linkedin_video_starts |
The number of times a LinkedIn video ad started playing. |
metric |
locale.country |
locale.country |
The country code associated with the locale of the ad or targeted audience. |
dimension |
locale.language |
locale.language |
The language code associated with the locale of the ad or targeted audience. |
dimension |
market |
market |
The geographical market targeted by the ad campaign, typically represented by country or region. |
dimension |
maxage |
maxage |
The maximum age limit set for the target audience of the campaign. |
metric |
media_cost |
media_cost |
The cost associated with media placements for an ad campaign. |
metric |
media_platform_id |
media_platform_id |
An identifier for the media platform on which the ad was served. For LinkedIn Ads, this typically refers to LinkedIn itself. |
dimension |
medium |
medium |
The marketing channel or medium through which the ad is delivered. |
dimension |
member_company.localizedName |
member_company.localizedName |
The localized name of the company a member is associated with, used for demographic reporting. |
dimension |
member_company_size.value |
member_company_size.value |
The size category of the company a member works for, used for demographic reporting. This is a pivot for grouping ad analytics data. |
dimension |
member_country.$URN |
member_country.$URN |
The Uniform Resource Name (URN) for a member’s country, used for demographic reporting. This is a pivot for grouping ad analytics data. |
dimension |
member_country.countryCode |
member_country.countryCode |
The two-letter country code for a member’s country. |
dimension |
member_country.countryGroup |
member_country.countryGroup |
The geographical grouping of the member’s country. |
dimension |
member_country.name |
member_country.name |
The name of the country associated with the LinkedIn member who engaged with the ad. |
dimension |
member_country.name.locale.country |
member_country.name.locale.country |
The country component of the locale used to localize the member’s country name. |
dimension |
member_country.name.locale.language |
member_country.name.locale.language |
The language component of the locale used to localize the member’s country name. |
dimension |
member_country.name.value |
member_country.name.value |
The localized name of the member’s country. |
dimension |
member_county.name |
member_county.name |
The name of the county associated with the member’s location, used for demographic reporting. |
dimension |
member_industry.$URN |
member_industry.$URN |
The Uniform Resource Name (URN) for a member’s industry, used to uniquely identify the industry for demographic reporting. This is a pivot for grouping ad analytics data. |
dimension |
member_industry.id |
member_industry.id |
The unique identifier for a member’s industry. |
metric |
member_industry.name.localized.en_US |
member_industry.name.localized.en_US |
The English (US) localized name of the member’s industry. |
dimension |
member_job_function.$URN |
member_job_function.$URN |
The Uniform Resource Name (URN) for a member’s job function, used to uniquely identify the job function for demographic reporting. This is a pivot for grouping ad analytics data. |
dimension |
member_job_function.id |
member_job_function.id |
The unique identifier for a member’s job function, used for demographic reporting. |
metric |
member_job_function.name.localized.en_US |
member_job_function.name.localized.en_US |
The English (US) localized name of the member’s job function. |
dimension |
member_job_title.$URN |
member_job_title.$URN |
The Uniform Resource Name (URN) for a member’s job title, used to uniquely identify the job title for demographic reporting. This is a pivot for grouping ad analytics data. |
dimension |
member_job_title.function |
member_job_title.function |
The job function associated with a member’s job title, used for demographic reporting. |
dimension |
member_job_title.id |
member_job_title.id |
The unique identifier for a member’s job title, used for demographic reporting. |
metric |
member_job_title.name.localized.en_US |
member_job_title.name.localized.en_US |
The English (US) localized name of the member’s job title. |
dimension |
member_job_title.superTitle |
member_job_title.superTitle |
A broader classification or ‘super title’ associated with a member’s specific job title, used for demographic reporting. |
dimension |
member_region.name |
member_region.name |
The name of the region associated with the LinkedIn member who engaged with the ad. |
dimension |
member_seniority.id |
member_seniority.id |
The unique identifier for a member’s seniority level, used for demographic reporting. This is a pivot for grouping ad analytics data. |
metric |
member_seniority.name.localized.en_US |
member_seniority.name.localized.en_US |
The English (US) localized name of the member’s seniority level. |
dimension |
minage |
minage |
The minimum age limit set for the target audience of the campaign. |
metric |
name |
name |
The name or label of the entity, such as an ad account, campaign, or conversion. |
dimension |
nonchargeableClicks |
nonchargeableClicks |
The number of clicks on an ad that were deemed non-billable or invalid by the advertising platform. |
metric |
objective |
objective |
The marketing objective set for the ad campaign, such as lead generation, brand awareness, or website traffic. |
dimension |
objectiveType |
objectiveType |
The primary goal or objective of the advertising campaign, such as awareness, consideration, or conversion. |
dimension |
offsiteDeliveryEnabled |
offsiteDeliveryEnabled |
Indicates if the ad creative is enabled for delivery outside of the LinkedIn platform, on partnered websites or apps. |
dimension |
oneClickLeadFormOpens |
oneClickLeadFormOpens |
The number of times users opened a lead form for a One Click Lead Gen campaign. |
metric |
oneClickLeads |
oneClickLeads |
The number of leads generated through One Click Lead Gen campaigns. |
metric |
one_click_lead_form_open |
one_click_lead_form_open |
The number of times a one-click lead form was opened. |
metric |
opens |
opens |
The number of times Sponsored Messaging ads were opened by recipients. |
metric |
optimizationTargetType |
optimizationTargetType |
The specific metric or action that the campaign is optimized to achieve. |
dimension |
organicFollowerCount |
organicFollowerCount |
The number of organic followers gained through the ad activity. |
metric |
otherEngagements |
otherEngagements |
The count of user interactions with an ad unit that do not fall into other specific engagement categories. |
metric |
paidFollowerCount |
paidFollowerCount |
The number of followers gained through paid advertising campaigns. |
metric |
pivot |
pivot |
A dimension used to group and break down performance metrics in ad analytics reports, such as ACCOUNT, CAMPAIGN, or CREATIVE. |
dimension |
pivotValue |
pivotValue |
A specific value for a selected pivot in an analytics report. |
dimension |
pivotValues |
pivotValues |
A collection of specific values for the selected pivot(s) in an analytics report. |
dimension |
pivotValues.{NUM} |
pivotValues.{NUM} |
The specific values for the chosen pivot(s) in an analytics report. |
dimension |
placement |
placement |
A specific placement where the ad was shown within the LinkedIn platform. |
dimension |
placement_id |
placement_id |
The identifier for the ad placement, indicating where the ad was displayed on the LinkedIn platform or audience network. This can be used as a pivot for grouping ad analytics data. |
dimension |
placement_name.value |
placement_name.value |
The name of the placement where the ad is displayed (e.g., LinkedIn Feed, Audience Network). |
dimension |
placement_type |
placement_type |
The category or type of ad placement. |
dimension |
platform_clicks |
platform_clicks |
The number of clicks recorded on the advertising platform. |
metric |
platform_impressions |
platform_impressions |
The number of impressions recorded on the advertising platform. |
metric |
postClickJobApplications |
postClickJobApplications |
The number of times a member completed a job application after clicking on an ad. |
metric |
postClickJobApplyClicks |
postClickJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after clicking an ad with a LinkedIn job landing page. |
metric |
postClickRegistrations |
postClickRegistrations |
The number of times a member registered for an event or seminar after clicking on an ad leading to a LinkedIn landing page. |
metric |
postViewJobApplications |
postViewJobApplications |
The number of job applications submitted after viewing an ad, without clicking. |
metric |
postViewJobApplyClicks |
postViewJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after viewing an ad with a LinkedIn job landing page. |
metric |
postViewRegistrations |
postViewRegistrations |
The number of registrations completed after viewing an ad, without clicking. |
metric |
post_id |
post_id |
The unique identifier of the organic post that is being promoted by a sponsored content creative. |
dimension |
post_publish_date |
post_publish_date |
The date when the organic post was published. |
dimension |
post_text |
post_text |
The textual content of the organic post. |
dimension |
post_type |
post_type |
The type of the organic post (e.g., text, image, video). |
dimension |
post_url |
post_url |
The URL of the organic post. |
dimension |
post_url_path |
post_url_path |
The specific path component of the destination URL for an ad creative, directing users to a particular page or section. |
dimension |
post_url_transfer_protocol |
post_url_transfer_protocol |
The transfer protocol (e.g., HTTP, HTTPS) used for the destination URL of an ad creative. |
dimension |
post_url_without_path |
post_url_without_path |
The base domain and subdomains of the destination URL for an ad creative, excluding any specific path. |
dimension |
product_brand |
product_brand |
The brand of the product being advertised. |
dimension |
product_theme |
product_theme |
The thematic category of the product being advertised. |
dimension |
q |
q |
A query parameter used to designate the specific finder method (e.g., analytics, statistics, attributedRevenueMetrics) for the ad analytics endpoint. |
dimension |
quarters |
quarters |
The fiscal quarter(s) within a reporting period for ad performance data. |
dimension |
reactions |
reactions |
The number of positive reactions (e.g., like, insightful, curious) on Sponsored Content. |
metric |
reactions_social_engagments |
reactions_social_engagments |
The number of reactions (e.g., likes, loves, insights) received on a social post or ad. |
metric |
reference |
reference |
A URN (Uniform Resource Name) referring to an associated entity, such as the organization or person advertising, or the content of a creative. |
dimension |
region |
region |
The geographical region associated with an ad campaign or target audience. |
dimension |
registrations |
registrations |
The number of times users completed a registration action after engaging with an ad. |
metric |
resolved_url |
resolved_url |
The final, resolved URL after any redirects or tracking parameters have been processed. |
dimension |
review.reviewStatus |
review.reviewStatus |
The status of an ad or creative review process. |
dimension |
review.status |
review.status |
The overall status of an ad or creative review, indicating approval or rejection. |
dimension |
runSchedule.end |
runSchedule.end |
The exclusive end date and time for when a campaign or campaign group is scheduled to stop running. |
metric |
runSchedule.end.date |
runSchedule.end.date |
The specific date portion of when a campaign or campaign group is scheduled to stop running. |
dimension |
runSchedule.start |
runSchedule.start |
The inclusive start date and time for when a campaign or campaign group is scheduled to begin running. |
metric |
runSchedule.start.date |
runSchedule.start.date |
The specific date portion of when a campaign or campaign group is scheduled to begin running. |
dimension |
sends |
sends |
The number of times Sponsored Messaging ads were sent to recipients. |
metric |
seniority |
seniority |
The professional seniority level of a targeted audience member. |
metric |
seniority.name |
seniority.name |
The name of the professional seniority level for a targeted audience member. |
dimension |
servingStatuses |
servingStatuses |
The current serving statuses of an entity. |
dimension |
servingStatuses.{NUM} |
servingStatuses.{NUM} |
The serving statuses of the entity, indicating its current state in the advertising system. |
dimension |
shares |
shares |
The number of times Sponsored Content was shared by users. |
dimension |
shares_social_engagments |
shares_social_engagments |
The number of shares received on a social post or ad. |
metric |
social_ad_unit |
social_ad_unit |
The specific social media advertisement unit, such as a Sponsored Content post, Sponsored Messaging ad, or dynamic ad format. |
dimension |
social_comments |
social_comments |
The number of comments received on a social post or ad. |
metric |
social_costs |
social_costs |
The total cost associated with social interactions or ads. |
metric |
social_engagements |
social_engagements |
The total number of engagements (likes, comments, shares, clicks) on a social post or ad. |
metric |
social_follows |
social_follows |
The number of new followers gained as a result of a social post or ad. |
metric |
social_impressions |
social_impressions |
The total number of times a social post or ad was displayed to users. |
metric |
social_likes |
social_likes |
The number of ‘likes’ or ‘reactions’ received on a social post or ad. |
dimension |
social_other_clicks |
social_other_clicks |
Clicks on elements of the ad other than the primary call-to-action or URL. |
metric |
social_platform |
social_platform |
The social media platform used for advertising. |
dimension |
social_reactions |
social_reactions |
The number of reactions (like, celebrate, love, insightful, curious) received on a social post or ad. |
metric |
social_shares |
social_shares |
The number of times a social post or ad was shared by users. |
metric |
social_unit_size |
social_unit_size |
The size or format of the social ad unit. |
dimension |
social_url_clicks |
social_url_clicks |
The number of clicks on the URL within a social post or ad. |
metric |
social_video_starts |
social_video_starts |
The number of times a video ad started playing. |
metric |
social_video_views |
social_video_views |
The total number of views for a video ad. |
metric |
social_video_views_100 |
social_video_views_100 |
The number of times a video ad was viewed to 100% completion. |
metric |
social_video_views_25 |
social_video_views_25 |
The number of times a video ad was viewed to at least 25% completion. |
metric |
social_video_views_50 |
social_video_views_50 |
The number of times a video ad was viewed to at least 50% completion. |
metric |
social_video_views_75 |
social_video_views_75 |
The number of times a video ad was viewed to at least 75% completion. |
metric |
specific_product |
specific_product |
A detailed identification of the product featured in the advertisement. |
dimension |
spend.amount |
spend.amount |
The monetary amount spent on an ad campaign or creative. |
metric |
spend.currencyCode |
spend.currencyCode |
The currency code for the amount spent on an ad campaign. |
dimension |
spend_in_account_currency |
spend_in_account_currency |
The total amount spent, expressed in the currency of the advertising account. |
dimension |
startDate |
startDate |
The start date of the reporting period or campaign. |
dimension |
startViews |
startViews |
The number of times a video ad began playing. |
metric |
start_month |
start_month |
The month in which an activity or campaign started. |
dimension |
start_year |
start_year |
The year in which an activity or campaign started. |
metric |
storyDeliveryEnabled |
storyDeliveryEnabled |
Indicates if the ad creative is enabled for delivery as a LinkedIn Story ad format. |
dimension |
subscriptionClicks |
subscriptionClicks |
The number of clicks on a subscription-related call to action in an ad. |
metric |
talentLeads |
talentLeads |
The number of leads generated specifically for talent-related objectives. |
metric |
target_url |
target_url |
The primary URL to which the ad creative directs users upon clicking. |
dimension |
targeting.includedTargetingFacets.ageRanges.{NUM} |
targeting.includedTargetingFacets.ageRanges.{NUM} |
A specific age range included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.employers.{NUM} |
targeting.includedTargetingFacets.employers.{NUM} |
A specific employer included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.fieldsOfStudy.{NUM} |
targeting.includedTargetingFacets.fieldsOfStudy.{NUM} |
A specific field of study included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.industries.{NUM} |
targeting.includedTargetingFacets.industries.{NUM} |
A specific industry included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.interfaceLocales.{NUM}.country |
targeting.includedTargetingFacets.interfaceLocales.{NUM}.country |
The country of a specific interface locale included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.interfaceLocales.{NUM}.language |
targeting.includedTargetingFacets.interfaceLocales.{NUM}.language |
The language of a specific interface locale included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.jobFunctions.{NUM} |
targeting.includedTargetingFacets.jobFunctions.{NUM} |
A specific job function included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.locations.{NUM} |
targeting.includedTargetingFacets.locations.{NUM} |
A specific geographical location included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.schools.{NUM} |
targeting.includedTargetingFacets.schools.{NUM} |
A specific school included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.seniorities.{NUM} |
targeting.includedTargetingFacets.seniorities.{NUM} |
A specific seniority level included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.staffCountRanges.{NUM} |
targeting.includedTargetingFacets.staffCountRanges.{NUM} |
A specific staff count range (company size) included in the targeting criteria for an ad campaign. |
dimension |
targeting.includedTargetingFacets.titles.{NUM} |
targeting.includedTargetingFacets.titles.{NUM} |
A specific job title included in the targeting criteria for an ad campaign. |
dimension |
targetingCriteria |
targetingCriteria |
The criteria used to define the audience that an ad campaign will target. |
dimension |
targeting_type |
targeting_type |
The method or category of audience targeting applied. |
dimension |
textUrlClicks |
textUrlClicks |
The number of clicks on text-based URLs or links embedded within the body of a Sponsored Messaging ad. |
metric |
thumbnail_url |
thumbnail_url |
The URL of the thumbnail image associated with the creative or post. |
dimension |
totalBudget.amount |
totalBudget.amount |
The total monetary budget allocated for an ad campaign. |
metric |
totalBudget.currencyCode |
totalBudget.currencyCode |
The currency code for the total budget of an ad campaign. |
dimension |
totalBudgetEndsAt |
totalBudgetEndsAt |
The timestamp when the total budget for an ad campaign is set to end. |
metric |
totalEngagements |
totalEngagements |
The total number of all user interactions with the ad unit, combining various engagement types. |
metric |
totalFollowerCount |
totalFollowerCount |
The total number of followers for a LinkedIn page or entity. |
metric |
total_conversion_value |
total_conversion_value |
The total monetary value generated from all conversions. |
dimension |
type |
type |
The classification or category of an entity, such as an ad account type, campaign type, or creative type. |
dimension |
unitCost.amount |
unitCost.amount |
The monetary amount of the unit cost for an ad impression or click. |
metric |
unitCost.currencyCode |
unitCost.currencyCode |
The currency code for the unit cost of an ad impression or click. |
dimension |
url |
url |
The URL associated with an ad creative or landing page, used for tracking where users are directed. |
dimension |
urn |
urn |
The Uniform Resource Name (URN) that uniquely identifies an entity (e.g., account, campaign, creative). |
dimension |
|
|
A Uniform Resource Name (URN) that uniquely identifies a specific activity on the LinkedIn platform. |
dimension |
|
|
A Uniform Resource Name (URN) identifying the content of a Sponsored InMail ad. |
dimension |
|
|
A Uniform Resource Name (URN) that uniquely identifies a digital media asset, such as an image or video. |
dimension |
|
|
A Uniform Resource Name (URN) identifying an organization or company associated with the ad account, campaign, or member. |
dimension |
|
|
A Uniform Resource Name (URN) identifying a specific shared post or content item on LinkedIn that is being promoted as sponsored content. |
dimension |
|
|
A Uniform Resource Name (URN) identifying a sponsored ad account in LinkedIn Campaign Manager. |
dimension |
|
|
A Uniform Resource Name (URN) identifying a specific sponsored campaign within an ad account. |
dimension |
|
|
A Uniform Resource Name (URN) identifying a specific ad creative, which is the actual ad content displayed to users. |
dimension |
|
|
A Uniform Resource Name (URN) that identifies an entity of an unknown or unspecified type. |
dimension |
utm_a/b_test |
utm_a/b_test |
The UTM tracking parameter for A/B testing variations. |
dimension |
utm_ad_type |
utm_ad_type |
The UTM tracking parameter for the type of ad. |
dimension |
utm_campaign |
utm_campaign |
The UTM tracking parameter for campaign name, used to identify a specific campaign. |
dimension |
utm_campaign_name |
utm_campaign_name |
The UTM parameter for the name of the campaign that generated the traffic. |
dimension |
utm_content |
utm_content |
The UTM tracking parameter for content, used to differentiate between specific ad contents or links. |
dimension |
utm_country |
utm_country |
The UTM tracking parameter for the country associated with the ad. |
dimension |
utm_format |
utm_format |
The UTM tracking parameter for the format of the ad. |
dimension |
utm_goal |
utm_goal |
The UTM tracking parameter for the goal or objective of the ad. |
dimension |
utm_language |
utm_language |
The UTM tracking parameter for the language of the ad or target audience. |
dimension |
utm_market |
utm_market |
The UTM tracking parameter for the market targeted by the ad. |
dimension |
utm_medium |
utm_medium |
The UTM tracking parameter for medium, indicating the advertising or marketing medium (e.g., cpc, banner, email). |
dimension |
utm_product |
utm_product |
The UTM tracking parameter for the product promoted in the ad. |
dimension |
utm_source |
utm_source |
The UTM tracking parameter for source, identifying the source of traffic (e.g., LinkedIn, Google). |
dimension |
utm_term |
utm_term |
The UTM tracking parameter for keywords or specific terms related to the ad. |
dimension |
validWorkEmailLeads |
validWorkEmailLeads |
The number of leads generated that include a valid work email address, often tracked via Lead Gen Forms or conversion tracking. |
metric |
value |
value |
The monetary value associated with a conversion or action. This can represent conversion value in local currency. |
metric |
variables.clickUri |
variables.clickUri |
The URL where users are directed when they click on the ad creative. |
dimension |
variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.activity |
variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.activity |
The activity associated with a Sponsored Update creative, often a URN referring to the original post. |
dimension |
variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent |
variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent |
Variables related to direct sponsored content within a Sponsored Update creative. |
dimension |
variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share |
variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share |
Variables related to the shared content within a Sponsored Update creative. |
dimension |
variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId |
variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId |
The identifier for the image used in a Text Ad creative. |
dimension |
variables.data.com.linkedin.ads.TextAdCreativeVariables.text |
variables.data.com.linkedin.ads.TextAdCreativeVariables.text |
The body text content of a Text Ad creative. |
dimension |
variables.data.com.linkedin.ads.TextAdCreativeVariables.title |
variables.data.com.linkedin.ads.TextAdCreativeVariables.title |
The title of a Text Ad creative. |
dimension |
version.versionTag |
version.versionTag |
A tag or identifier indicating the specific version of an ad creative or ad form. |
metric |
videoCompletions |
videoCompletions |
The number of times a video ad was played 97-100% of its duration, including watches that skipped to this point. |
metric |
videoFirstQuartileCompletions |
videoFirstQuartileCompletions |
The number of times a video ad was played through the first quartile (25%) of its duration, including watches that skipped to this point. |
metric |
videoMidpointCompletions |
videoMidpointCompletions |
The number of times a video ad was played through its midpoint (50%) duration, including watches that skipped to this point. |
metric |
videoStarts |
videoStarts |
The number of times a video ad began playing by users. |
metric |
videoThirdQuartileCompletions |
videoThirdQuartileCompletions |
The number of times a video ad was played through the third quartile (75%) of its duration, including watches that skipped to this point. |
metric |
videoViews |
videoViews |
A video ad playing for at least 2 continuous seconds with 50% in-view, or a click on the Call To Action, whichever comes first. |
dimension |
video_completion_25 |
video_completion_25 |
The number of video plays that reached 25% completion. |
metric |
video_completion_50 |
video_completion_50 |
The number of video plays that reached 50% completion. |
metric |
video_completion_75 |
video_completion_75 |
The number of video plays that reached 75% completion. |
metric |
video_completions |
video_completions |
The total number of times a video was played to 100% completion. |
metric |
video_starts |
video_starts |
The number of times a video ad started playing. |
metric |
view_through_conversions |
view_through_conversions |
The number of conversions that occurred after a user viewed an ad but did not click on it. |
metric |
view_through_purchases |
view_through_purchases |
The number of purchases that occurred after a user viewed an ad but did not click on it. |
metric |
viralCardClicks |
viralCardClicks |
The number of clicks on individual cards within a carousel ad that resulted from viral impressions, applicable for non-demographic pivots. |
metric |
viralCardImpressions |
viralCardImpressions |
The number of organic impressions for each card within a carousel ad. |
metric |
viralClicks |
viralClicks |
The number of clicks that originated from viral impressions on Sponsored Content. |
metric |
viralCommentLikes |
viralCommentLikes |
The count of likes on comments that originated from viral impressions of a Sponsored Content ad. |
metric |
viralComments |
viralComments |
The number of organic comments received on an ad or sponsored content. |
metric |
viralCompanyPageClicks |
viralCompanyPageClicks |
The number of clicks to view the company page resulting from viral impressions on Sponsored Content. |
metric |
viralDocumentCompletions |
viralDocumentCompletions |
The number of times users completed viewing an entire document ad, indicating full engagement with the content. |
metric |
viralDocumentFirstQuartileCompletions |
viralDocumentFirstQuartileCompletions |
The number of times users completed viewing the first 25% of a document ad. |
metric |
viralDocumentMidpointCompletions |
viralDocumentMidpointCompletions |
The number of times users completed viewing 50% (midpoint) of a document ad. |
metric |
viralDocumentThirdQuartileCompletions |
viralDocumentThirdQuartileCompletions |
The number of times users completed viewing 75% (third quartile) of a document ad. |
metric |
viralDownloadClicks |
viralDownloadClicks |
The number of times users clicked to download media from a viral ad, available for ads supporting media downloads. |
metric |
viralExternalWebsiteConversions |
viralExternalWebsiteConversions |
The number of organic conversions that occurred on an external website after users engaged with an ad. |
dimension |
viralExternalWebsitePostClickConversions |
viralExternalWebsitePostClickConversions |
The number of post-click conversions on an external website attributed to viral clicks on an ad. |
dimension |
viralExternalWebsitePostViewConversions |
viralExternalWebsitePostViewConversions |
The number of organic conversions on an external website attributed to a view of an ad, rather than a direct click. |
dimension |
viralFollows |
viralFollows |
The number of organic follows gained as a result of ad engagement. |
metric |
viralFullScreenPlays |
viralFullScreenPlays |
The number of times a video ad creative was played in full-screen mode by users, indicating engagement beyond initial view. |
metric |
viralImpressions |
viralImpressions |
The number of organic (non-paid) impressions an ad or sponsored content has received. |
metric |
viralJobApplications |
viralJobApplications |
The number of job applications driven by viral or organic reach attributed to an ad campaign. |
metric |
viralJobApplyClicks |
viralJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after viewing or clicking on a viral ad leading to a LinkedIn job landing page. |
metric |
viralLandingPageClicks |
viralLandingPageClicks |
The number of clicks on viral impressions that directed users to the ad creative’s landing page on Sponsored Content. |
metric |
viralLikes |
viralLikes |
The number of organic likes received on an ad or sponsored content. |
metric |
viralOneClickLeadFormOpens |
viralOneClickLeadFormOpens |
The number of times users opened a lead form for a Lead Gen campaign originating from viral impressions. |
metric |
viralOneClickLeads |
viralOneClickLeads |
The number of leads generated through One Click Lead Gen campaigns from viral impressions. |
metric |
viralOtherEngagements |
viralOtherEngagements |
The number of other organic engagement actions (not clicks, likes, shares, or comments) on an ad. |
metric |
viralPostClickJobApplications |
viralPostClickJobApplications |
The number of times a member completed a job application after clicking on a viral ad. |
metric |
viralPostClickJobApplyClicks |
viralPostClickJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after clicking on a viral ad that had a LinkedIn job landing page. |
metric |
viralPostClickRegistrations |
viralPostClickRegistrations |
The number of times a member registered for an event or seminar after clicking on a viral ad that led to a LinkedIn landing page. |
metric |
viralPostViewJobApplications |
viralPostViewJobApplications |
The number of job applications resulting from users who viewed an ad post and subsequently applied for a job, including viral reach. |
metric |
viralPostViewJobApplyClicks |
viralPostViewJobApplyClicks |
The number of times a member clicked the job’s apply button on a LinkedIn jobs page after viewing a viral ad that had a LinkedIn job landing page. |
metric |
viralPostViewRegistrations |
viralPostViewRegistrations |
The number of registrations resulting from users who viewed an ad post and subsequently registered, including viral reach. |
metric |
viralReactions |
viralReactions |
The total number of organic reactions (likes, comments, shares, etc.) on an ad or sponsored content. |
metric |
viralRegistrations |
viralRegistrations |
The number of registrations driven by viral or organic reach attributed to an ad campaign. |
metric |
viralShares |
viralShares |
The number of organic shares of an ad or sponsored content. |
metric |
viralSubscriptionClicks |
viralSubscriptionClicks |
The number of clicks on ads that led to a subscription (e.g., newsletter, premium content), including viral reach. |
metric |
viralTotalEngagements |
viralTotalEngagements |
The total number of organic engagement actions (likes, comments, shares, etc.) on an ad. |
metric |
viralVideoCompletions |
viralVideoCompletions |
The number of organic video ads that played to 97-100% completion. |
metric |
viralVideoFirstQuartileCompletions |
viralVideoFirstQuartileCompletions |
The number of organic video ads that played through the first 25% duration. |
metric |
viralVideoMidpointCompletions |
viralVideoMidpointCompletions |
The number of organic video ads that played through the 50% duration (midpoint). |
metric |
viralVideoStarts |
viralVideoStarts |
The number of organic video ad plays that were initiated. |
metric |
viralVideoThirdQuartileCompletions |
viralVideoThirdQuartileCompletions |
The number of organic video ads that played through the 75% duration. |
metric |
viralVideoViews |
viralVideoViews |
The number of organic (non-paid) views a video ad has received. |
metric |