Metrics Available

Field Name Type Description
actionClicks long The count of clicks on the action button of the Sponsored Messaging ad.
adUnitClicks long The count of clicks on the ad unit displayed alongside the Sponsored Messaging ad.
approximateMemberReach long Non-demographic pivots only (i.e. not MEMBER_). The estimated number of unique member accounts with at least one impression. This metric is an updated and more accurate version of legacy metric approximateUniqueImpressions. This metric is only available when the number of days in the date range is less than or equal to 92 days. This metric is fully launched in Jan 2024.
averageDwellTime long 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.
Note: The averageDwellTime field is only supported from API version 202411 onwards.
audiencePenetration double The approximate number of unique members reached by the advertiser divided by the approximate total target audience size. The field is null if the date range has more than 92 days. This metric supports ACCOUNT, CAMPAIGN_GROUP, or CAMPAIGN pivots, and can be used alongside additional pivots as long as at least one of these primary pivots is included.
Note: The audiencePenetration field is only supported from API version 202411 onwards.
cardClicks long Non-demographic pivots only (i.e. not MEMBER_). 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 counts as an additional cardClick.
cardImpressions long Non-demographic pivots only (i.e. not MEMBER_). The number of impressions shown for each card of a carousel ad. The first card of the carousel ad results in an immediate cardImpression and impression, whereas scrolling to other cards counts as additional cardImpressions.
clicks long 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).
commentLikes long The count of likes of a comment. Sponsored Content only.
comments long The count of comments. Sponsored Content only.
companyPageClicks long The count of clicks to view the company page.
conversionValueInLocalCurrency BigDecimal Non-demographic pivots only (i.e. not MEMBER_). 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.
costInLocalCurrency BigDecimal Cost in the account's local currency based on the pivot and timeGranularity. For example, this would be spend by member company size per month if the pivot is MEMBER_COMPANY_SIZE and timeGranularity is MONTHLY. Cost is not adjusted for over delivery when a member professional demographic pivot is specified in the request.
costInUsd BigDecimal Cost in USD based on the pivot and timeGranularity. For example, this would be spend by campaign on a given day if the pivot is CAMPAIGN and timeGranularity is DAILY. Cost is not adjusted for over delivery when a member professional demographic pivot is specified in the request.
costPerQualifiedLead BigDecimal How much money was spent per qualified lead. Ratio is costInLocalCurrency / qualifiedLeads.
dateRange DateRange Date range covered by the report data point. Date is specified in UTC. Start and end date are inclusive. Start date is required. End date is optional and defaults to today.
documentCompletions long The number of times users reached 100% of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentFirstQuartileCompletions long The number of times users reached the first quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentMidpointCompletions long The number of times users reached the second quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentThirdQuartileCompletions long The number of times users reached the third quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
downloadClicks long The number of times users have indicated the intent to download the media in an ad by clicking the download icon. This can or can 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.
externalWebsiteConversions long, default="0" Total number of times users took a desired action after clicking on or seeing your ad. When conversions can't be attributed to individual users, group level attribution or estimation can be used.
externalWebsitePostClickConversions long, default="0" Total number of times users took a desired action after clicking on your ad. When conversions can't be attributed to individual users, group level attribution or estimation can be used.
externalWebsitePostViewConversions long, default="0" Total number of times users took a desired action after seeing your ad. When conversions can't be attributed to individual users, group level attribution or estimation can be used.
follows long The count of follows. Sponsored Content and Follower ads only.
fullScreenPlays long Number of times members click on the full screen button or on the video(mobile only) to go into full screen mode.
headlineClicks long The number of times members clicked on the headline of conversation ads.
headlineImpressions long The number of times members were shown the headline of conversation ads.
impressions long This is the count of "impressions" for Sponsored Content and "sends" for Sponsored Messaging.
jobApplications BigDecimal The number of times a member completed a job application after viewing or clicking on an ad. Currently, this metric is broken down into postViewJobApplications (if the member applied after viewing the ad) and postClickJobApplications (if the member applied after clicking the ad).
jobApplyClicks BigDecimal 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).
landingPageClicks long The count of clicks which take the user to the creative landing page.
leadGenerationMailContactInfoShares long The number of times users shared contact info through the One Click Lead Gen for Sponsored Messaging ads.
leadGenerationMailInterestedClicks long The count of Sponsored Messaging ad recipients who clicked to demonstrate interest.
likes long The count of likes. Sponsored Content only.
oneClickLeadFormOpens long The count of times users opened the lead form for a One Click Lead Gen campaign.
oneClickLeads long The count of leads generated through One Click Lead Gen.
opens long The count of opens of Sponsored Messaging ads.
otherEngagements long The count of user interactions with the ad unit that don't fit into any other more specific category.
pivotValues string[], default="[]" 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. To resolve these URNs to their corresponding entities, refer to LinkedIn Marketing API URN Resolution.
postClickJobApplications BigDecimal The number of times a member completed a job application after clicking on an ad. See also jobApplications.
postClickJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after clicking on an ad which has a LinkedIn job landing page. See also jobApplyClicks.
postClickRegistrations BigDecimal The number of times a member has registered for an event or seminar after clicking on an ad which has a LinkedIn landing page. This includes gross registrations and doesn't account for a user unregistering.
postViewJobApplications BigDecimal The number of times a member completed a job application after viewing an ad. See also jobApplications.
postViewJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after clicking an ad which has a LinkedIn job landing page. See also jobApplyClicks.
postViewRegistrations BigDecimal The number of times a member has registered for an event or seminar after viewing an ad which has a LinkedIn event landing page. This includes gross registrations and doesn't account for a user unregistering. See also registrations.
qualifiedLeads long The count of qualified leads shared by the advertiser. Qualified lead is a lead that has been deemed more likely to become a customer compared to other leads, based on their engagement and fit.
reactions long The count of positive reactions on Sponsored Content which can capture, like, interest, praise, and other responses.
registrations BigDecimal The number of times a member has registered for an event or seminar after viewing or clicking on an ad which has a LinkedIn event landing page. This includes gross registrations and doesn't account for a user unregistering.
revenueAttributionMetrics RevenueAttributionMetrics Metrics that represent LinkedIn Ads-attributed opportunities within the CRM (Customer Relationship Management) system. This field is only available through the attributedRevenueMetrics finder.
sends long The count of sends of Sponsored Messaging ads.
shares long The count of shares. Sponsored Content only.
subscriptionClicks long The count of clicks to subscribe to a series, such as a Newsletter.
talentLeads long Number of leads captured through a talent media campaign.
textUrlClicks long The count of clicks on any links (anchor tags) that were included in the body of the Sponsored Messaging ad.
totalEngagements long The count of all user interactions with the ad unit.
validWorkEmailLeads long The count of leads with a valid work email that doesn't use an established free or personal email domain.
videoCompletions long 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.
videoFirstQuartileCompletions long 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.
videoMidpointCompletions long 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.
videoStarts long The count of video ads that were started by users.
videoThirdQuartileCompletions long 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.
videoViews long 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 fullscreen mode) doesn't count as a view.
viralCardClicks long Non-demographic pivots only (i.e. not MEMBER_). 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 counts as additional viralCardClick.
viralCardImpressions long Non-demographic pivots only (i.e. not MEMBER_). The number of viralImpressions shown for each card of a carousel ad. The first card of the carousel ad results in an immediate viralCardImpression and viralImpression, whereas scrolling to other cards counts as additional viralCardImpressions.
viralClicks long The count of clicks on viral impressions. See viral impressions definition. Sponsored Content only.
viralCommentLikes long The count of likes on comments from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralComments long The count of comments from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralCompanyPageClicks long The count of clicks to view the company page from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralDocumentCompletions long The number of times users reached 100% of the document’s length on a viral post, including those that skipped to this point. This metric is only available for document ads.
viralDocumentFirstQuartileCompletions long 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. This metric is only available for document ads.
viralDocumentMidpointCompletions long 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. This metric is only available for document ads.
viralDocumentThirdQuartileCompletions long 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. This metric is only available for document ads.
viralDownloadClicks long The number of times users have indicated the intent to download the media in a viral ad by clicking the download icon. This can or can not result in an actual download (e.g. if the user rejects a browser download prompt). Only available for ads supporting media downloads.
viralExternalWebsiteConversions long The count of conversions that are attributed to your ads driven by a viral event. See viral impressions definition.
viralExternalWebsitePostClickConversions long The count of post-click conversions that are attributed to your ads driven by a viral click. See viral impressions definition.
viralExternalWebsitePostViewConversions long The count of post-view conversions that are attributed to your ads driven by a viral impression. See viral impressions definition.
viralFollows long The count of follows from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralFullScreenPlays long 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.
viralImpressions long The count of viral impressions for this activity. Viral impressions are those resulting from users sharing sponsored content to their own network of connections. Viral impressions are not counted as regular impressions. Sponsored Content only.
viralJobApplications BigDecimal The number of times a member completed a job application after viewing or clicking on a viral ad. Currently, this metric is broken down into viralPostViewJobApplications (if the member performed the action after viewing the viral ad) and viralPostClickJobApplications (if the member performed the action after clicking the viral ad).
viralJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an 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).
viralLandingPageClicks long The count of clicks on viral impressions to take the user to the creative landing page. See viral impressions definition. Sponsored Content only.
viralLikes long The count of likes from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralOneClickLeadFormOpens long The count of times users opened the lead form for viral impressions from a Lead Gen campaign. See viral impressions definition.
viralOneClickLeads long The count of leads generated through One Click Lead Gen from viral impressions for this activity. See viral impressions definition.
viralOtherEngagements long The count of user interactions with viral impressions that don't fit into any other more specific category. See viral impressions definition. Sponsored Content only.
viralPostClickJobApplications BigDecimal The number of times a member completed a job application after clicking on a viral ad.
viralPostClickJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after clicking on a viral ad which has a LinkedIn job landing page.
viralPostClickRegistrations BigDecimal The number of times a member has registered for an event or seminar after clicking on a viral ad which has a LinkedIn landing page. See viralImpressions definition. This includes gross registrations and doesn't account for a user unregistering.
viralPostViewJobApplications BigDecimal The number of times a member completed a job application after viewing a viral ad.
viralPostViewJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after viewing a viral ad which has a LinkedIn job landing page.
viralPostViewRegistrations BigDecimal The number of times a member has registered for an event or seminar after viewing a viral ad which has a LinkedIn event landing page. See viralImpressions definition. This includes gross registrations and doesn't account for a user unregistering.
viralReactions long The count of positive reactions on viral Sponsored Content which can capture like, interest, praise, and other responses. See viral impressions definition for details on viral engagements.
viralRegistrations BigDecimal The number of times a member has registered for an event or seminar after viewing or clicking on a viral ad which has a LinkedIn event landing page. See viralImpressions definition. This includes gross registrations and doesn't account for a user unregistering.
viralShares long The count of shares from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralSubscriptionClicks long The count of viral clicks to subscribe to a series, such as a Newsletter.
viralTotalEngagements long The count of all user interactions with a viral ad unit. See viral impressions definition. Sponsored Content only.
viralVideoCompletions long The count of viral video ads that played 97-100% of the video. This includes watches that skipped to this point. See viralImpressions definition.
viralVideoFirstQuartileCompletions long 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.
viralVideoMidpointCompletions long 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.
viralVideoStarts long The count of viral video ads that were started by users. See viralImpressions definition. Since viral videos are automatically played for ON_SITE, this is the same as viralImpressions if the servingLocation is ON_SITE.
viralVideoThirdQuartileCompletions long 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.
viralVideoViews long 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) doesn't count as a view. See viralImpressions definition.
Field Name Type Description
actionClicks long The count of clicks on the action button of the Sponsored Messaging ad.
adUnitClicks long The count of clicks on the ad unit displayed alongside the Sponsored Messaging ad.
approximateMemberReach long Non-demographic pivots only (i.e. not MEMBER_). The estimated number of unique member accounts with at least one impression. This metric is an updated and more accurate version of legacy metric approximateUniqueImpressions. This metric is only available when the number of days in the date range is less than or equal to 92 days. This metric is fully launched in Jan 2024.
averageDwellTime long 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.
Note: The averageDwellTime field is only supported from API version 202411 onwards.
averageEventWatchTime double The average watch time of the event in milliseconds.
averageEventWatchTimeOver15Seconds double The average watch time in milliseconds for users who watched the event for more than 15 seconds.
averageEventWatchTimeOver2Minutes double The average watch time in milliseconds for users who watched the event for more than 2 minutes.
averageEventWatchTimeOver30Seconds double The average watch time in milliseconds for users who watched the event for more than 30 seconds.
averageVideoWatchTime double Average videoWatchTime in milliseconds.
Note: This metric may be delayed by up to 48 hours.
audiencePenetration double The approximate number of unique members reached by the advertiser divided by the approximate total target audience size. The field is null if the date range has more than 92 days. This metric supports ACCOUNT, CAMPAIGN_GROUP, or CAMPAIGN pivots, and can be used alongside additional pivots as long as at least one of these primary pivots is included.
Note: The audiencePenetration field is only supported from API version 202411 onwards.
cardClicks long Non-demographic pivots only (i.e. not MEMBER_). 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 counts as additional cardClick.
cardImpressions long Non-demographic pivots only (i.e. not MEMBER_). The number of impressions shown for each card of a carousel ad. The first card of the carousel ad results in an immediate cardImpression and impression, whereas scrolling to other cards counts as additional cardImpressions.
clicks long 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).
commentLikes long The count of likes of a comment. Sponsored Content only.
comments long The count of comments. Sponsored Content only.
companyPageClicks long The count of clicks to view the company page.
conversionValueInLocalCurrency BigDecimal Non-demographic pivots only (i.e. not MEMBER_). 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.
costInLocalCurrency BigDecimal Cost in the account's local currency based on the pivot and timeGranularity. For example, this would be spend by member company size per month if the pivot is MEMBER_COMPANY_SIZE and timeGranularity is MONTHLY. Cost is not adjusted for over delivery when a member professional demographic pivot is specified in the request.
costInUsd BigDecimal Cost in USD based on the pivot and timeGranularity. For example, this would be spend by campaign on a given day if the pivot is CAMPAIGN and timeGranularity is DAILY. Cost is not adjusted for over delivery when a member professional demographic pivot is specified in the request.
costPerEventView double The cost per view for an event hosted on LinkedIn.
costPerEventViewOver15Seconds double The cost per view for an event hosted on LinkedIn for users who watched the event for more than 15 seconds.
costPerEventViewOver2Minutes double The cost per view for an event hosted on LinkedIn for users who watched the event for more than 2 minutes.
costPerEventViewOver30Seconds double The cost per view for an event hosted on LinkedIn for users who watched the event for more than 30 seconds.
costPerQualifiedLead BigDecimal How much money was spent per qualified lead. Ratio is costInLocalCurrency / qualifiedLeads.
dateRange DateRange Date range covered by the report data point. Date is specified in UTC. Start and end date are inclusive. Start date is required. End date is optional and defaults to today.
documentCompletions long The number of times users reached 100% of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentFirstQuartileCompletions long The number of times users reached the first quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentMidpointCompletions long The number of times users reached the second quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
documentThirdQuartileCompletions long The number of times users reached the third quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.
downloadClicks long The number of times users have indicated the intent to download the media in an ad by clicking the download icon. This can or can 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.
eventViews long The count of valid views for an event hosted on LinkedIn.
eventViewsOver15Seconds long The count of valid views for an event hosted on LinkedIn for users who watched the event for more than 15 seconds.
eventViewsOver2Minutes long The count of valid views for an event hosted on LinkedIn for users who watched the event for more than 2 minutes.
eventViewsOver30Seconds long The count of valid views for an event hosted on LinkedIn for users who watched the event for more than 30 seconds.
eventWatchTime long The total watch time of the event in milliseconds.
externalWebsiteConversions long, default="0" Total number of times users took a desired action after clicking on or seeing your ad. When conversions can't be attributed to individual users, group level attribution or estimation can be used.
externalWebsitePostClickConversions long, default="0" Total number of times users took a desired action after clicking on your ad. When conversions can't be attributed to individual users, group level attribution or estimation can be used.
externalWebsitePostViewConversions long, default="0" Total number of times users took a desired action after seeing your ad. When conversions can't be attributed to individual users, group level attribution or estimation can be used.
follows long The count of follows. Sponsored Content and Follower ads only.
fullScreenPlays long Number of times members click on the full screen button or on the video(mobile only) to go into full screen mode.
headlineClicks long The number of times members clicked on the headline of conversation ads.
headlineImpressions long The number of times members were shown the headline of conversation ads.
impressions long This is the count of "impressions" for Sponsored Content and "sends" for Sponsored Messaging.
jobApplications BigDecimal The number of times a member completed a job application after viewing or clicking on an ad. Currently, this metric is broken down into postViewJobApplications (if the member applied after viewing the ad) and postClickJobApplications (if the member applied after clicking the ad).
jobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an 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).
landingPageClicks long The count of clicks which take the user to the creative landing page.
leadGenerationMailContactInfoShares long The number of times users shared contact info through the One Click Lead Gen for Sponsored Messaging ads.
leadGenerationMailInterestedClicks long The count of Sponsored Messaging ad recipients who clicked to demonstrate interest.
likes long The count of likes. Sponsored Content only.
oneClickLeadFormOpens long The count of times users opened the lead form for a One Click Lead Gen campaign.
oneClickLeads long The count of leads generated through One Click Lead Gen.
opens long The count of opens of Sponsored Messaging ads.
otherEngagements long The count of user interactions with the ad unit that don't fit into any other more specific category.
pivotValues string[], default="[]" 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. To resolve these URNs to their corresponding entities, refer to LinkedIn Marketing API URN Resolution.
postClickJobApplications BigDecimal The number of times a member completed a job application after clicking on an ad. See also jobApplications.
postClickJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after clicking on an ad which has a LinkedIn job landing page. See also jobApplyClicks.
postClickRegistrations BigDecimal The number of times a member has registered for an event or seminar after clicking on an ad which has a LinkedIn landing page. This includes gross registrations and doesn't account for a user unregistering.
postViewJobApplications BigDecimal The number of times a member completed a job application after viewing an ad. See also jobApplications.
postViewJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after clicking an ad which has a LinkedIn job landing page. See also jobApplyClicks.
postViewRegistrations BigDecimal The number of times a member has registered for an event or seminar after viewing an ad which has a LinkedIn event landing page. This includes gross registrations and doesn't account for a user unregistering. See also registrations.
qualifiedLeads long The count of qualified leads shared by the advertiser. Qualified lead is a lead that has been deemed more likely to become a customer compared to other leads, based on their engagement and fit.
reactions long The count of positive reactions on Sponsored Content which can capture, like, interest, praise, and other responses.
registrations BigDecimal The number of times a member has registered for an event or seminar after viewing or clicking on an ad which has a LinkedIn event landing page. This includes gross registrations and doesn't account for a user unregistering.
revenueAttributionMetrics RevenueAttributionMetrics Metrics that represent LinkedIn Ads-attributed opportunities within the CRM (Customer Relationship Management) system. This field is only available through the attributedRevenueMetrics finder.
sends long The count of sends of Sponsored Messaging ads.
shares long The count of shares. Sponsored Content only.
subscriptionClicks long The count of clicks to subscribe to a series, such as a Newsletter.
talentLeads long Number of leads captured through a talent media campaign.
textUrlClicks long The count of clicks on any links (anchor tags) that were included in the body of the Sponsored Messaging ad.
totalEngagements long The count of all user interactions with the ad unit.
validWorkEmailLeads long The count of leads with a valid work email that doesn't use an established free or personal email domain.
videoCompletions long 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.
videoFirstQuartileCompletions long 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.
videoMidpointCompletions long 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.
videoStarts long The count of video ads that were started by users.
videoThirdQuartileCompletions long 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.
videoViews long 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 fullscreen mode) doesn't count as a view.
videoWatchTime long The total watch time in milliseconds for a video ad. This metric is populated if a user's watching behavior is qualified for videoViews metric.
Note: This metric may be delayed by up to 48 hours.
viralCardClicks long Non-demographic pivots only (i.e. not MEMBER_). 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 counts as additional viralCardClick.
viralCardImpressions long Non-demographic pivots only (i.e. not MEMBER_). The number of viralImpressions shown for each card of a carousel ad. The first card of the carousel ad results in an immediate viralCardImpression and viralImpression, whereas scrolling to other cards counts as additional viralCardImpressions.
viralClicks long The count of clicks on viral impressions. See viral impressions definition. Sponsored Content only.
viralCommentLikes long The count of likes on comments from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralComments long The count of comments from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralCompanyPageClicks long The count of clicks to view the company page from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralDocumentCompletions long The number of times users reached 100% of the document’s length on a viral post, including those that skipped to this point. This metric is only available for document ads.
viralDocumentFirstQuartileCompletions long 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. This metric is only available for document ads.
viralDocumentMidpointCompletions long 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. This metric is only available for document ads.
viralDocumentThirdQuartileCompletions long 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. This metric is only available for document ads.
viralDownloadClicks long The number of times users have indicated the intent to download the media in a viral ad by clicking the download icon. This can or can not result in an actual download (e.g. if the user rejects a browser download prompt). Only available for ads supporting media downloads.
viralExternalWebsiteConversions long The count of conversions that are attributed to your ads driven by a viral event. See viral impressions definition.
viralExternalWebsitePostClickConversions long The count of post-click conversions that are attributed to your ads driven by a viral click. See viral impressions definition.
viralExternalWebsitePostViewConversions long The count of post-view conversions that are attributed to your ads driven by a viral impression. See viral impressions definition.
viralFollows long The count of follows from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralFullScreenPlays long 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.
viralImpressions long The count of viral impressions for this activity. Viral impressions are those resulting from users sharing sponsored content to their own network of connections. Viral impressions are not counted as regular impressions. Sponsored Content only.
viralJobApplications BigDecimal The number of times a member completed a job application after viewing or clicking on a viral ad. Currently, this metric is broken down into viralPostViewJobApplications (if the member performed the action after viewing the viral ad) and viralPostClickJobApplications (if the member performed the action after clicking the viral ad).
viralJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an 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).
viralLandingPageClicks long The count of clicks on viral impressions to take the user to the creative landing page. See viral impressions definition. Sponsored Content only.
viralLikes long The count of likes from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralOneClickLeadFormOpens long The count of times users opened the lead form for viral impressions from a Lead Gen campaign. See viral impressions definition.
viralOneClickLeads long The count of leads generated through One Click Lead Gen from viral impressions for this activity. See viral impressions definition.
viralOtherEngagements long The count of user interactions with viral impressions that don't fit into any other more specific category. See viral impressions definition. Sponsored Content only.
viralPostClickJobApplications BigDecimal The number of times a member completed a job application after clicking on a viral ad.
viralPostClickJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after clicking on a viral ad which has a LinkedIn job landing page.
viralPostClickRegistrations BigDecimal The number of times a member has registered for an event or seminar after clicking on a viral ad which has a LinkedIn landing page. See viralImpressions definition. This includes gross registrations and doesn't account for a user unregistering.
viralPostViewJobApplications BigDecimal The number of times a member completed a job application after viewing a viral ad.
viralPostViewJobApplyClicks BigDecimal The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after viewing a viral ad which has a LinkedIn job landing page.
viralPostViewRegistrations BigDecimal The number of times a member has registered for an event or seminar after viewing a viral ad which has a LinkedIn event landing page. See viralImpressions definition. This includes gross registrations and doesn't account for a user unregistering.
viralReactions long The count of positive reactions on viral Sponsored Content which can capture like, interest, praise, and other responses. See viral impressions definition for details on viral engagements.
viralRegistrations BigDecimal The number of times a member has registered for an event or seminar after viewing or clicking on a viral ad which has a LinkedIn event landing page. See viralImpressions definition. This includes gross registrations and doesn't account for a user unregistering.
viralShares long The count of shares from viral impressions for this activity. See viral impressions definition. Sponsored Content only.
viralSubscriptionClicks long The count of viral clicks to subscribe to a series, such as a Newsletter.
viralTotalEngagements long The count of all user interactions with a viral ad unit. See viral impressions definition. Sponsored Content only.
viralVideoCompletions long The count of viral video ads that played 97-100% of the video. This includes watches that skipped to this point. See viralImpressions definition.
viralVideoFirstQuartileCompletions long 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.
viralVideoMidpointCompletions long 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.
viralVideoStarts long The count of viral video ads that were started by users. See viralImpressions definition. Since viral videos are automatically played for ON_SITE, this is the same as viralImpressions if the servingLocation is ON_SITE.
viralVideoThirdQuartileCompletions long 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.
viralVideoViews long 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) doesn't count as a view. See viralImpressions definition.

