LinkedIn Ads: Most-used fields

The actor (e.g., user URN) who created the ad account.

The timestamp when the ad account was created.

The actor (e.g., user URN) who last modified the ad account.

The timestamp when the ad account was last modified.

The default currency used for the ad account.

The unique identifier of the ad account.

The name of the ad account.

Indicates if the account contact receives notifications about campaign optimization opportunities.

Indicates if the account contact receives notifications when a creative has been reviewed and approved.

Indicates if the account contact receives notifications when a creative has been rejected.

Indicates if the account contact receives notifications when an associated campaign has ended.

A unique identifier or reference for the ad account.

The current serving statuses for the ad account, indicating if it's active, paused, or in review.

The overall status of the ad account, such as 'ACTIVE' or 'CLOSED'.

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

A unique identifier or tag representing the version of the ad account object within the API.

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

The number of clicks recorded on an ad unit.

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.

The unique identifier (URN) of the LinkedIn entity associated with the record, such as an ad account, campaign, or creative.

Indicates whether audience expansion is enabled for a campaign, which can broaden the reach beyond explicitly targeted companies.

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.

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.

The name of the campaign.

The unique identifier of the ad account to which the campaign belongs.

The entity, such as an organization or member, that the campaign is associated with.

Indicates whether audience expansion is enabled for the campaign, which broadens targeting criteria.

The timestamp when the campaign was created.

The timestamp when the campaign was last modified.

The method by which the cost of a campaign is determined, such as CPC (Cost Per Click) or CPM (Cost Per Mille).

The method or strategy used to select and deliver creatives within a campaign.

The daily budget amount set for the campaign.

The currency code (e.g., USD, EUR) used for the campaign's daily budget.

The unique identifier of the campaign.

The country target associated with the campaign's locale.

The language target associated with the campaign's locale.

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.

The primary marketing objective of the campaign, such as Lead Generation, Website Traffic, or Brand Awareness.

Indicates if the campaign is enabled for delivery on the LinkedIn Audience Network (off-site placements).

A list of IAB (Interactive Advertising Bureau) categories to exclude for offsite ad placements, preventing ads from appearing on certain content types.

The end date and time of the campaign's run schedule.

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

The current serving statuses of the campaign, indicating if it's active, paused, or pending. Can include multiple statuses.

The current status of the campaign, such as 'ACTIVE', 'PAUSED', 'DRAFT'.

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

A list of employer organizations that are explicitly excluded from the campaign's targeting.

A list of companies that, if followed by a member, would exclude them from the campaign's targeting.

A list of industries that are explicitly excluded from the campaign's targeting.

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

A list of professional seniorities that are explicitly excluded from the campaign's targeting.

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

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

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

A list of employer organizations that are explicitly included in the campaign's targeting.

A list of companies that, if followed by a member, would include them in the campaign's targeting.

Groups of members who will be included in the advertising campaign's targeting.

A list of industries that are explicitly included in the campaign's targeting.

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

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

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

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

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

A list of professional seniorities that are explicitly included in the campaign's targeting.

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

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

Specific job titles that will be included in the advertising campaign's targeting.

The maximum number of years of professional experience included in the targeting criteria for the campaign.

The minimum number of years of professional experience included in the targeting criteria for the campaign.

Specifies the criteria used to exclude certain audiences from a campaign's targeting.

The criteria used to include specific demographics or attributes for campaign targeting.

The total budget amount set for the campaign.

The currency code for the total budget amount of the campaign.

The type of ad campaign, such as Text Ad, Sponsored Updates, Sponsored InMails, or Dynamic Ads.

The unit cost amount, such as cost per click or cost per impression, for the campaign.

The currency code for the campaign's unit cost.

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

A unique identifier or tag representing the version of the campaign object within the API.

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

A boolean flag indicating whether the campaign group was created organically or was automatically generated ('backfilled') to accommodate existing campaigns. This is a read-only system-set field, often used to identify default campaign groups.

The timestamp when the campaign group was initially created in the LinkedIn Ads platform.

The timestamp when the campaign group was last modified or updated in the LinkedIn Ads platform.

The unique identifier of the campaign group.

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.

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

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

The serving statuses of the campaign group.

The current operational status of the campaign group.

The maximum amount to spend across all associated campaigns and creatives for the duration of the campaign group.

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

The number of clicks on individual cards within a carousel ad creative, applicable for non-demographic pivots.

The number of impressions recorded for each individual card within a carousel ad, applicable for non-demographic pivots.

The actor (e.g., user URN) who created the ad account.

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

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

The actor (e.g., user URN) who last modified the ad account.

The timestamp when the ad account was last modified.

The date portion of the timestamp when the ad account was last modified.

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

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

