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.
account.changeAuditStamps.created.actor Dimension
The actor (e.g., user URN) who created the ad account.
account.changeAuditStamps.created.time Metric
The timestamp when the ad account was created.
account.changeAuditStamps.lastModified.actor Dimension
The actor (e.g., user URN) who last modified the ad account.
account.changeAuditStamps.lastModified.time Metric
The timestamp when the ad account was last modified.
account.currency Dimension
The default currency used for the ad account.
account.id Dimension
The unique identifier of the ad account.
account.name Dimension
The name of the ad account.
account.notifiedOnCampaignOptimization Dimension
Indicates if the account contact receives notifications about campaign optimization opportunities.
account.notifiedOnCreativeApproval Dimension
Indicates if the account contact receives notifications when a creative has been reviewed and approved.
account.notifiedOnCreativeRejection Dimension
Indicates if the account contact receives notifications when a creative has been rejected.
account.notifiedOnEndOfCampaign Dimension
Indicates if the account contact receives notifications when an associated campaign has ended.
account.reference Dimension
A unique identifier or reference for the ad account.
account.servingStatuses Dimension
The current serving statuses for the ad account, indicating if it's active, paused, or in review.
account.status Dimension
The overall status of the ad account, such as 'ACTIVE' or 'CLOSED'.
account.type Dimension
The type of the ad account, such as 'BUSINESS' or 'PERSONAL'.
account.version.versionTag Metric
A unique identifier or tag representing the version of the ad account object within the API.
actionClicks Metric
The number of clicks on the action button within a Sponsored Messaging ad.
adUnitClicks Metric
The number of clicks recorded on an ad unit.
approximateMemberReach Metric
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.
associatedEntity Dimension
The unique identifier (URN) of the LinkedIn entity associated with the record, such as an ad account, campaign, or creative.
audienceExpansionEnabled Dimension
Indicates whether audience expansion is enabled for a campaign, which can broaden the reach beyond explicitly targeted companies.
audiencePenetration Metric
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.
averageDwellTime Metric
Average user dwell time (in seconds). It measures the duration for which more than 50% of the ad's pixels remain visible in the viewport. This metric is only supported from API version 202411 onwards.
campaign Dimension
The name of the campaign.
campaign.account Dimension
The unique identifier of the ad account to which the campaign belongs.
campaign.associatedEntity Dimension
The entity, such as an organization or member, that the campaign is associated with.
campaign.audienceExpansionEnabled Dimension
Indicates whether audience expansion is enabled for the campaign, which broadens targeting criteria.
campaign.changeAuditStamps.created.time Dimension
The timestamp when the campaign was created.
campaign.changeAuditStamps.lastModified.time Dimension
The timestamp when the campaign was last modified.
campaign.costType Dimension
The method by which the cost of a campaign is determined, such as CPC (Cost Per Click) or CPM (Cost Per Mille).
campaign.creativeSelection Dimension
The method or strategy used to select and deliver creatives within a campaign.
campaign.dailyBudget.amount Metric
The daily budget amount set for the campaign.
campaign.dailyBudget.currencyCode Dimension
The currency code (e.g., USD, EUR) used for the campaign's daily budget.
campaign.id Dimension
The unique identifier of the campaign.
campaign.locale.country Dimension
The country target associated with the campaign's locale.
campaign.locale.language Dimension
The language target associated with the campaign's locale.
campaign.name Dimension
The name of the campaign as defined by the LinkedIn API. LinkedIn's hierarchy is offset by one level from most platforms, so this returns the name of what LinkedIn Campaign Manager displays as an Ad Set. For the name shown as Campaign in Campaign Manager, use campaign_group.name.
campaign.objectiveType Dimension
The primary marketing objective of the campaign, such as Lead Generation, Website Traffic, or Brand Awareness.
campaign.offsiteDeliveryEnabled Dimension
Indicates if the campaign is enabled for delivery on the LinkedIn Audience Network (off-site placements).
campaign.offsitePreferences.iabCategories.exclude Dimension
A list of IAB (Interactive Advertising Bureau) categories to exclude for offsite ad placements, preventing ads from appearing on certain content types.
campaign.runSchedule.end Dimension
The end date and time of the campaign's run schedule.
campaign.runSchedule.start Dimension
The start date and time of the campaign's run schedule.
campaign.servingStatuses Dimension
The current serving statuses of the campaign, indicating if it's active, paused, or pending. Can include multiple statuses.
campaign.status Dimension
The current status of the campaign, such as 'ACTIVE', 'PAUSED', 'DRAFT'.
campaign.targeting.excludedTargetingFacets.audienceMatchingSegments Dimension
Segments of members who will be excluded from the advertising campaign's targeting based on audience matching segments.
campaign.targeting.excludedTargetingFacets.employers Dimension
A list of employer organizations that are explicitly excluded from the campaign's targeting.
campaign.targeting.excludedTargetingFacets.followedCompanies Dimension
A list of companies that, if followed by a member, would exclude them from the campaign's targeting.
campaign.targeting.excludedTargetingFacets.industries Dimension
A list of industries that are explicitly excluded from the campaign's targeting.
campaign.targeting.excludedTargetingFacets.retargetingSegments Dimension
Segments of members who will be excluded from the advertising campaign's targeting based on retargeting segments.
campaign.targeting.excludedTargetingFacets.seniorities Dimension
A list of professional seniorities that are explicitly excluded from the campaign's targeting.
campaign.targeting.excludedTargetingFacets.staffCountRanges Dimension
Ranges of staff counts (company sizes) that will be excluded from the advertising campaign's targeting.
campaign.targeting.excludedTargetingFacets.titles Dimension
Specific job titles that will be excluded from the advertising campaign's targeting.
campaign.targeting.includedTargetingFacets.audienceMatchingSegments Dimension
Segments of members who will be included in the advertising campaign's targeting based on audience matching segments.
campaign.targeting.includedTargetingFacets.employers Dimension
A list of employer organizations that are explicitly included in the campaign's targeting.
campaign.targeting.includedTargetingFacets.followedCompanies Dimension
A list of companies that, if followed by a member, would include them in the campaign's targeting.
campaign.targeting.includedTargetingFacets.groups Dimension
Groups of members who will be included in the advertising campaign's targeting.
campaign.targeting.includedTargetingFacets.industries Dimension
A list of industries that are explicitly included in the campaign's targeting.
campaign.targeting.includedTargetingFacets.interfaceLocales Dimension
Interface locales that will be included in the advertising campaign's targeting.
campaign.targeting.includedTargetingFacets.jobFunctions Dimension
Standardized job functions of members who will be included in the advertising campaign's targeting.
campaign.targeting.includedTargetingFacets.locations Dimension
Geographic locations that will be included in the advertising campaign's targeting.
campaign.targeting.includedTargetingFacets.profileLocations Dimension
Profile locations of members who will be included in the advertising campaign's targeting.
campaign.targeting.includedTargetingFacets.retargetingSegments Dimension
Segments of members who will be included in the advertising campaign's targeting based on retargeting segments.
campaign.targeting.includedTargetingFacets.seniorities Dimension
A list of professional seniorities that are explicitly included in the campaign's targeting.
campaign.targeting.includedTargetingFacets.skills Dimension
Specific skills of members who will be included in the advertising campaign's targeting.
campaign.targeting.includedTargetingFacets.staffCountRanges Dimension
Ranges of staff counts (company sizes) that will be included in the advertising campaign's targeting.
campaign.targeting.includedTargetingFacets.titles Dimension
Specific job titles that will be included in the advertising campaign's targeting.
campaign.targetingCriteria.exclude Dimension
Specifies the criteria used to exclude certain audiences from a campaign's targeting.
campaign.targetingCriteria.include Dimension
The criteria used to include specific demographics or attributes for campaign targeting.
campaign.totalBudget.amount Metric
The total budget amount set for the campaign.
campaign.totalBudget.currencyCode Dimension
The currency code for the total budget amount of the campaign.
campaign.type Dimension
The type of ad campaign, such as Text Ad, Sponsored Updates, Sponsored InMails, or Dynamic Ads.
campaign.unitCost.amount Metric
The unit cost amount, such as cost per click or cost per impression, for the campaign.
campaign.unitCost.currencyCode Dimension
The currency code for the campaign's unit cost.
campaign.urn Dimension
The Uniform Resource Name (URN) that uniquely identifies the campaign.
campaign.version.versionTag Dimension
A unique identifier or tag representing the version of the campaign object within the API.
campaignGroup Dimension
A grouping of multiple related campaigns, used for organizational and reporting purposes.
campaign_group.id Dimension
The unique identifier of the campaign group.
campaign_group.name Dimension
The name of the campaign group, which is what LinkedIn Campaign Manager displays as a Campaign. Only available when the pivot is CAMPAIGN or CAMPAIGN_GROUP.
campaign_group.runSchedule.end Dimension
The exclusive end date and time for when a campaign group and its associated campaigns are scheduled to stop running.
campaign_group.runSchedule.start Dimension
The inclusive start date and time for when a campaign group and its associated campaigns are scheduled to begin running.
campaign_group.servingStatuses Dimension
The serving statuses of the campaign group.
campaign_group.status Dimension
The current operational status of the campaign group.
campaign_group.totalBudget.amount Metric
The maximum amount to spend across all associated campaigns and creatives for the duration of the campaign group.
campaign_group.totalBudget.currencyCode Dimension
The currency code (e.g., USD, EUR) for the campaign group's total budget amount.
cardClicks Metric
The number of clicks on individual cards within a carousel ad creative, applicable for non-demographic pivots.
cardImpressions Metric
The number of impressions recorded for each individual card within a carousel ad, applicable for non-demographic pivots.
changeAuditStamps.created.actor Dimension
The actor (e.g., user URN) who created the ad account.
changeAuditStamps.created.time Dimension
The timestamp indicating when an entity (e.g., ad, campaign, creative) was originally created.
changeAuditStamps.created.time.date Dimension
The date when the entity was created, as part of its change audit stamps.
changeAuditStamps.lastModified.actor Dimension
The actor (e.g., user URN) who last modified the ad account.
changeAuditStamps.lastModified.time Dimension
The timestamp when the ad account was last modified.
changeAuditStamps.lastModified.time.date Dimension
The date portion of the timestamp when the ad account was last modified.
clicks Metric
The total number of chargeable clicks on an ad, representing interactions like landing page views or company page visits.
commentLikes Metric
The number of likes received on comments made on Sponsored Content.
comments Metric
The number of comments received on Sponsored Content.
companyPageClicks Metric
The number of clicks that directed users to the company page associated with the ad.
content.reference Dimension
A reference (URN) to the creative content associated with the ad, providing details about the ad's visual or textual assets.
conversion.account Dimension
The account associated with the conversion event.
conversion.attributionType Dimension
The method or model used to assign credit for a conversion to various touchpoints in the customer journey.
conversion.enabled Dimension
A boolean flag indicating whether the conversion rule is active and enabled to trigger conversion events.
conversion.id Metric
A unique identifier for the conversion event or conversion rule.
conversion.name Dimension
The name given to the conversion event or conversion rule for identification.
conversion.postClickAttributionWindowSize Metric
The number of days in the conversion window during which conversions are attributed to a LinkedIn ad after a member clicks on it. The default value is 30 days. Allowed values include 1, 7, 30, 90, and 365 days, with the 365-day window supported for specific conversion types like SUBMIT_APPLICATION, PURCHASE, ADD_TO_CART, QUALIFIED_LEAD, and LEAD.
conversion.type Dimension
The category or classification of the conversion event (e.g., Lead, Purchase).
conversion.value.amount Metric
The monetary value associated with a conversion event.
conversion.value.currencyCode Dimension
The currency code for the value of the conversion.
conversion.viewThroughAttributionWindowSize Metric
Specifies the duration (in days) for the view-through (post-view) attribution window for conversions.
conversionValueInLocalCurrency Metric
The monetary value of conversions recorded in the ad account's local currency, based on advertiser-defined rules, applicable for non-demographic pivots.
costInLocalCurrency Metric
The total cost of the ad campaign in the account's local currency, broken down by selected pivots and time granularity.
costInUsd Metric
The total cost of the ad campaign in USD, broken down by selected pivots and time granularity.
costType Dimension
The billing model or type of cost associated with the advertising campaign, such as Cost Per Click (CPC) or Cost Per Mille (CPM).
createdAt Dimension
The timestamp when the entity was created.
createdAt.date Dimension
The date when the entity was created.
createdBy Dimension
The user (identified by a URN) who created the ad account or ad creative, or the timestamp indicating when the ad creative was originally created.
creative.activity Dimension
The activity associated with the creative, often referring to a sponsored update or social share.
creative.call_to_action Dimension
The call-to-action (CTA) text displayed on the creative (e.g., 'Learn More', 'Apply Now').
creative.call_to_action_target Dimension
The target URL or destination for the creative's call-to-action.
creative.campaign Dimension
The unique identifier of the campaign to which this creative belongs.
creative.changeAuditStamps.created.time Dimension
The timestamp indicating when the ad creative was originally created.
creative.changeAuditStamps.lastModified.time Dimension
The timestamp indicating the last time the creative was modified.
creative.company_name Dimension
The name of the company associated with the creative.
creative.contentLandingPageUri Dimension
The URI of the landing page for the content associated with the creative.
creative.created_timestamp Dimension
The timestamp when the creative was created.
creative.description Dimension
The descriptive text for the creative, providing details about the ad.
creative.format Dimension
The format of the ad creative, such as image, video, or text, defining its visual and interactive presentation on LinkedIn's platform.
creative.headline Dimension
The headline text for the creative.
creative.id Dimension
The unique identifier of the ad creative.
creative.inmail_account Dimension
The InMail account associated with an InMail creative.
creative.inmail_html_body Dimension
The HTML body content of a Sponsored InMail creative.
creative.inmail_legal_text Dimension
The legal text or disclaimer included in a Sponsored InMail creative.
creative.inmail_sender Dimension
The sender's profile associated with a Sponsored InMail creative.
creative.is_direct_sponsored_content Dimension
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.
creative.job_ad_button_label Dimension
The text label displayed on the call-to-action button for a job ad creative.
creative.name Dimension
The name of the creative, which is what LinkedIn Campaign Manager displays as an Ad.
creative.owner Dimension
The URN of the entity (e.g., organization or ad account) that owns or is associated with the ad creative.
creative.reference Dimension
A reference to the underlying asset or post that the creative is built upon, identified by a URN.
creative.resolved_url Dimension
The final, resolved landing page URL for the ad creative after all redirects.
creative.servingStatuses Dimension
The current serving statuses of the creative, indicating if it's active, paused, or pending. Can include multiple statuses.
creative.share Dimension
The unique identifier (URN) of the LinkedIn share (post) that the ad creative is promoting.
creative.share_media_category Dimension
The category of media being shared by the creative, such as IMAGE or VIDEO.
creative.sponsor_company Dimension
The company sponsoring the creative.
creative.sponsor_logo Dimension
The URL of the sponsor company's logo.
creative.spotlight_logo Dimension
The logo used for a Spotlight ad creative.
creative.status Dimension
The current status of the creative, such as 'ACTIVE', 'PAUSED', 'DRAFT'.
creative.subject Dimension
The subject line of the creative, often used for InMail ads.
creative.text Dimension
The main body text content of the creative.
creative.text_click_uri Dimension
The URI associated with a click on the text component of the creative.
creative.text_vector_image Dimension
The vector image used for a text ad creative.
creative.title Dimension
The title of the creative.
creative.type Dimension
The type of the creative, such as 'SponsoredUpdateCreative', 'TextAdCreative', 'VideoAdCreative'.
creative.variables.clickUri Dimension
The click-through URI defined within the creative's variables.
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.directSponsoredContent Dimension
The direct sponsored content associated with a Sponsored Update Carousel creative.
creative.variables.data.com.linkedin.ads.SponsoredUpdateCarouselCreativeVariables.share Dimension
Information related to the organic or sponsored share that forms the basis of the Sponsored Update Carousel creative.
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.directSponsoredContent Dimension
The direct sponsored content associated with a Sponsored Update creative.
creative.variables.data.com.linkedin.ads.SponsoredUpdateCreativeVariables.share Dimension
Information related to the organic or sponsored share that forms the basis of the Sponsored Update creative.
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.directSponsoredContent Dimension
The direct sponsored content associated with a Sponsored Video creative.
creative.variables.data.com.linkedin.ads.SponsoredVideoCreativeVariables.userGeneratedContentPost Dimension
The URN of the user-generated content post associated with a sponsored video creative.
creative.variables.data.com.linkedin.ads.TextAdCreativeVariables.imageId Dimension
The identifier of the image used in a Text Ad creative.
creative.version.versionTag Metric
A unique identifier or tag representing the version of the creative object within the API.
creative.video_lifecycle_state Dimension
The lifecycle state of a video creative, indicating its processing or availability status.
creative.video_primary_landing_page_url Dimension
The primary landing page URL for a video creative.
creative.video_share_commentary Dimension
The commentary text accompanying a video share creative.
creative.video_share_media Dimension
The media URN for the video being shared by the creative.
creative.video_share_media_category Dimension
The category of the video media being shared by the creative.
creative.video_share_media_description Dimension
The description for the video media being shared by the creative.
creative.video_share_media_landing_page Dimension
The landing page URL for the video media being shared by the creative.
creative.video_share_media_text Dimension
The text content associated with the video media being shared by the creative.
creative.video_share_media_title Dimension
The title for the video media being shared by the creative.
creative.video_ugc_origin Dimension
The origin of the user-generated content (UGC) video.
creative.video_visibility Dimension
The visibility setting of a video ad creative, determining who can view it (e.g., public, unlisted).
currency Dimension
The currency used for financial metrics such as ad spend.
dailyBudget.amount Metric
The monetary amount allocated as the daily budget for a campaign.
dailyBudget.currencyCode Dimension
The currency code for the daily budget amount (e.g., USD, EUR).
dateRange Dimension
The inclusive date range for which the report data is requested or provided, specified in UTC.
documentCompletions Metric
The number of times users reached 100% of the document's length in a document ad, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentFirstQuartileCompletions Metric
The number of times users reached the first quartile of the document's length in a document ad, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentMidpointCompletions Metric
The number of times users reached the second quartile (midpoint) of the document's length in a document ad, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentThirdQuartileCompletions Metric
The number of times users reached the third quartile of the document's length in a document ad, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
downloadClicks Metric
The number of times users clicked to indicate an intent to download media from an ad, available for ad formats supporting media downloads.
endDate Dimension
The end date of the reporting period or campaign.
externalWebsiteConversions Metric
The total number of desired actions taken by users on an external website after interacting with or viewing an ad.
externalWebsitePostClickConversions Metric
The total number of desired actions taken by users on an external website specifically after clicking on an ad.
externalWebsitePostViewConversions Metric
The total number of desired actions taken by users on an external website specifically after viewing an ad.
follows Metric
The number of new followers gained, applicable to Sponsored Content and Follower ads.
format Dimension
The format of the advertisement (e.g., Single Image Ad, Video Ad, Carousel Ad, Text Ad, Sponsored Content).
fullScreenPlays Metric
The number of times members engaged with a video ad by entering full screen mode.
headlineClicks Metric
The number of clicks on the headline of conversation ads.
headlineImpressions Metric
The number of times members were shown the headline of conversation ads.
id Dimension
A unique identifier for the entity, such as an ad account, campaign, or creative.
impression_device_type.value Dimension
The type of device on which an ad impression occurred, such as desktop or mobile. This is a pivot for grouping ad analytics data.
impressions Metric
The number of times an ad, particularly Sponsored Content, was displayed to users, or the number of sends for Sponsored Messaging.
intendedStatus Dimension
The desired or target operational status of an advertising creative, which can be modified when the creative is in draft and becomes read-only once a non-draft status is set.
isServing Dimension
Indicates whether the creative is currently being served to audiences. This field is read-only.
isTest Dimension
Indicates if the creative is associated with a test campaign or is in a testing phase.
jobApplications Metric
The number of times a member completed a job application after viewing or clicking on an ad. This metric is broken down into post-view and post-click job applications.
jobApplyClicks Metric
The number of times a member clicked on the job's apply button on a LinkedIn jobs page after viewing or clicking on an ad which has a LinkedIn job landing page. This metric is broken down into post-view and post-click job apply clicks.
landingPageClicks Metric
The number of clicks that directed users to the ad creative's designated landing page.
lastModifiedAt Dimension
The timestamp indicating when the associated resource was last modified, often found as part of audit records for accounts, campaigns, or creatives.
lastModifiedAt.date Dimension
The date component of the timestamp indicating when the associated resource was last modified.
lastModifiedBy Dimension
The user or system (actor) that last modified the associated resource, often found as part of audit stamps for accounts or campaigns.
leadGenerationMailContactInfoShares Metric
The number of times contact information was shared via Lead Gen Forms in Sponsored Messaging campaigns.
leadGenerationMailInterestedClicks Metric
The number of clicks by recipients of Sponsored Messaging ads indicating interest in a lead generation offer.
likes Metric
The number of 'likes' received on Sponsored Content.
locale.country Dimension
The country associated with the locale settings of an ad or account.
locale.language Dimension
The language associated with the locale settings of an ad or account.
member_company.localizedName Dimension
The localized name of the company a member is associated with, used for demographic reporting.
member_company_size.value Dimension
The size category of the company a member works for, used for demographic reporting. This is a pivot for grouping ad analytics data.
member_country.name Dimension
The name of the country associated with the LinkedIn member who engaged with the ad.
member_county.name Dimension
The name of the county where the LinkedIn member (target audience) is located. This is a demographic breakdown field.
member_industry.$URN Dimension
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.
member_industry.id Metric
The unique identifier for a member's industry.
member_industry.name.localized.en_US Dimension
The English (US) localized name of the member's industry.
member_job_function.$URN Dimension
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.
member_job_function.id Metric
The unique identifier for a member's job function, used for demographic reporting.
member_job_function.name.localized.en_US Dimension
The English (US) localized name of the member's job function.
member_job_title.function Dimension
The job function associated with the member's job title. Used for demographic reporting.
member_job_title.id Metric
The unique identifier for the member's job title. Used for demographic reporting.
member_job_title.name.localized.en_US Dimension
The localized name of the job title for members engaging with campaigns, in en_US locale. Used for demographic reporting.
member_job_title.superTitle Dimension
The high-level category or super title associated with a LinkedIn member's job title, used for demographic targeting and reporting.
member_region.name Dimension
The name of the region associated with the LinkedIn member who engaged with the ad.
member_seniority.id Metric
The unique identifier for the member's seniority level. Used for demographic reporting.
member_seniority.name.localized.en_US Dimension
The localized name of the seniority level for members engaging with campaigns, in en_US locale. Used for demographic reporting.
name Dimension
The name or label of the entity, such as an ad account, campaign, or conversion.
objectiveType Dimension
The marketing objective of the campaign (e.g., Brand Awareness, Website Visits, Lead Generation).
offsiteDeliveryEnabled Dimension
A boolean flag indicating whether the ad content can be delivered off the LinkedIn network (e.g., on third-party websites or apps).
oneClickLeadFormOpens Metric
The number of times users opened a lead form for a One Click Lead Gen campaign.
oneClickLeads Metric
The number of leads generated through One Click Lead Gen campaigns.
opens Metric
The number of times Sponsored Messaging ads were opened by recipients.
optimizationTargetType Dimension
Defines the specific goal or metric that a campaign is optimized for, influencing bidding strategies to maximize desired outcomes like qualified leads, clicks, or impressions.
otherEngagements Metric
The count of user interactions with an ad unit that do not fall into other specific engagement categories.
pivot Dimension
A dimension used to group and break down performance metrics in ad analytics reports, such as ACCOUNT, CAMPAIGN, or CREATIVE.
pivotValues Dimension
A collection of specific values for the selected pivot(s) in an analytics report.
placement_name.value Dimension
The name of the placement where the ad is displayed (e.g., LinkedIn Feed, Audience Network).
postClickJobApplications Metric
The number of times a member completed a job application after clicking on an ad.
postClickJobApplyClicks Metric
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.
postClickRegistrations Metric
The number of times a member registered for an event or seminar after clicking on an ad leading to a LinkedIn landing page.
postViewJobApplications Metric
The number of job applications submitted after viewing an ad, without clicking.
postViewJobApplyClicks Metric
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.
postViewRegistrations Metric
The number of registrations completed after viewing an ad, without clicking.
reactions Metric
The number of positive reactions (e.g., like, insightful, curious) on Sponsored Content.
reference Dimension
The unique identifier (URN) for the primary ad entity being processed.
registrations Metric
The number of times users completed a registration action after engaging with an ad.
review.status Dimension
The current review status of the ad creative. The review process begins when the creative transitions from a draft to an active state. This field is read-only.
runSchedule.end Dimension
The timestamp indicating the end of the campaign's scheduled run.
runSchedule.end.date Dimension
The date indicating the end of the campaign's scheduled run.
runSchedule.start Dimension
The timestamp indicating the start of the campaign's scheduled run.
runSchedule.start.date Dimension
The date indicating the start of the campaign's scheduled run.
sends Metric
The number of times Sponsored Messaging ads were sent to recipients.
servingStatuses Dimension
The current serving statuses that indicate whether an ad or campaign is active, paused, or pending.
shares Metric
The number of times Sponsored Content was shared by users.
startDate Dimension
The start date of the reporting period or campaign.
status Dimension
The current operational state of the associated LinkedIn Ads entity, such as an ad campaign or creative.
storyDeliveryEnabled Dimension
This dimension indicates whether the delivery of story ads is enabled for the associated LinkedIn Ads entity, such as an ad campaign or creative.
subscriptionClicks Metric
The number of clicks on a subscription-related call to action in an ad.
talentLeads Metric
The number of leads generated specifically for talent-related objectives.
targetingCriteria Dimension
The criteria used to define the audience targeted by the ad campaign, such as demographics, job titles, industries, or skills.
textUrlClicks Metric
The number of clicks on text-based URLs or links embedded within the body of a Sponsored Messaging ad.
totalEngagements Metric
The total number of all user interactions with the ad unit, combining various engagement types.
type Dimension
The classification or category of an entity, such as an ad account type, campaign type, or creative type.
unitCost.amount Metric
The amount of the unit cost for a campaign.
unitCost.currencyCode Dimension
The currency code for the unit cost of a campaign.
urn Dimension
The Uniform Resource Name (URN) that uniquely identifies an entity (e.g., account, campaign, creative).
version.versionTag Metric
A unique identifier or tag that represents the specific version of an object (e.g., ad account, campaign) within the API.
videoCompletions Metric
The number of times a video ad was played 97-100% of its duration, including watches that skipped to this point.
videoFirstQuartileCompletions Metric
The number of times a video ad was played through the first quartile (25%) of its duration, including watches that skipped to this point.
videoMidpointCompletions Metric
The number of times a video ad was played through its midpoint (50%) duration, including watches that skipped to this point.
videoStarts Metric
The number of times a video ad began playing by users.
videoThirdQuartileCompletions Metric
The number of times a video ad was played through the third quartile (75%) of its duration, including watches that skipped to this point.
videoViews Metric
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.
viralCardClicks Metric
The number of clicks on individual cards within a carousel ad that resulted from viral impressions, applicable for non-demographic pivots.
viralCardImpressions Metric
The number of organic impressions for each card within a carousel ad.
viralClicks Metric
The number of clicks that originated from viral impressions on Sponsored Content.
viralCommentLikes Metric
The count of likes on comments that originated from viral impressions of a Sponsored Content ad.
viralComments Metric
The number of organic comments received on an ad or sponsored content.
viralCompanyPageClicks Metric
The number of clicks to view the company page resulting from viral impressions on Sponsored Content.
viralDocumentCompletions Metric
The number of times users completed viewing an entire document ad, indicating full engagement with the content.
viralDocumentFirstQuartileCompletions Metric
The number of times users completed viewing the first 25% of a document ad.
viralDocumentMidpointCompletions Metric
The number of times users completed viewing 50% (midpoint) of a document ad.
viralDocumentThirdQuartileCompletions Metric
The number of times users completed viewing 75% (third quartile) of a document ad.
viralDownloadClicks Metric
The number of times users clicked to download media from a viral ad, available for ads supporting media downloads.
viralExternalWebsiteConversions Metric
The number of organic conversions that occurred on an external website after users engaged with an ad.
viralExternalWebsitePostClickConversions Metric
The number of post-click conversions on an external website attributed to viral clicks on an ad.
viralExternalWebsitePostViewConversions Metric
The number of organic conversions on an external website attributed to a view of an ad, rather than a direct click.
viralFollows Metric
The number of organic follows gained as a result of ad engagement.
viralFullScreenPlays Metric
The number of times a video ad creative was played in full-screen mode by users, indicating engagement beyond initial view.
viralImpressions Metric
The number of organic (non-paid) impressions an ad or sponsored content has received.
viralJobApplications Metric
The number of job applications driven by viral or organic reach attributed to an ad campaign.
viralJobApplyClicks Metric
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.
viralLandingPageClicks Metric
The number of clicks on viral impressions that directed users to the ad creative's landing page on Sponsored Content.
viralLikes Metric
The number of organic likes received on an ad or sponsored content.
viralOneClickLeadFormOpens Metric
The number of times users opened a lead form for a Lead Gen campaign originating from viral impressions.
viralOneClickLeads Metric
The number of leads generated through One Click Lead Gen campaigns from viral impressions.
viralOtherEngagements Metric
The number of other organic engagement actions (not clicks, likes, shares, or comments) on an ad.
viralPostClickJobApplications Metric
The number of times a member completed a job application after clicking on a viral ad.
viralPostClickJobApplyClicks Metric
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.
viralPostClickRegistrations Metric
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.
viralPostViewJobApplications Metric
The number of job applications resulting from users who viewed an ad post and subsequently applied for a job, including viral reach.
viralPostViewJobApplyClicks Metric
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.
viralPostViewRegistrations Metric
The number of registrations resulting from users who viewed an ad post and subsequently registered, including viral reach.
viralReactions Metric
The total number of organic reactions (likes, comments, shares, etc.) on an ad or sponsored content.
viralRegistrations Metric
The number of registrations driven by viral or organic reach attributed to an ad campaign.
viralShares Metric
The number of organic shares of an ad or sponsored content.
viralSubscriptionClicks Metric
The number of clicks on ads that led to a subscription (e.g., newsletter, premium content), including viral reach.
viralTotalEngagements Metric
The total number of organic engagement actions (likes, comments, shares, etc.) on an ad.
viralVideoCompletions Metric
The number of organic video ads that played to 97-100% completion.
viralVideoFirstQuartileCompletions Metric
The number of organic video ads that played through the first 25% duration.
viralVideoMidpointCompletions Metric
The number of organic video ads that played through the 50% duration (midpoint).
viralVideoStarts Metric
The number of organic video ad plays that were initiated.
viralVideoThirdQuartileCompletions Metric
The number of organic video ads that played through the 75% duration.
viralVideoViews Metric
The number of organic (non-paid) views a video ad has received.