Analytics Finder Query Parameters

Parameter Description Format Required
q Designates the query finder. Must be analytics for the Analytics Finder. String Yes
pivot.value Pivot of results, by which each report data point is grouped. The following enum values are supported:
  • COMPANY - Group results by advertiser's company.
  • ACCOUNT - Group results by account.
  • SHARE - Group results by sponsored share.
  • CAMPAIGN - Group results by campaign.
  • CREATIVE - Group results by creative.
  • CAMPAIGN_GROUP - Group results by campaign group.
  • CONVERSION - Group results by conversion.
  • CONVERSATION_NODE - The element row in the conversation is the information for each individual node of the conversation tree.
  • CONVERSATION_NODE_OPTION_INDEX - Used actionClicks are deaggregated and reported at the Node Button level. The second value of the pivot_values is the index of the button in the node.
  • SERVING_LOCATION - Group results by serving location, onsite or offsite. UNKNOWN means the serving location can't be determined, which can result from metrics produced by machine learning models.
  • CARD_INDEX - Group results by the index of where a card appears in a carousel ad creative. Metrics are based on the index of the card at the time when the user's action (impression, click, etc.) happened on the creative (Carousel creatives only).
  • MEMBER_COMPANY_SIZE - Group results by member company size.
  • MEMBER_INDUSTRY - Group results by member industry.
  • MEMBER_SENIORITY - Group results by member seniority.
  • MEMBER_JOB_TITLE - Group results by member job title.
  • MEMBER_JOB_FUNCTION - Group results by member job function.
  • MEMBER_COUNTRY_V2 - Group results by member country.
  • MEMBER_REGION_V2 - Group results by member region.
  • MEMBER_COMPANY - Group results by member company.
  • PLACEMENT_NAME - Group results by placement. UNKNOWN means the placement can't be determined, which can result from metrics produced by machine learning models.
  • IMPRESSION_DEVICE_TYPE - Group results by the device type the ad made an impression on. Reach metrics and conversion metrics are not available when this pivot is used. More details can be found here.
  • EVENT_STAGE - Organize results based on the stage of the live event. (PRE_LIVE, LIVE, POST_LIVE).
