LinkedIn Ads: supported metrics & dimensions
Coupler.io allows users to fetch enhanced reports from LinkedIn Ads with "Report: Ad analytics" report type. Please see below dimensions and metrics that Coupler.io provides.
Ad analytics report - metrics and dimensions
Dimensions
| Group | Name | Description |
|---|---|---|
| Account | Account name | Account name. |
| Account | Account Id | Unique internal ID representing the account. |
| Account | Account name | A label for the account. |
| Account | Account status | ACTIVE - Account is active; this is the default state CANCELED - Account has been permanently canceled DRAFT - Account is in draft status, meaning it's not yet fully set up and it is not serving PENDING_DELETION - Denotes that the account has been requested to be deleted that is currently pending REMOVED - Denotes that the account was deleted, but must remain fetchable due to the existence of performance data. |
| Account | Test | Flag showing whether this account is marked as a test account. An account can be marked as test only during creation. This is an immutable field. |
| Account | Account created at | Account created at. |
| Account | Account updated at | Account updated at. |
| Account | Currency | The 3 character standard currency code such as USD for United States Dollar Note: Advertisers selecting Brazilian Real (BRL) as a currency see their account budget, advertising bids, and spend in BRL, but their account is billed in USD. We recommend communicating this to stakeholders in your application if they opt for BRL. |
| Account | Is notified about campaign optimization | Indicates if the campaign contact is notified about campaign optimization opportunities. |
| Account | Is notified on creative approval | Indicates if the creative contact is notified when a creative has been reviewed and approved. |
| Account | Is notified on creative rejection | Indicates if the creative contact is notified when a creative has been rejected due to content. |
| Account | Is notified on end of campaign | Indicates if the campaign contact is notified when an associated campaign has been completed. |
| Account | Account reference | The entity on whose behalf the account is advertised. Must either be in the format urn:li:person:{id} or urn:li:organization:{id}. |
| Account | Account serving statuses | An array of enums with information about the account's system serving statuses. If an account is eligible for serving, then the array has a single element:RUNNABLE Otherwise, the array contains one or more reasons why the account is not servable: STOPPED BILLING_HOLD ACCOUNT_TOTAL_BUDGET_HOLD ACCOUNT_END_DATE_HOLD RESTRICTED_HOLD INTERNAL_HOLD |
| Account | Account type | BUSINESS – This is the only value allowed when creating accounts through the API. ENTERPRISE – This value cannot be used to create accounts through the API and is reserved for accounts created by LinkedIn's internal ad operations systems. |
| Account | Version tag | The version tag of the account record. |
| Audience | Country | Member country. |
| Audience | Industry | Member industry - Industry Codes. |
| Audience | Member job function | Member job function - Job Function Codes. |
| Audience | Job title | Member job title (e.g. Account Manager). |
| Audience | Region | Member region. |
| Audience | Member seniority | Member seniority - Seniority Codes. |
| Campaign | Campaign Id | Campaign Id. |
| Campaign | Campaign name | The name of the campaign; primarily used to make it easier to reference a campaign and to recall its purpose. |
| Campaign | Campaign status | ACTIVE - Denotes that the campaign is fully servable. PAUSED - Denotes that the campaign meets all requirements to be served, but temporarily should not be. ARCHIVED - Denotes that the campaign is presently inactive, and should mostly be hidden in the UI until un-archived. COMPLETED - Denotes that the campaign has reached a specified budgetary or chronological limit. CANCELED - Denotes that the campaign has been permanently canceled, such as when an advertising account is permanently closed. DRAFT - Denotes that the campaign is still being edited and not eligible for serving. Some validation will be postponed until the campaign is activated. PENDING_DELETION - Denotes that the campaign has been requested to be deleted that is currently pending. REMOVED - Denotes that the campaign was deleted, but must remain fetchable due to the existence of performance data. |
| Campaign | Account | URN identifying the advertising account associated with the campaign. This value is immutable once set. For example, urn:li:sponsoredAccount:{id} |
| Campaign | Associated entity | An URN identifying the intended beneficiary of the advertising campaign such as a specific company or member. |
| Campaign | Audience expansion enabled | Enable Audience Expansion for the campaign provides query expansion for certain targeting criteria. |
| Campaign | Campaign group | URN identifying the campaign group associated with the campaign. The campaign group URN must be specified for campaign creation starting October 30, 2020. |
| Campaign | Campaign created at | Campaign created at. |
| Campaign | Campaign updated at | Campaign updated at. |
| Campaign | Cost type | Possible values: CPM- Cost per thousand advertising impressions. If type=SPONSORED_INMAILS; cost per send(CPS) is measured as CPM x 1000. CPC- Cost per individual click on the associated link. CPV- Cost per view for video ads. |
| Campaign | Creative selection | Default=OPTIMIZED ROUND_ROBIN - Rotate through available creatives to serve them as evenly as possible. OPTIMIZED - Bias selection taking into account such as expected performance. Not available for Message and Conversation Ads (type=SPONSORED_INMAILS). |
| Campaign | Daily budget amount | Maximum amount to spend per day UTC. |
| Campaign | Daily budget currency code | ISO currency code. The currency must match that of the parent account. |
| Campaign | Locale country | Locale of the campaign. An uppercase two-letter country code as defined by ISO-3166. The country and language combination must match one of the supported locales. |
| Campaign | Locale language | Locale of the campaign. A lowercase two-letter language code as defined by ISO-639. The country and language combination must match one of the supported locales. |
| Campaign | Offsite delivery enabled | Allows your campaign to be served on the LinkedIn Audience Network to extend the reach of the campaign by delivering ads beyond the LinkedIn feed to members on third-party apps and sites. There is no default set. |
| Campaign | Optimization target type | Determines how this campaign is optimized for spending. If this is not set, there is no optimization. Refer to the documentation here. |
| Campaign | Test | Flag showing whether this campaign is a test campaign, i.e., belongs to a test account. |
| Campaign | Run schedule start | Scheduled date range to run associated creatives. |
| Campaign | Run schedule end | Scheduled date range to run associated creatives. |
| Campaign | Serving statuses | Array of enums that determine whether or not a campaign may be served; unlike 'status', which is user-managed, the values are controlled by the service. Possible values are: RUNNABLE Campaign is eligible for serving. STOPPED Campaign is currently not servable for reasons other than billing information, budgetary constraints, or termination dates. For instance, a campaign will be STOPPED if it has been PAUSED by the user. ACCOUNT_TOTAL_BUDGET_HOLD Parent account total budget has been reached. ACCOUNT_END_DATE_HOLD Parent account end date has been reached. CAMPAIGN_START_DATE_HOLD Campaign start date is in the future. CAMPAIGN_END_DATE_HOLD Campaign end date has been reached. CAMPAIGN_TOTAL_BUDGET_HOLD Campaign total budget has been reached. CAMPAIGN_AUDIENCE_COUNT_HOLD Campaign is on hold because it has an audience count lower than the threshold. CAMPAIGN_GROUP_START_DATE_HOLD Campaign group start date is in the future. CAMPAIGN_GROUP_END_DATE_HOLD Campaign Group end date is in the past. CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD Campaign group total budget has been reached. CAMPAIGN_GROUP_STATUS_HOLD Campaign group status is on hold. ACCOUNT_SERVING_HOLD Parent account is on hold and not eligible for serving. |
| Campaign | Excluded targeting facets - employers | Excluded targeting facets - employers. |
| Campaign | Excluded targeting facets - locations | Excluded targeting facets - locations. |
| Campaign | Included targeting facets - industries | Included targeting facets - industries. |
| Campaign | Included targeting facets - interface locales | Included targeting facets - interface locales. |
| Campaign | Included targeting facets - locations | Included targeting facets - locations. |
| Campaign | Targeting criteria - exclude | Specifies targeting criteria that the member should match. This is a more advanced boolean expression than the previous targeting field. It provides a generic OR construct exclude different targeting facets when defining audiences for campaigns. |
| Campaign | Targeting criteria - include | Specifies targeting criteria that the member should match. This is a more advanced boolean expression than the previous targeting field. It provides a generic AND construct to include different targeting facets when defining audiences for campaigns. |
| Campaign | Campaign type | TEXT_AD - Text-based ads that show up in the right column or top of the page on LinkedIn. SPONSORED_UPDATES - Native ads that promote a company's content updates in the LinkedIn feed. SPONSORED_INMAILS - Personalized messages with a call-to-action button delivered to a LinkedIn's member inbox. DYNAMIC - Ads that are dynamically personalized. |
| Campaign | Unit cost amount | This value is used as one of the following: amount to bid (for manual bidding), amount which is the target cost (for target cost bidding) per click, impression, or other event depending on the pricing model, or cost cap (for cost cap bidding). |
| Campaign | Unit cost currency code | Amount to bid per click, impression, or other event depending on the pricing model. The default is 0 with the currency code set to match that of the associated account. ISO currency code. |
| Campaign | Version tag | The version tag of the campaign record. |
| Campaign group | Campaign group Id | Numerical identifier for the campaign group |
| Campaign group | Campaign group name | The name of the Campaign Group. Primarily used to make it easier to reference a Campaign Group and to recall its purpose. |
| Campaign group | Campaign group status | ACTIVE - Denotes that the Campaign Group is capable of serving ads, subject to run date and budget limitations (as well as any other limitations at the account or campaign level). ARCHIVED - Denotes that the Campaign Group is presently inactive, and should mostly be hidden in the UI until un-archived. CANCELED - Denotes that the Campaign Group has been permanently canceled and cannot be reactivated. DRAFT - Denotes Campaign Group is in a preliminary state and should temporarily not be served. PAUSED - Denotes that the Campaign Group meets all requirements to be served, but temporarily should not be. |
| Campaign group | Account URN | URN identifying the advertising account associated with the Campaign Group. This value is immutable once set. |
| Campaign group | Backfilled | Flag that denotes whether the Campaign Group was created organically or was created to backfill existing campaigns. This is a system-controlled field. |
| Campaign group | Campaign group created by | Campaign group created by. |
| Campaign group | Campaign group created at | Campaign group created at. |
| Campaign group | Campaign group updated by | Campaign group updated by. |
| Campaign group | Campaign group updated at | Campaign group updated at. |
| Campaign group | Schedule end | Scheduled date range to run associated objects. The start date must be non-null. Represents the exclusive (strictly less than) value in which to end the range. This field is optional. An unset field here indicates an open range; for example, if start is 1455309628000 (Fri, 12 Feb 2016 20:40:28 GMT), and end is not set, it would mean everything at, or after, 1455309628000. If totalBudget is set, this field is mandatory. |
| Campaign group | Schedule start | Represents the inclusive (greater than or equal to) value in which to start the range. This field is mandatory. |
| Campaign group | Test | Flag showing whether this campaign group is a test campaign group, i.e., belongs to a test account. |
| Campaign group | Serving statuses | Array of enums that determine whether or not campaigns within the Campaign Group may be served; unlike 'status', which is user-managed, the values are controlled by the service. Possible values are: RUNNABLE - Campaign group is currently active; billing information, budgetary constraints, or start and end dates are valid. STOPPED - Campaign group is currently not eligible for serving for reasons other than billing information, budgetary constraints, or termination dates. For instance, a campaign group will be STOPPED if it has been canceled by the user, or it is marked as spam. BILLING_HOLD - Parent account is on billing hold. ACCOUNT_TOTAL_BUDGET_HOLD - Parent account total budget has been reached. ACCOUNT_END_DATE_HOLD - Parent account end date has been reached. CAMPAIGN_GROUP_TOTAL_BUDGET_HOLD - Campaign group total budget has been reached. CAMPAIGN_GROUP_START_DATE_HOLD - Campaign group start date is in the future. CAMPAIGN_GROUP_END_DATE_HOLD - Campaign group end date has been reached. |
| Campaign group | Allowed campaign types | Array of enums that indicates allowed campaign types within the specific campaign group. Possible values are: TEXT_AD - Text-based ads that show up in the right column or top of the page on LinkedIn. SPONSORED_UPDATES - Native ads that promote a company's content updates in the LinkedIn feed. SPONSORED_INMAILS - Personalized messages with a call-to-action button delivered to a LinkedIn's member inbox. DYNAMIC - Ads that are dynamically personalized. |
| Campaign group | Total budget | Maximum amount to spend over the life of the Campaign Group. The currency must match that of the Account. |
| Campaign group | Total budget - currency code | ISO currency code. The currency code must match that of the parent account. |
| Conversion | Conversion Id | Conversion Id. |
| Conversion | Conversion name | A short name for this rule, which will be shown in the UI and in reports. |
| Conversion | Conversion value amount | The monetary value for this conversion. The amount of money as a real number string. |
| Conversion | Post-click attribution window size | Conversion window timeframe (in days) of a member clicking on a LinkedIn Ad (a post-click conversion) within which conversions will be attributed to a LinkedIn ad. Allowed values are 1, 7, 30 or 90. Default is 30. Learn more. |
| Conversion | Last callback at | The last time (in milliseconds) the Insight Tag for this domain called back to the server. |
| Conversion | View-through attribution window size | Conversion window timeframe (in days) of a member seeing a LinkedIn Ad (a view-through conversion) within which conversions will be attributed to a LinkedIn ad. Allowed values are 1, 7, 30 or 90. Default is 7. Learn more. |
| Conversion | Conversion created | Conversion created. |
| Conversion | Image pixel tag | Conversion image pixel. |
| Conversion | Conversion type | Type of the conversion to track for this conversion rule. Eg. PURCHASE, LEAD, SIGNUP etc. Complete list can be found below: ADD_TO_CART: The user added one or more things to their shopping cart. DOWNLOAD: The user downloaded a file. INSTALL: The user installed a plugin or an app. KEY_PAGE_VIEW: The user viewed an important web page / app screen. LEAD: The user filled out a lead generation form. PURCHASE: The user made a purchase. SIGN_UP: The user signed up for a web site / app service. OTHER: Something that's not listed. TALENT_LEAD: User submitted their information as a lead on LinkedIn Talent Media's Pipeline Builder Page. JOB_APPLY: User clicked apply to a job on LinkedIn. SAVE: Saves a form or state in the flow. START_CHECKOUT: Begins the checkout process. SCHEDULE: Schedule a service or appointment. VIEW_CONTENT: The user viewed a section of the page or app screen (webview). VIEW_VIDEO: The user played a video. ADD_BILLING_INFO: The user added credit card or purchase details. BOOK_APPOINTMENT: The user reserved an appointment. REQUEST_QUOTE: The user requested a quote. SEARCH: The user searched within the app. Can also track using KEY_PAGE_VIEW that will fire from a search results page. SUBSCRIBE: The user subscribed to a service. AD_CLICK: The user clicked a 3rd party ad. (first party ads are tracked from LinkedIn) AD_VIEW: The user viewed an ad. COMPLETE_SIGNUP: The user completed registration process. SUBMIT_APPLICATION: The user submitted an application, same as COMPLETE_SIGNUP. PHONE_CALL: The user started a call, or performed phone-call specific event or submission. INVITE: The user sent/shared an invite. LOGIN: The user logged in to advertiser's service account. SHARE: The user shared content. DONATE: The user performed a donation. ADD_TO_LIST: The user added a product to a wishlist. RATE: The user rated a service or a product. START_TRIAL: The user started a trial subscription. Overlaps with SUBSCRIBE. OUTBOUND_CLICK: The user left the app or page by clicking a link. (we won't capture the link). CONTACT: The user attempted to contact, by filling a form or a phone call. QUALIFIED_LEAD: The user filled out a lead gen form, and has been filtered by advertiser to be a qualified lead. Attributed conversion events for this type appear in reporting (qualifiedLeads metric shows the total count of qualified leads attributed to the entities in the given time range and costPerQualifiedLead returns the number of qualified leads divided by ad spend.) |
| Conversion | Enabled | Set to true or false to enable or disable this rule from matching conversions. The initial state can be either, but only rules that are enabled will trigger conversion events. Default is true. |
| Conversion | Associated campaigns | Array of campaigns associated with this conversion. |
| Conversion | Campaigns | Campaigns added to conversion. |
| Conversion | URL match rule expression | Expression used to determine if a page view event matches. The top-level expression is the logical disjunction (OR) of AdUrlMatchRules, that are grouped by logical conjunction (AND). Example: (matchRule1 AND matchRule2 AND matchRule3) OR (matchRule4 AND matchRule2). |
| Conversion | Conversion updated at | Conversion updated at. |
| Conversion | Attribution type | The model that describes how conversion actions are to be counted. Acceptable values are: LAST_TOUCH_BY_CAMPAIGN - Each campaign: conversion actions are counted once for each campaign to which they can be attributed. (Default) LAST_TOUCH_BY_CONVERSION - Single Campaign: conversion actions are counted once for each Conversion with at least one associated campaign. Learn more. |
| Conversion | URL rules | URL matching rules. |
| Conversion | Conversion value currency code | Identifying code for currency type. See currency codes for the valid codes. |
| Conversion | Account URN | The Sponsored Ad Account URN that this Conversion will be created under. |
| Creative | Creative Id | Unique ID for a creative (e.g., SponsoredCreativeUrn). |
| Creative | Account URN | URN identifying the advertising account associated with the creative. |
| Creative | Campaign | URN identifying the campaign associated with the creative. |
| Creative | Created by | Entity (e.g., a person URN) that developed the creative. |
| Creative | Last updated by | The entity (e.g., person URN) who modified the creative. |
| Creative | Creative created at | Creation time. |
| Creative | Creative updated at | Time at which the creative was last modified in milliseconds since epoch. |
| Creative | Test | Flag showing whether this creative is a test creative. |
| Creative | Is serving | This indicates whether the creative is currently being served or not. |
| Creative | Intended status | Creative user intended status. The creative intended status is set independently from parent entity status, but parent entity status overrides creative intended status in effect. For example, parent entity status may be PAUSED while creative status is ACTIVE, in which case the creative's effective status is PAUSED, and not served. ACTIVE - Creative development is complete and the creative is available for review and can be served. PAUSED - Creative development is complete and the creative is current, but should temporarily not be served. DRAFT - Creative development is incomplete and may still be edited. ARCHIVED - Creative development is complete, but creative should not be served and should be separated from non-archived creatives in any UI. CANCELLED - The creative will be hidden when querying all creatives under a campaign and canceled creatives will be retrievable if the underlying posts are still valid/available. PENDING_DELETION - Denotes that the creative has been requested to be deleted that is currently pending. REMOVED - Denotes that the creative was deleted, but must remain fetchable due to the existence of performance data. |
| Creative | Serving hold reasons | Array that contains all the reasons why the creative is not serving. In the case a creative is being served, this field will be null and not present in the response. |
| Creative | Content reference | Search values associated with creative content reference, can be share URN, or ugcPosts URN. |
| Creative | Creative review status | Creative review status. |
| Dimension | Values | The value of the pivots for a specific record returned. For example, supplying pivots of CREATIVE and CONVERSION results in a list of records, one for each creative/conversion combination. The pivotValues contain serialized URNs for the specific creative and conversion for a record. |
| Dimension | Company | Member company. |
| Share | Share Id | Share Id. |
| Share | Commentary | Provides the primary content for the share. |
| Share | Share lifecycle state | Defines the state of the share. For the purposes of creating a share, the lifecycleState will always be PUBLISHED. |
| Share | Share updated at | Share updated at. |
| Share | Share visibility | Defines any visibility restrictions for the share. Possible values include:
|
| Share | Share published at | Share published at. |
| Share | Share author | The author of a share contains Person URN of the Member creating the share. |
| Share | Feed distribution | Feed distribution. |
| Share | Third-party distribution channels | Third-party distribution channels. |
| Share | Share content | Share content. |
| Share | Is edited by author | Is edited by author. |
| Share | Is reshare disabled by author | Is reshare disabled by author. |
Metrics
| Group | Name | Description |
|---|---|---|
| Clicks | Action clicks | The count of clicks on the action button of the Sponsored Messaging ad. |
| Clicks | Ad unit clicks | The count of clicks on the ad unit displayed alongside the Sponsored Messaging ad. |
| Clicks | Card clicks | Non-demographic pivots only. The number of clicks for each card of a carousel ad. The first card click of the carousel ad results in an immediate cardClick and click, whereas scrolling to other cards and clicking will count as additional cardClick. |
| Clicks | Company page clicks | The count of clicks to view the company page. |
| Clicks | Download clicks | The number of times users have indicated the intent to download the media in an ad by clicking the download icon. This may or may not result in an actual download (e.g., if the user rejects a browser download prompt). This metric is only available for ad formats supporting media downloads. |
| Clicks | Job apply clicks | 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. Currently, this metric is broken down into postViewJobApplyClicks (if the member performed the action after viewing the ad) and postClickJobApplyClicks (if the member performed the action after clicking the ad). |
| Clicks | Landing page clicks | The count of clicks which take the user to the creative landing page. |
| Clicks | Lead generation mail interested clicks | The count of Sponsored Messaging ad recipients who clicked to demonstrate interest. |
| Clicks | Post-click job apply clicks | The number of times a member clicked on the job’s apply button on a LinkedIn jobs page after clicking on an ad which has a LinkedIn job landing page. See also 'jobApplyClicks'. |
| Clicks | Post-view job apply clicks | The number of times a member clicked on the job’s apply button on a LinkedIn jobs page after clicking an ad which has a LinkedIn job landing page. See also 'jobApplyClicks'. |
| Clicks | Text URL clicks | The count of clicks on any links (anchor tags) that were included in the body of the Sponsored Messaging ad. |
| Clicks | Viral card clicks | Non-demographic pivots only. The number of viralClicks for each card of a carousel ad. The first viralCardClick of the carousel ad results in an immediate viralCardClick and viralClick, whereas scrolling to other cards and clicking will count as additional viralCardClick. |
| Clicks | Viral clicks | The count of clicks on viral impressions. See viral impressions definition. Sponsored Content only. |
| Clicks | Viral company page clicks | The count of clicks to view the company page from viral impressions for this activity. See viral impressions definition. Sponsored Content only. |
| Clicks | Viral download clicks | The number of times users have indicated the intent to download the media in a viral ad by clicking the download icon. This may or may not result in an actual download (e.g., if the user rejects a browser download prompt). Only available for ads supporting media downloads. |
| Clicks | Viral job apply clicks | The number of times a member clicked on the job’s apply button on a LinkedIn jobs page after viewing or clicking on a viral ad which has a LinkedIn job landing page during the date range. Currently, this metric is broken down into viralPostViewJobApplyClicks (if the member performed the action after viewing the viral ad) and viralPostClickJobApplyClicks (if the member performed the action after clicking the viral ad). |
| Clicks | Viral landing page clicks | The count of clicks on viral impressions to take the user to the creative landing page. See viral impressions definition. Sponsored Content only. |
| Clicks | Viral post-click job apply clicks | The number of times a member clicked on the job’s apply button on a LinkedIn jobs page after clicking on a viral ad which has a LinkedIn job landing page. |
| Clicks | Viral post-view job apply clicks | The number of times a member clicked on the job’s apply button on a LinkedIn jobs page after viewing a viral ad which has a LinkedIn job landing page. |
| Conversions | Conversion value in local currency | Non-demographic pivots only. Value of the conversions in the account's local currency based on rules defined by the advertiser. Conversion value is set by the advertiser at a per conversion level, and aggregated across the query time range. |
| Conversions | Post-click conversions | Total number of times users took a desired action after clicking on your ad. When conversions cannot be attributed to individual users, group level attribution or estimation may be used. |
| Conversions | Post-view conversions | Total number of times users took a desired action after seeing your ad. When conversions cannot be attributed to individual users, group level attribution or estimation may be used. |
| Conversions | Viral conversions | The count of conversions that are attributed to your ads driven by a viral event. See viral impressions definition. |
| Conversions | Viral post-click conversions | The count of post-click conversions that are attributed to your ads driven by a viral click. See viral impressions definition. |
| Conversions | Viral post-view conversions | The count of post-view conversions that are attributed to your ads driven by a viral impression. See viral impressions definition. |
| Cost | Amount spend | Cost in USD based on the selected Dimension and Split by period. For example, this would be spend by campaign on a given day if the Dimension is Campaign and Split by period is Daily. Cost is not adjusted for over delivery when a member demographic pivot is specified in the request. |
| Cost | Amount spend in local currency | Cost in the account's local currency based on the selected Dimension and Split by period. For example, this would be spend by member company size per month if the Dimension is member company size and Split by period is MONTHLY. Cost is not adjusted for over delivery when a member demographic pivot is specified in the request. |
| Engagement | Comment likes | The count of likes of a comment. Sponsored Content only. |
| Engagement | Comments | The count of comments. Sponsored Content only. |
| Engagement | Follows | The count of follows. Sponsored Content and Follower ads only. |
| Engagement | Lead generation mail contact info shares | The number of times users shared contact info through the One Click Lead Gen for Sponsored Messaging ads. |
| Engagement | Likes | The count of likes. Sponsored Content only. |
| Engagement | One click lead form opens | The count of times users opened the lead form for a One Click Lead Gen campaign. |
| Engagement | Opens | The count of opens of Sponsored Messaging ads. |
| Engagement | Other engagements | The count of user interactions with the ad unit that do not fit into any other more specific category. |
| Engagement | Post-click job applications | The number of times a member completed a job application after clicking on an ad. See also 'jobApplications'. |
| Engagement | Post-click registrations | The number of times a member has registered for an event or seminar after clicking on an ad which has a LinkedIn landing page. |
| Engagement | Post-view job applications | The number of times a member completed a job application after viewing an ad. See also 'jobApplications'. |
| Engagement | Post-view registrations | The number of times a member has registered for an event or seminar after viewing an ad. |
| Engagement | Reactions | The count of positive reactions on Sponsored Content which can capture like, interest, praise, and other responses. |
| Engagement | Registrations | The number of times a member has registered for an event or seminar after viewing or clicking on an ad. |
| Engagement | Sends | The count of sends of Sponsored Messaging ads. |
| Engagement | Shares | The count of shares. Sponsored Content only. |
| Engagement | Viral comment likes | The count of likes on comments from viral impressions. Sponsored Content only. |
| Engagement | Viral comments | The count of comments from viral impressions. Sponsored Content only. |
| Engagement | Viral follows | The count of follows from viral impressions. Sponsored Content only. |
| Engagement | Viral job applications | The number of times a member completed a job application after viewing or clicking on a viral ad. |
| Engagement | Viral likes | The count of likes from viral impressions for this activity. Sponsored Content only. |
| Engagement | Viral one click lead form opens | The count of times users opened the lead form for viral impressions from a Lead Gen campaign. |
| Engagement | Viral other engagements | The count of user interactions with viral impressions that do not fit into any other more specific category. |
| Engagement | Viral post-click job applications | The number of times a member completed a job application after clicking on a viral ad. |
| Engagement | Viral post-click registrations | The number of times a member has registered for an event or seminar after clicking on a viral ad. |
| Engagement | Viral post-view job applications | The number of times a member completed a job application after viewing a viral ad. |
| Engagement | Viral post-view registrations | The number of times a member has registered for an event or seminar after viewing a viral ad. |
| Engagement | Viral reactions | The count of positive reactions on viral Sponsored Content. See viral impressions definition. |
| Engagement | Viral registrations | The number of times a member has registered for an event or seminar after viewing or clicking on a viral ad. |
| Engagement | Viral shares | The count of shares from viral impressions for this activity. Sponsored Content only. |
| Engagement | Viral total engagements | The count of all user interactions with a viral ad unit. Sponsored Content only. |
| Performance | Clicks | The count of chargeable clicks. Despite not charging for clicks for CPM campaigns, this field still represents those clicks for which we would otherwise charge advertisers based on objective (for example, clicks to view the landing page or company page). |
| Performance | Conversions | Total number of times users took a desired action after clicking on or seeing your ad. When conversions cannot be attributed to individual users, group level attribution or estimation may be used. |
| Performance | Reach | Non-demographic pivots only. The estimated number of unique member accounts with at least one impression. This metric is only available when the number of days in the date range is less than or equal to 92 days. Fully launched in Jan 2024. |
| Performance | Card impressions | Non-demographic pivots only. The number of impressions shown for each card of a carousel ad. The first card results in an immediate cardImpression and impression, while scrolling to other cards will count as additional cardImpressions. |
| Performance | Document 25% completions | The number of times users reached the first quartile of the document’s length, including those that skipped to this point. Available for document ads only. |
| Performance | Document 50% completions | The number of times users reached the second quartile of the document’s length, including those that skipped to this point. Available for document ads only. |
| Performance | Document 75% completions | The number of times users reached the third quartile of the document’s length, including those that skipped to this point. Available for document ads only. |
| Performance | Document completions | The number of times users reached 100% of the document’s length, including those that skipped to this point. Available for document ads only. |
| Performance | Impressions | This is the count of "impressions" for Sponsored Content and "sends" for Sponsored Messaging. |
| Performance | Job applications | The number of times a member completed a job application after viewing or clicking on an ad. Metric includes both postViewJobApplications and postClickJobApplications. |
| Performance | One click leads | The count of leads generated through One Click Lead Gen. |
| Performance | Talent leads | Number of leads captured through a talent media campaign. |
| Performance | Valid work email leads | The count of leads with a valid work email that does not use an established free or personal email domain. |
| Performance | Engagements | The count of all user interactions with the ad unit. |
| Performance | Viral card impressions | The number of viral impressions shown for each card of a carousel ad. The first card results in an immediate viralCardImpression, while scrolling to other cards counts as additional viralCardImpressions. |
| Performance | Viral document 25% completions | The number of times users reached the first quartile of the document’s length on a viral post, including those that skipped to this point. Available for document ads only. |
| Performance | Viral document 50% completions | The number of times users reached the second quartile of the document’s length on a viral post, including those that skipped to this point. Available for document ads only. |
| Performance | Viral document 75% completions | The number of times users reached the third quartile of the document’s length on a viral post, including those that skipped to this point. Available for document ads only. |
| Performance | Viral document completions | The number of times users reached 100% of the document’s length on a viral post, including those that skipped to this point. Available for document ads only. |
| Performance | Viral impressions | The count of viral impressions for this activity. Viral impressions are those resulting from users sharing sponsored content to their own network of connections. |
| Performance | Viral one click leads | The count of leads generated through One Click Lead Gen from viral impressions for this activity. |
| Video | Full screen plays | Number of times members click on the full screen button or on the video (mobile only) to go into full screen mode. |
| Video | Plays at 25% | The count of video ads that played through the first quartile of the video. This includes watches that skipped to this point if the serving location is ON_SITE. |
| Video | Plays at 50% | The count of video ads that played through the midpoint of the video. This includes watches that skipped to this point if the serving location is ON_SITE. |
| Video | Plays at 75% | The count of video ads that played through the third quartile of the video. This includes watches that skipped to this point if the serving location is ON_SITE. |
| Video | Plays at 100% | The count of video ads that played 97-100% of the video. This includes watches that skipped to this point if the serving location is ON_SITE. |
| Video | Video starts | The count of video ads that were started by users. |
| Video | Video views | A video ad playing for at least 2 continuous seconds 50% in-view, or a click on the CTA, whichever comes first. An interaction with the video (like going to full screen mode) does not count as a view. |
| Video | Viral full screen plays | Number of times members click on the full screen button or on the video (mobile only) to go into full screen mode. See viralImpressions definition. |
| Viral video | Plays at 25% | The count of viral video ads that played through the first quartile of the video. This includes watches that skipped to this point. See viralImpressions definition. |
| Viral video | Plays at 50% | The count of viral video ads that played through the midpoint of the video. This includes watches that skipped to this point. See viralImpressions definition. |
| Viral video | Plays at 75% | The count of viral video ads that played through the third quartile of the video. This includes watches that skipped to this point. See viralImpressions definition. |
| Viral video | Plays at 100% | The count of viral video ads that played 97-100% of the video. This includes watches that skipped to this point. See viralImpressions definition. |
| Viral video | Viral video starts | The count of viral video ads that were started by users. Since viral videos are automatically played for ON_SITE, this will be the same as viralImpressions if the servingLocation is ON_SITE. |
| Viral video | Viral video views | A viral video ad playing for at least 2 continuous seconds 50% in-view, or a click on the CTA, whichever comes first. An interaction with the video (like going to full screen mode) does not count as a view. |
👀 Current article displays all supported dimensions and metrics, however in single report you can select up to 18 metrics. Dimensions are predefined based on your importer settings ("Dimension" field).
💫 If you want to have more than 18 metrics in report, you can use next approach: Overcome LinkedIn Ads limit for 18 metrics in a single report.
How to get CPM and Frequency metrics?
💡 LinkedIn Ads API does not return Frequency and CPM metrics, but you can add these metrics using Formula columns on Transformation step in Coupler.io:
- Select Impressions, Reach and Amount spend metrics in importer settings.
- On Transformation step add Formula columns with next formulas:
| Metric | Formula | Format | Precision |
| CPM | {costInUsd}/{impressions})*1000 |
Currency | 1.00 |
| Frequency | {impressions}/{approximateMemberReach} |
Number | 1.00 |
