LinkedIn Ads

The below demographics enum values are supported only by the analytics finder with a single pivot: 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 - Group results by member country. MEMBER_REGION - Group results by member region. MEMBER_COMPANY - Group results by member company.

dimension

string

account.changeAuditStamps.created.actor

string

Seniorities to be targeted.

dimension

account.changeAuditStamps.created.time

string

Audit change stamps including creation timestamp and last updated timestamp

dimension

account.changeAuditStamps.lastModified.actor

string

Audit change stamps including creation timestamp and last updated timestamp

dimension

account.changeAuditStamps.lastModified.time

string

Audit change stamps including creation timestamp and last updated timestamp

dimension

account.currency

string

The ISO 4217 currency code of the account- such as 'USD' for United States dollar

dimension

account.id

string

Id of the account

dimension

account.name

string

A label for the account

dimension

account.notifiedOnCampaignOptimization

string

Indicates if campaign contact is notified about campaign optimization opportunities.

dimension

account.notifiedOnCreativeApproval

string

Indicates if creative contact is notified when a creative has been reviewed and approved.

dimension

account.notifiedOnCreativeRejection

string

Indicates if creative contact is notified when a creative has been rejected due to content.

dimension

account.notifiedOnEndOfCampaign

string

Indicates if campaign contact is notified when an associated campaign has been completed.

dimension

account.reference

string

The entity on whose behalf the account advertises.

dimension

account.servingStatuses

string

Serving status of the account

dimension

account.status

string

Status of the account

dimension

account.type

string

The type of account.

dimension

account.version.versionTag

string

The version tag

dimension

actionClicks

long

The count of clicks on the action button of the Sponsored InMail. Sponsored InMail only.

metric

adUnitClicks

long

The count of clicks on the ad unit displayed alongside the Sponsored InMail. Sponsored InMail only.

metric

campaign.account

string

URN identifying the advertising account associated with the Campaign. This value is immutable once set

dimension

campaign.associatedEntity

string

An URN for a strongly associated object- with semantics varying based on the Campaign type. The urn typically identifies the intended beneficiary of the advertising campaign- such as a specific company or member

dimension

campaign.audienceExpansionEnabled

string

Enable Audience Expansion for the campaign provides query expansion for certain targeting criteria

dimension

campaign.changeAuditStamps.created.time

string

Audit change stamps including creation timestamp and last updated timestamp

dimension

campaign.changeAuditStamps.lastModified.time

string