String No
dateRange.start Represents the inclusive start time range of the analytics. If unset, it indicates an open range up to the end time. Date object Yes
dateRange.end Represents the inclusive end time range of the analytics. Must be after start time if it's present. If unset, it indicates an open range from start time to everything after. Date object No
timeGranularity.value Time granularity of results. Valid enum values:
  • ALL - Results grouped into a single result across the entire time range of the report.
  • DAILY - Results grouped by day.
  • MONTHLY - Results grouped by month.
  • YEARLY - Results grouped by year.
String Yes
campaignType.value Match result by a campaign type. Supported types are [TEXT_AD, SPONSORED_UPDATES, SPONSORED_INMAILS, DYNAMIC]. Requires at least one other facet. Defaults to empty. String No
shares Match result by share facets. Defaults to empty. Array of Share URN Yes unless another facet is provided.
campaigns Match result by campaign facets. Defaults to empty. Array of Sponsored Campaign URN Yes unless another facet is provided.
campaignGroups Match result by campaign group facets. Defaults to empty. Array of Campaign Group URN Yes unless another facet is provided.
accounts Match result by sponsored ad account facets. Defaults to empty. Array of Account URN Yes unless another facet is provided.
companies Match result by advertiser's own company facets. Defaults to empty. Array of Organization URN Yes unless another facet is provided.
sortBy.field The field by which the results are sorted. Supported values include:
  • COST_IN_LOCAL_CURRENCY
  • IMPRESSIONS
  • CLICKS
  • ONE_CLICK_LEADS
  • OPENS
  • SENDS
  • EXTERNAL_WEBSITE_CONVERSIONS