The number of comments received on Sponsored Content.

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

A reference (URN) to the creative content associated with the ad, providing details about the ad's visual or textual assets.

The account associated with the conversion event.

The method or model used to assign credit for a conversion to various touchpoints in the customer journey.

A boolean flag indicating whether the conversion rule is active and enabled to trigger conversion events.

A unique identifier for the conversion event or conversion rule.

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

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.

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

The monetary value associated with a conversion event.

The currency code for the value of the conversion.

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

The monetary value of conversions recorded in the ad account's local currency, based on advertiser-defined rules, applicable for non-demographic pivots.

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

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

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

The timestamp when the entity was created.

The date when the entity was created.

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.

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

The call-to-action (CTA) text displayed on the creative (e.g., 'Learn More', 'Apply Now').

The target URL or destination for the creative's call-to-action.

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

The timestamp indicating when the ad creative was originally created.

The timestamp indicating the last time the creative was modified.

The name of the company associated with the creative.

The URI of the landing page for the content associated with the creative.

The timestamp when the creative was created.

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

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

The headline text for the creative.

The unique identifier of the ad creative.

The InMail account associated with an InMail creative.

The HTML body content of a Sponsored InMail creative.

The legal text or disclaimer included in a Sponsored InMail creative.

The sender's profile associated with a Sponsored InMail creative.

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.

The text label displayed on the call-to-action button for a job ad creative.

The name of the creative, which is what LinkedIn Campaign Manager displays as an Ad.

The URN of the entity (e.g., organization or ad account) that owns or is associated with the ad creative.

A reference to the underlying asset or post that the creative is built upon, identified by a URN.

The final, resolved landing page URL for the ad creative after all redirects.

The current review status of the creative, indicating if it's pending, approved, or rejected by LinkedIn's ad review process.

The current serving statuses of the creative, indicating if it's active, paused, or pending. Can include multiple statuses.

The unique identifier (URN) of the LinkedIn share (post) that the ad creative is promoting.

The category of media being shared by the creative, such as IMAGE or VIDEO.

The company sponsoring the creative.

The URL of the sponsor company's logo.

The custom background image asset used for a LinkedIn Spotlight Ad. Spotlight Ads are a dynamic ad format that can be personalized with a background image.

The name of the ad creative, as displayed within LinkedIn Campaign Manager.

The logo used for a Spotlight ad creative.

The current status of the creative, such as 'ACTIVE', 'PAUSED', 'DRAFT'.

The subject line of the creative, often used for InMail ads.

The main body text content of the creative.

The URI associated with a click on the text component of the creative.

The vector image used for a text ad creative.

The title of the creative.

The type of the creative, such as 'SponsoredUpdateCreative', 'TextAdCreative', 'VideoAdCreative'.

The click-through URI defined within the creative's variables.

The underlying content or 'activity' that forms the basis of a Sponsored Update Carousel creative. Sponsored Update Carousel Ads display multiple image cards in a swipeable format and are based on existing LinkedIn posts or direct sponsored content.

The direct sponsored content associated with a Sponsored Update Carousel creative.

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

The unique identifier (URN) of the LinkedIn share or post that is being promoted as a Sponsored Update creative.

The direct sponsored content associated with a Sponsored Update creative.

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

The direct sponsored content associated with a Sponsored Video creative.

The duration of the sponsored video creative in microseconds.

The Uniform Resource Name (URN) identifying the video media asset used in the Sponsored Video Creative.

The URN of the user-generated content post associated with a sponsored video creative.

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

The vector image asset associated with a Text Ad Creative.

A unique identifier or tag representing the version of the creative object within the API.

The type of external channel where a video creative is distributed, beyond the core LinkedIn platform. This often relates to extending the reach of video ads through networks like the LinkedIn Audience Network to third-party apps and sites.

The lifecycle state of a video creative, indicating its processing or availability status.

The primary landing page URL for a video creative.

The commentary text accompanying a video share creative.

The media URN for the video being shared by the creative.

The category of the video media being shared by the creative.

The description for the video media being shared by the creative.

The landing page URL for the video media being shared by the creative.

The text content associated with the video media being shared by the creative.

The title for the video media being shared by the creative.

The specific target audience defined for the video creative.

The origin of the user-generated content (UGC) video.

The visibility setting of a video ad creative, determining who can view it (e.g., public, unlisted).

The currency used for financial metrics such as ad spend.

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

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

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

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.

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.

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.

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.

The number of times users clicked to indicate an intent to download media from an ad, available for ad formats supporting media downloads.

The end date of the reporting period or campaign.

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

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

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

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

The format of the advertisement (e.g., Single Image Ad, Video Ad, Carousel Ad, Text Ad, Sponsored Content).

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

