Field list for LinkedIn Ads

15 metrics and 79 dimensions available

CategoryFieldCodeTypeDescription
TIMEYearyeardimYear, e.g. 2017
Year of week (Sun-Sat)yearOfWeekdimYear of week for US-style Sunday-Saturday weeks, e.g. 2017
Year of week (Mon-Sun)yearOfWeekIsodimYear of week for ISO standard Monday-Sunday weeks, e.g. 2017
Year & monthyearMonthdimYear and month, e.g. 2017|06
MonthmonthdimMonth, e.g. 6
Year & week (Sun-Sat)yearWeekdimYear and week for US-style Sunday-Saturday weeks, e.g. 2017|08
Year & week (Mon-Sun)yearWeekIsodimYear and week for ISO standard Monday-Sunday weeks, e.g. 2017|08
Week (Sun-Sat)weekdimUS week number, e.g. 51
Week (Mon-Sun)weekIsodimISO week number, e.g. 51
Day of monthdayOfMonthdimDay of month, e.g. 2
Day of week (Sun-Sat)dayOfWeekNamedimDay of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday
Day of week (Mon-Sun)dayOfWeekNameIsodimDay of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday
DatedatedimDate, e.g. 2017-01-31
ACCOUNTAccount nameaccountNamedimA label for the account
Account IDaccountIddimUnique identifier for the advertising account
Account currency codeaccountCurrencyCodedimThe ISO 4217 currency code of the account, such as 'USD' for United States Dollar
AD FORMAd form nameadformNamedimName of ad form
Ad form IDadformIddimID of ad form
Ad form statusadformStatusdimStatus of ad form
Ad form descriptionadformDescriptiondimDescription of ad form
Ad form headlineadformHeadlinedimHeadline text of ad form
Ad form landing pageadformLandingPagedimLanding page URL of ad form
Ad form legal disclaimeradformLegalDisclaimerdimLegal disclaimer text of ad form
Ad form privacy policyadformPrivacyPolicydimPrivacy policy URL of ad form
Ad form version tagadformVersionTagdimVersion tag of ad form
Ad form question nameadformQuestionNamedimName of a question field from ad form
Ad form question IDadformQuestionIddimID of a question from ad form
Ad form question fieldadformQuestionFielddimField ID of a question from ad form
Ad form question placeholderadformQuestionPlaceholderdimPlaceholder text of a question field from ad form
Ad form question textadformQuestionTextdimQuestion text of a question from ad form
CAMPAIGN GROUPCampaign group namecampaignGroupNamedimThe name of the campaign group
Campaign group IDcampaignGroupIddimNumerical identifier for the campaign group
Campaign group statuscampaignGroupStatusdimStatus of the campaign group
Campaign group total budgetcampaignGroupTotalBudgetdimMaximum amount to spend across all associated campaigns and creatives for duration of the campaign group
Campaign group start datecampaignGroupStartDatedimRepresents the inclusive date when to start running the associated campaigns under this campaign group
Campaign group end datecampaignGroupEndDatedimRepresents the inclusive date when to stop running the associated campaigns under this campaign group
CAMPAIGNCampaign namecampaignNamedimThe name of the campaign
Campaign IDcampaignIddimNumerical identifier for the campaign
Campaign created datecampaignCreateddimCreation date of the campaign
Campaign statuscampaignStatusdimStatus of campaign
Campaign typecampaignTypedimType of campaign, e.g. TEXT_AD
Campaign objective typecampaignObjectiveTypedimObjective type, if available can be used to provide better forecasts
Campaign optimization target typecampaignOptimizationTargetTypedimDetermines how this campaign is optimized for spending
Campaign cost typecampaignCostTypedimCost type, e.g. CPM
Campaign daily budgetcampaignDailyBudgetdimMaximum amount to spend per day
Campaign total budgetcampaignTotalBudgetdimMaximum amount to spend over the life of the Campaign
Campaign unit costcampaignUnitCostdimAmount to bid per click, impression, or other event depending on the pricing model
Campaign start datecampaignStartDatedimStart date of the campaign
Campaign end datecampaignEndDatedimEnd date of the campaign
CREATIVECreative IDcreativeIddimUnique numerical identifier for the ad creative
Creative statuscreativeStatusdimStatus of the creative
Creative typecreativeTypedimType of the creative, e.g. TEXT_AD
Creative Direct Sponsored Content namecreativeDscNamedimIndicate whether the creative is a direct sponsored content or not
Creative titlecreativeTitledimTitle of the creative
Creative textcreativeTextdimBody text of the creative
Creative destination URLcreativeUrldimDestination URL of the creative
Creative ad preview URLcreativeAdPreviewUrldimA URL that renders a preview of what a share would look like as a Sponsored Content Ad Creative. This only supports sponsored status updates and sponsored carousel updates
Creative thumbnail URLcreativeThumbnailUrldimThumbnail URL of the creative
Creative thumbnailcreativeThumbnailImagedimThumbnail of the creative
Creative reference typecreativeReferenceTypedim
Creative reference IDcreativeReferenceIddim
Carousel card indexcreativeCardIndexdimCreative ad carousel card position
CONVERSIONConversion IDconversionIddimConversion ID
Conversion nameconversionNamedimA short name for this rule, which will be shown in the UI and in reports
Conversion typeconversionTypedimThe type of the rule
Conversion enabledconversionEnableddimIs the conversion enabled
Conversion valueconversionValueAmountdimThe monetary value for this conversion
Conversion currencyconversionValueCurrencydimIdentifying code for currency type
Insight tag domain IDinsightTagsDomainIddimAssociation between the website domain(s) and an advertiser account
Insight tag domaininsightTagsDomainNamedimThe domain name for the insight tag
DEMOGRAPHICSMember company sizememberCompanySizedimApproximate company size of LinkedIn members engaged with campaigns
Member industrymemberIndustrydimIndustry of LinkedIn members engaged with campaigns
Member senioritymemberSenioritydimSeniority of LinkedIn members engaged with campaigns
Member job titlememberJobTitledimJob titles of LinkedIn members engaged with campaigns
Member job functionmemberJobFunctiondimJob funnctions of of LinkedIn members engaged with campaigns
Member countrymemberCountrydimCountries of LinkedIn members engaged with campaigns
Member regionmemberRegiondimGeographic regions of LinkedIn members engaged with campaigns
Member company namememberCompanyNamedimCompany names of of LinkedIn members engaged with campaigns
DEPRECATEDAccount total budgetaccountTotalBudgetdimPlease note that this field will be removed on 2020-10-30
PERFORMANCEReachapproximateUniqueImpressionsmetThe approximate reach of the campaign
ImpressionsimpressionsmetCount of 'impressions' for Direct Ads and Sponsored Updates and 'sends' for InMails
ClicksclicksmetCount of chargeable clicks
CTR (%)ctr_percmetClick-through rate
Company page clickscompanyPageClicksmetThe count of clicks to view the company page
Landing page clickslandingPageClicksmetThe count of clicks which take the user to the creative landing page
Other engagementsotherEngagementsmetThe count of user interactions with the ad unit that do not fit into any other more specific category
Total social actionstotalSocialActionsmetLikes, comments, shares, follows and other engagements
Total engagementstotalEngagementsmet
Engagement rateengagementRatemetTotal engagements divided by impressions
CPCcpcmetCost per click
CPMcpmmetCost per 1000 clicks
Total spentspendmetCampaign cost in the currency of the advertising account
Total spent (EUR)spend_eurmetCampaign cost converted to euros
Total spent (GBP)spend_gbpmetCampaign cost converted to British pounds
Total spent (USD)spend_usdmetCampaign cost converted to US dollars
SOCIAL ACTIONSLikeslikesmetThe count of likes. Sponsored Updates only
CommentscommentsmetThe count of comments. Sponsored Updates only
SharessharesmetThe count of shares. Sponsored Updates only
FollowsfollowsmetThe count of follows. Sponsored Updates only
Viral clicksviralClicksmetThe count of clicks on viral impressions. Sponsored Updates only
Viral impressionsviralImpressionsmetViral impressions are those resulting from a user sharing a sponsored update to their own network of connections. Viral impressions are not counted as regular impressions. Sponsored Updates only
Viral likesviralLikesmetThe count of likes from viral impressions. Sponsored Updates only
Viral commentsviralCommentsmetThe count of comments from viral impressions. Sponsored Updates only
Viral sharesviralSharesmetThe count of shares from viral impressions. Sponsored Updates only
Viral followsviralFollowsmetThe count of follows from viral impressions. Sponsored Updates only
Viral company page clicksviralCompanyPageClicksmetThe count of clicks to view the company page from viral impressions. Sponsored Updates only
Viral landing page clicksviralLandingPageClicksmetThe count of viral impressions to take the user to the creative landing page. Sponsored Updates only
Viral other engagementsviralOtherEngagementsmet
Viral total engagementsviralTotalEngagementsmet
Viral external website conversionsviralExternalWebsiteConversionsmetThe count of conversions indicated by pixel loads on an external advertiser website driven by a viral event
Viral external website post click conversionviralExternalWebsitePostClickConversionsmetThe count of post-click conversions indicated by pixel loads on an external advertiser website driven by a viral click
Viral external website post view conversionsviralExternalWebsitePostViewConversionsmetThe count of post-view conversions indicated by pixel loads on an external advertiser website driven by a viral impression
Viral full screen playsviralFullScreenPlaysmetThe count of taps on the video, going into video view mode
Viral reactionsviralReactionsmetThe count of positive reactions on viral Sponsored Updates which can capture like, interest, praise, and other responses
SPONSORED INMAILOpensopensmetThe count of opens of Sponsored InMail
SendssendsmetThe count of sends in Sponsored InMail
Text URL clickstextUrlClicksmetThe count of clicks on any links (anchor tags) that were included in the body of the Sponsored InMail
Action clicksactionClicksmetThe count of clicks on the action button of the Sponsored InMail
Ad unit clicksadUnitClicksmetThe count of clicks on the ad unit displayed alongside the Sponsored InMail
Lead generation mail contact info sharesleadGenerationMailContactInfoSharesmetThe number of times a user shared contact info through the One Click Leadgen for Sponsored InMail
Lead generation mail interested clicksleadGenerationMailInterestedClicksmetThe count of InMail recipients showing interest
ONE CLICK LEAD GEN CAMPAIGNSLeadsoneClickLeadsmetThe count of leads generated through One Click Lead Gen
Lead form opensoneClickLeadFormOpensmetThe count of times users opened the lead form for a One Click Lead Gen campaign
Viral leadsviralOneClickLeadsmetThe count of leads generated through One Click Lead Gen from viral impressions for this activity
Viral form opensviralOneClickLeadFormOpensmetThe count of times users opened the lead form for viral impressions from a Lead Gen campaign
Cost per leadoneClickLeadsCostmetCost per One Click Lead
CONVERSIONSConversionsconversionsmetThe count of conversions indicated by pixel loads
Post-click conversionspostClickConversionsmetThe count of post-click conversions indicated by pixel loads
View-through conversionsviewThroughConversionsmetThe count of view conversions indicated by pixel loads
Conversion rate (%)conversionRate_percmet
Cost per conversionconversionCostmet
Total conversion valueconversionValuemet
Return on ad spendreturnOnSpendmet
VIDEOVideo views at 25%videoFirstQuartileCompletionsmetThe 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 views at 50%videoMidpointCompletionsmetThe count of video ads that played through the midpoint of the video. This includes watches that skippped to this point if the serving location is ON_SITE
Video views at 75%videoThirdQuartileCompletionsmetThe 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 views videoViewsmetA 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
Video completions videoCompletionsmetThe 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
Viral video startsviralVideoStartsmetThe count of viral video ads that were started by users
Viral video completionsviralVideoCompletionsmetThe count of viral video ads that played 97-100% of the video. This includes watches that skipped to this point
Viral video views at 25%viralVideoFirstQuartileCompletionsmetThe count of viral video ads that played through the first quartile of the video. This includes watches that skipped to this point
Viral video views at 50%viralVideoMidpointCompletionsmetThe count of viral video ads that played through the midpoint of the video. This includes watches that skipped to this point
Viral video views at 75%viralVideoThirdQuartileCompletionsmetThe count of viral video ads that played through the third quartile of the video. This includes watches that skipped to this point