String Yes if sortBy.order is provided.
sortBy.order The order of the results. Supported values include:
  • ASCENDING
  • DESCENDING
String Yes if sortBy.field is provided.
fields The list of metric fields that you can fetch by passing the required fields. Refer to the Supported fields from the metrics available table. String Yes

Statistics Finder Query Parameters

Parameter Description Format Required
q Designates the query finder. Must be statistics for the Statistics Finder. String Yes
pivots.value Pivot of results, by which each report data point is grouped. Accepts up to 3 values. The following enum values are supported:
  • COMPANY - Group results by advertiser's company.
  • ACCOUNT - Group results by account.
  • SHARE - Group results by sponsored share.
  • CAMPAIGN - Group results by campaign.
  • CREATIVE - Group results by creative.
  • CAMPAIGN_GROUP - Group results by campaign group.
  • CONVERSION - Group results by conversion.
  • CONVERSATION_NODE - The element row in the conversation is the information for each individual node of the conversation tree.
  • CONVERSATION_NODE_OPTION_INDEX - Used actionClicks are deaggregated and reported at the Node Button level. The second value of the pivot_values is the index of the button in the node.
  • SERVING_LOCATION - Group results by serving location, onsite or offsite. UNKNOWN means the serving location can't be determined, which can result from metrics produced by machine learning models.
  • OBJECTIVE_TYPE: Group results by campaign's objective type.
  • CARD_INDEX - Group results by the index of where a card appears in a carousel ad creative. Metrics are based on the index of the card at the time when the user's action (impression, click, etc.) happened on the creative (Carousel creatives only).
  • PLACEMENT_NAME - Group results by placement. UNKNOWN means the placement can't be determined, which can result from metrics produced by machine learning models.
  • IMPRESSION_DEVICE_TYPE - Group results by the device type the ad made an impression on. Reach metrics and conversion metrics are not available when this pivot is used. More details can be found here.
  • EVENT_STAGE - Organize results based on the stage of the live event. (PRE_LIVE, LIVE, POST_LIVE).