The number of clicks on the headline of conversation ads.

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

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

The type of device on which an ad impression occurred, such as desktop or mobile. This is a pivot for grouping ad analytics data.

The number of times an ad, particularly Sponsored Content, was displayed to users, or the number of sends for Sponsored Messaging.

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.

Indicates whether the creative is currently being served to audiences. This field is read-only.

Indicates if the creative is associated with a test campaign or is in a testing phase.

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.

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.

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

The timestamp indicating when the associated resource was last modified, often found as part of audit records for accounts, campaigns, or creatives.

The date component of the timestamp indicating when the associated resource was last modified.

The user or system (actor) that last modified the associated resource, often found as part of audit stamps for accounts or campaigns.

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

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

The number of 'likes' received on Sponsored Content.

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

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

The localized name of the company a member is associated with, used for demographic reporting.

The size category of the company a member works for, used for demographic reporting. This is a pivot for grouping ad analytics data.

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

The name of the county where the LinkedIn member (target audience) is located. This is a demographic breakdown field.

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.

The unique identifier for a member's industry.

The English (US) localized name of the member's industry.

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.

The unique identifier for a member's job function, used for demographic reporting.

The English (US) localized name of the member's job function.

The Unique Resource Name (URN) representing a member's primary job title on LinkedIn, used for audience targeting and analytics. This URN is resolved by the connector to a human-readable job title.

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

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

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

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

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

The Unique Resource Name (URN) representing a member's inferred professional seniority level on LinkedIn, used for audience targeting and analytics. This URN is resolved by the connector to a human-readable seniority level such as Entry, Senior, Manager, or CXO.

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

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

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

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

A boolean flag indicating whether the ad content can be delivered off the LinkedIn network (e.g., on third-party websites or apps).

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

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

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

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.

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

A dimension used to group and break down performance metrics in ad analytics reports, such as ACCOUNT, CAMPAIGN, or CREATIVE.

A collection of specific values for the selected pivot(s) in an analytics report.

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

The number of times a member completed a job application after clicking on an ad.

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.

The number of times a member registered for an event or seminar after clicking on an ad leading to a LinkedIn landing page.

The number of job applications submitted after viewing an ad, without clicking.

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.

The number of registrations completed after viewing an ad, without clicking.

The number of positive reactions (e.g., like, insightful, curious) on Sponsored Content.

The unique identifier (URN) for the primary ad entity being processed.

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

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.

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

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

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

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

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

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

The number of times Sponsored Content was shared by users.

The start date of the reporting period or campaign.

The current operational state of the associated LinkedIn Ads entity, such as an ad campaign or creative.

This dimension indicates whether the delivery of story ads is enabled for the associated LinkedIn Ads entity, such as an ad campaign or creative.

The number of clicks on a subscription-related call to action in an ad.

The number of leads generated specifically for talent-related objectives.

The criteria used to define the audience targeted by the ad campaign, such as demographics, job titles, industries, or skills.

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

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

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

The amount of the unit cost for a campaign.

The currency code for the unit cost of a campaign.

The Uniform Resource Name (URN) that uniquely identifies an entity (e.g., account, campaign, creative).

A unique identifier or tag that represents the specific version of an object (e.g., ad account, campaign) within the API.

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

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

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

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

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

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.

The number of clicks on individual cards within a carousel ad that resulted from viral impressions, applicable for non-demographic pivots.

The number of organic impressions for each card within a carousel ad.

The number of clicks that originated from viral impressions on Sponsored Content.

The count of likes on comments that originated from viral impressions of a Sponsored Content ad.

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

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

The number of times users completed viewing an entire document ad, indicating full engagement with the content.

The number of times users completed viewing the first 25% of a document ad.

The number of times users completed viewing 50% (midpoint) of a document ad.

The number of times users completed viewing 75% (third quartile) of a document ad.

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

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

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

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

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

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

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

The number of job applications driven by viral or organic reach attributed to an ad campaign.

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.

The number of clicks on viral impressions that directed users to the ad creative's landing page on Sponsored Content.

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

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

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

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

The number of times a member completed a job application after clicking on a viral ad.

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.

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.

The number of job applications resulting from users who viewed an ad post and subsequently applied for a job, including viral reach.

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.

The number of registrations resulting from users who viewed an ad post and subsequently registered, including viral reach.

The total number of organic reactions (likes, comments, shares, etc.) on an ad or sponsored content.

The number of registrations driven by viral or organic reach attributed to an ad campaign.

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

The number of clicks on ads that led to a subscription (e.g., newsletter, premium content), including viral reach.

The total number of organic engagement actions (likes, comments, shares, etc.) on an ad.

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

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

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

The number of organic video ad plays that were initiated.

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

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