For ex: [

dimension

campaign.costType

string

CPM - Cost per thousand advertising impressions - CPC - Cost per individual click on the associated link

dimension

campaign.creativeSelection

string

ROUND_ROBIN - Rotate through available creatives to serve them as easily as possible - OPTIMIZED - Bias selection taking into account such things as expected performance

dimension

campaign.dailyBudget.amount

currency

Maximum amount to spend per day. The currency must match that of the parent account. The amount of money as a real number string

metric

campaign.dailyBudget.currencyCode

currency

Maximum amount to spend per day. The currency must match that of the parent account. ISO currency code

metric

campaign.id

string

Id of the campaign

dimension

campaign.locale.country

string

Locale of the campaign. The language and country come from ISO-639-1 and ISO-3166-1 alpha-2- respectively. An uppercase two-letter country code as defined by ISO-3166.

dimension

campaign.locale.language

string

Locale of the campaign. The language and country come from ISO-639-1 and ISO-3166-1 alpha-2- respectively. A lowercase two-letter language code as defined by ISO-639.

dimension

campaign.name

string

The name of the Campaign; primarily used to make it easier to reference a Campaign and to recall its purpose

dimension

campaign.objectiveType

string

CREATIVE_ENGAGEMENT- WEBSITE_TRAFFIC- or LEAD_GENERATION. - CREATIVE_ENGAGEMENT are actions directly accessible from the ad creative such as clicks- likes- shares- comments- etc.- WEBSITE_TRAFFIC are clicks that direct the user to the advertiser's website.- LEAD_GENERATION is the collection of contact information for potential leads.

dimension

campaign.offsiteDeliveryEnabled

string

Allow this campaign access to be served on the LinkedIn Advertising Network. Default value is

dimension

campaign.offsitePreferences.iabCategories.exclude

string

The set of IAB categories that this campaign may be excluded from based on where the ad request is from. Mobile Apps- Mobile Web- and Desktop inventory are all classified into one or more of these categories.

dimension

campaign.runSchedule.end

string

Scheduled date range to run associated creatives. 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.

dimension

campaign.runSchedule.start

string

Scheduled date range to run associated creatives. The start date must be non-null. Represents the inclusive (greater than or equal to) value in which to start the range. This field is optional. An unset field here indicates an open range; for example- if end is 1455309628000 (Fri- 12 Feb 2016 20:40:28 GMT)- and start is not set- it would indicate times up to- but excluding- 1455309628000.

dimension

campaign.servingStatuses

string

Serving status of the campaign

dimension

campaign.status

string

Status of the campaign

dimension

campaign.targeting.excludedTargetingFacets.audienceMatchingSegments

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should not match.

dimension

campaign.targeting.excludedTargetingFacets.employers

string

Specific companies to match against member's current employer.

dimension

campaign.targeting.excludedTargetingFacets.followedCompanies

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should not match.

dimension

campaign.targeting.excludedTargetingFacets.industries

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should not match.

dimension

campaign.targeting.excludedTargetingFacets.retargetingSegments

string

For ex: [

dimension

campaign.targeting.excludedTargetingFacets.seniorities

string

Seniorities to be targeted.

dimension

campaign.targeting.excludedTargetingFacets.staffCountRanges

string

The version tag of the campaign record

dimension

campaign.targeting.excludedTargetingFacets.titles

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should not match.

dimension

campaign.targeting.includedTargetingFacets.audienceMatchingSegments

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.employers

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.followedCompanies

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.groups

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.industries

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.interfaceLocales

string

Interface locales to be targeted. Currently limited to one locale.

dimension

campaign.targeting.includedTargetingFacets.jobFunctions

string

Top level groupings of supertitles to be targeted.

dimension

campaign.targeting.includedTargetingFacets.locations

string

Location to be targeted. The URNs do not need to all be of the same type. The permitted URN types are:countryGroup- country- state- region. Location is a union of member's current IP location and his/her profile location.

dimension

campaign.targeting.includedTargetingFacets.profileLocations

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.retargetingSegments

string

For ex: [

dimension

campaign.targeting.includedTargetingFacets.seniorities

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.skills

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.staffCountRanges

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.titles

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.end

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.targeting.includedTargetingFacets.yearsOfExperienceRange.start

string

Targeting criteria for the associated creatives; may include a mix of inclusive and exclusive criteria. Specifies targeting criteria that the member should match.

dimension

campaign.totalBudget.amount

currency

Maximum amount to spend over the life of the Campaign. The currency must match that of the Account. The amount of money as a real number string

metric

campaign.totalBudget.currencyCode

currency

Maximum amount to spend over the life of the Campaign. The currency must match that of the Account. ISO currency code

metric

campaign.type

string

TEXT_AD - For the traditional short text with sponsored link advertisement SPONSORED_UPDATES - For sponsored linking to status updates on the profile page belonging to the member or company identified by the 'reference' field

dimension

campaign.unitCost.amount

currency

Amount to bid per click- impression- or other event depending on the pricing model. This defaults to an amount of 0- with the currencyCode set to match that of the associated account. The amount of money as a real number string

metric

campaign.unitCost.currencyCode

string

Amount to bid per click- impression- or other event depending on the pricing model. This defaults to an amount of 0- with the currencyCode set to match that of the associated account. ISO currency code

dimension

campaign.urn

string

The resource defining the membership of the associated segment

dimension

campaign.version.versionTag

string

The version tag of the campaign record

dimension

cardClicks

long

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.

metric

cardImpressions

long

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 will count as additional cardImpressions.

metric

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 (for example- clicks to view the landing page or company page).

metric

clicks

long

Clicks

metric

commentLikes

long

The count of likes of a comment. Sponsored Updates only.

metric

comments

long

The count of comments. Sponsored Updates only.

metric

comments

long

Comments

metric

company.id

string

ID of the Company

dimension

company.name

string

Company Name

dimension

companyPageClicks

long

The count of clicks to view the company page.

metric

conversionValueInLocalCurrency

currency

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.

metric

costInLocalCurrency

currency

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.

metric

costInUsd

currency

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.

metric

dateday

date

Date

dimension

endDate

date

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.

dimension

engagement

long

Engagements

metric

externalWebsiteConversions

float

The count of conversions indicated by pixel loads on an external advertiser website.

metric

externalWebsitePostClickConversions

float

The count of post-click conversions indicated by pixel loads on an external advertiser website.

metric

externalWebsitePostViewConversions

float

The count of post-view conversions indicated by pixel loads on an external advertiser website.

metric

follows

long

The count of follows. Sponsored Updates only.

metric

fullScreenPlays

long

The count of taps on the video- going into video view mode.

metric

impressionCount

long

Number of Impressions

metric

impressions

long

This is the count of

metric

impressions

long

Impressions

metric

landingPageClicks

long

The count of clicks which take the user to the creative landing page.

metric

leadGenerationMailContactInfoShares

long

The number of times users shared contact info through the One Click Lead Gen for Sponsored InMail. Sponsored InMail only.

metric

leadGenerationMailInterestedClicks

long

The count of InMail recipients who clicked to demonstrate interest. Sponsored InMail only.

metric

likes

long

The count of likes. Sponsored Updates only.

metric

likes

long

Number of Likes

metric

member_country.$URN

string

Standardized country URN

dimension

member_country.countryCode

string

The country code.

dimension

member_country.countryGroup

string

The country group URN that this country belongs to.

dimension

member_country.name.locale.country

string

Country name in various locales. Represented as LocaleString type.

dimension

member_country.name.locale.language

string

A lowercase two-letter language code as defined by ISO-639

dimension

member_country.name.value

string

An uppercase two-letter country code as defined by ISO-3166.

dimension

oneClickLeadFormOpens

long

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

metric

oneClickLeads

long

The count of leads generated through One Click Lead Gen.

metric

opens

long

The count of opens of Sponsored InMail. Sponsored InMail only.

metric

organicFollowerCount

long

Organic Follower Count

metric

otherEngagements

long

The count of user interactions with the ad unit that do not fit into any other more specific category.

metric

paidFollowerCount

long

Paid Follower Count

metric

pivot

Pivot of results- by which each report data point is grouped. Use pivot for query finder type analytics. Use pivots for query finder type statistics. The below are valid enum values supported by both the analytics and statistics query finders: 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. SERVING_LOCATION - Group results by serving location- onsite or offsite. 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).

shares

long

Array ofShare URN

metric

shares

long

Number of Shares

metric

startDate

date

Represents the inclusive start time range of the analytics. If unset- it indicates an open range up to the end time.

dimension

textUrlClicks

long

The count of clicks on any links (anchor tags) that were included in the body of the Sponsored InMail. Sponsored InMail only.

metric

totalEngagements

long

The count of all user interactions with the ad unit.

metric

totalFollowerCount

long

Total Followers

metric

urn

string

URN

dimension

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.

metric

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.

metric

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.

metric

videoStarts

long

The count of video ads that were started by users.

metric

videoThirdQuartileCompletions

float

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.

metric

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) does not count as a view.

metric

viralCardClicks

long

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.

metric

viralCardImpressions

long

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 will count as additional viralCardImpressions.

metric

viralClicks

long

The count of clicks on viral impressions. See viral impressions definition. Sponsored Updates only.

metric

viralComments

long

The count of comments from viral impressions for this activity. See viral impressions definition. Sponsored Updates only.

metric

viralCompanyPageClicks

long

The count of clicks to view the company page from viral impressions for this activity. See viral impressions definition. Sponsored Updates only.

metric

viralExternalWebsiteConversions

long

The count of conversions indicated by pixel loads on an external advertiser website driven by a viral event. See viral impressions definition.

metric

viralExternalWebsitePostClickConversions

long

The count of post-click conversions indicated by pixel loads on an external advertiser website driven by a viral click. See viral impressions definition.

metric

viralExternalWebsitePostViewConversions

long

The count of post-view conversions indicated by pixel loads on an external advertiser website driven by a viral impression. See viral impressions definition.

metric

viralFollows

long

The count of follows from viral impressions for this activity. See viral impressions definition. Sponsored Updates only.

metric

viralFullScreenPlays

long

The count of taps on the video- going into video view mode. See viralImpressions definition.

metric

viralImpressions

long

The count of viral impressions for this activity. Viral impressions are those resulting from users sharing a sponsored update to their own network of connections. Viral impressions are not counted as regular impressions. Sponsored Updates only.

metric

viralLandingPageClicks

long

The count of clicks on viral impressions to take the user to the creative landing page. See viral impressions definition. Sponsored Updates only.

metric

viralLikes

long

The count of likes from viral impressions for this activity. See viral impressions definition. Sponsored Updates only.

metric

viralOneClickLeadFormOpens

long

The count of times users opened the lead form for viral impressions from a Lead Gen campaign. See viral impressions definition.

metric

viralOneClickLeads

long

The count of leads generated through One Click Lead Gen from viral impressions for this activity. See viral impressions definition.

metric

viralOtherEngagements

long

The count of user interactions with viral impressions that do not fit into any other more specific category. See viral impressions definition. Sponsored Updates only.

metric

viralShares

long

The count of shares from viral impressions for this activity. See viral impressions definition. Sponsored Updates only.

metric

viralTotalEngagements

long

The count of all user interactions with a viral ad unit. See viral impressions definition. Sponsored Updates only.

metric

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.

metric

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.

metric

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.

metric

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 will be the same as viralImpressions if the servingLocation is ON_SITE.

metric

viralVideoThirdQuartileCompletions

float

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

metric

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) does not count as a view. See viralImpressions definition.

metric