Array of Strings Yes
dateRange.start Represents the inclusive start time range of the analytics. If unset, it indicates an open range up to the end time. Date object Yes
dateRange.end Represents the inclusive end time range of the analytics. Must be after start time if it's present. If unset, it indicates an open range from start time to everything after. Date object No
objectiveType.value Filters results by objective type. The following enum values are supported:
  • LEAD_GENERATION
  • CREATIVE_ENGAGEMENT
  • WEBSITE_TRAFFIC
  • VIDEO_VIEW
  • BRAND_AWARENESS
  • WEBSITE_CONVERSION
  • WEBSITE_VISIT
  • ENGAGEMENT
  • JOB_APPLICANT
String No
timeGranularity.value Time granularity of results. Valid enum values:
  • ALL - Results grouped into a single result across the entire time range of the report.
  • DAILY - Results grouped by day.
  • MONTHLY - Results grouped by month.
  • YEARLY - Results grouped by year.
String Yes
campaignType.value Match result by a campaign type. Supported types are:
  • TEXT_AD
  • SPONSORED_UPDATES
  • SPONSORED_INMAILS
  • DYNAMIC
Requires at least one other facet. Defaults to empty.
String No
shares Match result by share facets. Defaults to empty. Array of Share URN Yes unless another facet is provided.
campaigns Match result by campaign facets. Defaults to empty. Array of Sponsored Campaign URN Yes unless another facet is provided.
campaignGroups Match result by campaign group facets. Defaults to empty. Array of Campaign Group URN Yes unless another facet is provided.
accounts Match result by sponsored ad account facets. Defaults to empty. Array of Account URN Yes unless another facet is provided.
companies Match result by advertiser's own company facets. Defaults to empty. Array of Organization URN Yes unless another facet is provided.
sortBy.field The field by which the results are sorted. Supported values include:
  • COST_IN_LOCAL_CURRENCY
  • IMPRESSIONS
  • CLICKS
  • ONE_CLICK_LEADS
  • OPENS
  • SENDS
  • EXTERNAL_WEBSITE_CONVERSIONS
String Yes if sortBy.order is provided.
sortBy.order The order of the results. Supported values include:
  • ASCENDING
  • DESCENDING
String Yes if sortBy.field is provided.

Revenue Attribution Metrics

Field Name Type Description
revenueWonInUsd BigDecimal Sales revenue in USD in customer's CRM that can be attributed to being generated through LinkedIn ads. Attribution credit is distributed at a business level across multiple ad accounts.
returnOnAdSpend double Ratio of total revenue won attributed to LinkedIn marketing divided by LinkedIn ad spend. Attribution credit is distributed at a business level across multiple ad accounts.
(revenueWonInUsd / costInUsd)
closedWonOpportunities long Number of closed-won opportunities attributed to LinkedIn marketing. Attribution credit is distributed at a business level across multiple ad accounts.
opportunityAmountInUsd BigDecimal Total revenue in USD of open opportunities (CRM deals in progress) attributed to LinkedIn marketing. Attribution credit is distributed at a business level across multiple ad accounts.
This metric is available only when date range includes current day.
openOpportunities long Number of open opportunities (CRM deals in progress) attributed to LinkedIn marketing. Attribution credit is distributed at a business level across multiple ad accounts.
This metric is available only when date range includes current day.
opportunityWinRate double Rate at which the opportunities are won out of all the closed opportunities.
(closedWonOpportunities / Number of closed opportunities)
averageDealSizeInUsd BigDecimal Of closed-won opportunities, what's the average size of the deals Linkedin is driving.
(revenueWon / closedWonOpportunities)
averageDaysToClose double The average number of days to close a won deal attributed to LinkedIn marketing.
(Opportunity length in days / closedWonOpportunities)