LinkedIn Ads fields

98 metrics109 dimensions

Search fields

ACCOUNT

accountName

Field label	Account name
Description	A label for the account
Field type	dimension
Data type	string.text.value

accountId

Field label	Account ID
Description	Unique identifier for the advertising account
Field type	dimension
Data type	string.text.value

accountCurrencyCode

Field label	Account currency code
Description	The ISO 4217 currency code of the account, such as 'USD' for United States Dollar
Field type	dimension
Data type	string.currency.code

AD FORM

adformName

Field label	Ad form name
Description	Name of ad form
Field type	dimension
Data type	string.text.value

adformId

Field label	Ad form ID
Description	ID of ad form
Field type	dimension
Data type	string.text.value

adformStatus

Field label	Ad form status
Description	Status of ad form
Field type	dimension
Data type	string.text.value

adformDescription

Field label	Ad form description
Description	Description of ad form
Field type	dimension
Data type	string.text.value

adformHeadline

Field label	Ad form headline
Description	Headline text of ad form
Field type	dimension
Data type	string.text.value

adformLandingPage

Field label	Ad form landing page
Description	Landing page URL of ad form
Field type	dimension
Data type	string.text.url

adformLegalDisclaimer

Field label	Ad form legal disclaimer
Description	Legal disclaimer text of ad form
Field type	dimension
Data type	string.text.value

adformPrivacyPolicy

Field label	Ad form privacy policy
Description	Privacy policy URL of ad form
Field type	dimension
Data type	string.text.url

adformQuestionName

Field label	Ad form question name
Description	Name of a question field from ad form
Field type	dimension
Data type	string.text.value

adformQuestionId

Field label	Ad form question ID
Description	ID of a question from ad form
Field type	dimension
Data type	string.text.value

adformQuestionPlaceholder

Field label	Ad form question placeholder
Description	Placeholder text of a question field from ad form
Field type	dimension
Data type	string.text.value

adformQuestionText

Field label	Ad form question text
Description	Question text of a question from ad form
Field type	dimension
Data type	string.text.value

adFormConsentText

Field label	Ad form consent text
Description	Question text of a question from ad form
Field type	dimension
Data type	string.text.value

adFormHiddenFieldName

Field label	Ad form hidden field name
Description	Name of a hidden field from ad form
Field type	dimension
Data type	string.text.value

adFormHiddenFieldValue

Field label	Ad form hidden field value
Description	Value of a hidden field from ad form
Field type	dimension
Data type	string.text.value

AD FORM RESPONSES

adFormResponseId

Field label	Ad form response ID
Description	ID of ad form response
Field type	dimension
Data type	string.text.value

adFormResponseTestLead

Field label	Ad form response test lead
Description	Test lead of ad form response
Field type	dimension
Data type	string.text.value

adFormResponseSubmittedAt

Field label	Ad form response submission time
Description	Submission time of ad form response
Field type	dimension
Data type	string.time.datetime

adFormResponseLeadType

Field label	Ad form response lead type
Description	Lead type of ad form response
Field type	dimension
Data type	string.text.value

adFormResponseAnswerText

Field label	Ad form response answer
Description	Answer of a question field from ad form
Field type	dimension
Data type	string.text.value

adFormConsentAnswer

Field label	Ad form consent answer
Description	Answer of a consent from ad form
Field type	dimension
Data type	string.text.value

CAMPAIGN

campaignName

Field label	Campaign name
Description	The name of the campaign
Field type	dimension
Data type	string.text.value

campaignId

Field label	Campaign ID
Description	Numerical identifier for the campaign
Field type	dimension
Data type	string.text.value

campaignCreated

Field label	Campaign created date
Description	Creation date of the campaign
Field type	dimension
Data type	string.time.date

campaignStatus

Field label	Campaign status
Description	Status of campaign
Field type	dimension
Data type	string.text.value

campaignType

Field label	Campaign type
Description	Type of campaign, e.g. TEXT_AD
Field type	dimension
Data type	string.text.value

campaignObjectiveType

Field label	Campaign objective type
Description	Objective type, if available can be used to provide better forecasts
Field type	dimension
Data type	string.text.value

campaignOptimizationTargetType

Field label	Campaign optimization target type
Description	Determines how this campaign is optimized for spending
Field type	dimension
Data type	string.text.value

campaignCostType

Field label	Campaign cost type
Description	Cost type, e.g. CPM
Field type	dimension
Data type	string.text.value

campaignDailyBudget

Field label	Campaign daily budget
Description	Maximum amount to spend per day
Field type	dimension
Data type	float.currency.value

campaignTotalBudget

Field label	Campaign total budget
Description	Maximum amount to spend over the life of the Campaign
Field type	dimension
Data type	float.currency.value

campaignUnitCost

Field label	Campaign unit cost
Description	Amount to bid per click, impression, or other event depending on the pricing model
Field type	dimension
Data type	float.currency.value

campaignStartDate

Field label	Campaign start date
Description	Start date of the campaign
Field type	dimension
Data type	string.time.date

campaignEndDate

Field label	Campaign end date
Description	End date of the campaign
Field type	dimension
Data type	string.time.date

CAMPAIGN GROUP

campaignGroupName

Field label	Campaign group name
Description	The name of the campaign group
Field type	dimension
Data type	string.text.value

campaignGroupId

Field label	Campaign group ID
Description	Numerical identifier for the campaign group
Field type	dimension
Data type	string.text.value

campaignGroupStatus

Field label	Campaign group status
Description	Status of the campaign group
Field type	dimension
Data type	string.text.value

campaignGroupTotalBudget

Field label	Campaign group total budget
Description	Maximum amount to spend across all associated campaigns and creatives for duration of the campaign group
Field type	dimension
Data type	float.currency.value

campaignGroupStartDate

Field label	Campaign group start date
Description	Represents the inclusive date when to start running the associated campaigns under this campaign group
Field type	dimension
Data type	string.time.date

campaignGroupEndDate

Field label	Campaign group end date
Description	Represents the inclusive date when to stop running the associated campaigns under this campaign group
Field type	dimension
Data type	string.time.date

CONVERSION

conversionId

Field label	Conversion ID
Description	Conversion ID
Field type	dimension
Data type	string.text.value

conversionName

Field label	Conversion name
Description	A short name for this rule, which will be shown in the UI and in reports
Field type	dimension
Data type	string.text.value

conversionType

Field label	Conversion type
Description	The type of the rule
Field type	dimension
Data type	string.text.value

conversionEnabled

Field label	Conversion enabled
Description	Is the conversion enabled
Field type	dimension
Data type	bool

conversionValueAmount

Field label	Conversion value
Description	The monetary value for this conversion
Field type	dimension
Data type	float.currency.value

conversionValueCurrency

Field label	Conversion currency
Description	Identifying code for currency type
Field type	dimension
Data type	string.currency.code

insightTagsDomainId

Field label	Insight tag domain ID
Description	Association between the website domain(s) and an advertiser account
Field type	dimension
Data type	string.text.value

insightTagsDomainName

Field label	Insight tag domain
Description	The domain name for the insight tag
Field type	dimension
Data type	string.text.value

CONVERSIONS

conversions

Field label	Conversions
Description	The count of conversions indicated by pixel loads
Field type	metric
Data type	int.number.value

postClickConversions

Field label	Post-click conversions
Description	The count of post-click conversions indicated by pixel loads
Field type	metric
Data type	int.number.value

viewThroughConversions

Field label	View-through conversions
Description	The count of view conversions indicated by pixel loads
Field type	metric
Data type	int.number.value

conversionRate

Field label	Conversion rate
Field type	metric
Data type	float.number.ratio

conversionCost

Field label	Cost per conversion
Field type	metric
Data type	float.currency.value

conversionValue

Field label	Total conversion value
Field type	metric
Data type	float.currency.value

returnOnSpend

Field label	Return on ad spend
Field type	metric
Data type	float.number.value

CREATIVE

creativeId

Field label	Creative ID
Description	Unique numerical identifier for the ad creative
Field type	dimension
Data type	string.text.value

creativeStatus

Field label	Creative status
Description	Status of the creative
Field type	dimension
Data type	string.text.value

creativeType

Field label	Creative type
Description	Type of the creative, e.g. TEXT_AD
Field type	dimension
Data type	string.text.value

creativeDscName

Field label	Creative Direct Sponsored Content name
Description	Indicate whether the creative is a direct sponsored content or not
Field type	dimension
Data type	string.text.value

creativeTitle

Field label	Creative title
Description	Title of the creative
Field type	dimension
Data type	string.text.value

creativeText

Field label	Creative text
Description	Body text of the creative
Field type	dimension
Data type	string.text.value

creativeUrl

Field label	Creative destination URL
Description	Destination URL of the creative
Field type	dimension
Data type	string.text.url

creativeThumbnailUrl

Field label	Creative thumbnail URL
Description	Thumbnail URL of the creative
Field type	dimension
Data type	string.text.url

creativeDownloadUrl

Field label	Creative download URL
Description	Download URL of the creative
Field type	dimension
Data type	string.text.url

creativeThumbnailImage

Field label	Creative thumbnail
Description	Thumbnail of the creative
Field type	dimension
Data type	string.text.formula
Destinations	Google Sheets

creativeReferenceType

Field label	Creative reference type
Field type	dimension
Data type	string.text.value

creativeReferenceId

Field label	Creative reference ID
Field type	dimension
Data type	string.text.value

creativeCardIndex

Field label	Carousel card index
Description	Creative ad carousel card position
Field type	dimension
Data type	string.text.value

utm_source

Field label	Source (utm)
Description	Value of the utm_source parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

utm_medium

Field label	Medium (utm)
Description	Value of the utm_medium parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

utm_campaign

Field label	Campaign (utm)
Description	Value of the utm_campaign parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

utm_content

Field label	Content (utm)
Description	Value of the utm_content parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

utm_term

Field label	Term (utm)
Description	Value of the utm_term parameter extracted from the ad destination URL
Field type	dimension
Data type	string.text.value

DATASOURCE

dataSourceName

Field label	Data source
Description	The name of the source for this data, as listed on supermetrics.com/docs
Field type	dimension
Data type	string.text.value
Destinations	API, Data warehouse

system_metadata.data_source_logins

Field label	Data source logins
Description	The data source login accounts that were used to authenticate against the data source
Field type	dimension
Data type	string.text.json

system_metadata.data_source_login_owners

Field label	Data source login owners
Description	The Supermetrics users that created the data source login connections
Field type	dimension
Data type	string.text.json

DEMOGRAPHICS

memberCompanySize

Field label	Member company size
Description	Approximate company size of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.text.value

memberIndustry

Field label	Member industry
Description	Industry of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.text.value

memberSeniority

Field label	Member seniority
Description	Seniority of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.text.value

memberJobTitle

Field label	Member job title
Description	Job titles of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.text.value

memberJobFunction

Field label	Member job function
Description	Job funnctions of of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.text.value

memberCountry

Field label	Member country
Description	Countries of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.geo.country

memberCountryCode

Field label	Member country code
Description	Country codes of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.geo.country.twolettercode

memberRegion

Field label	Member region
Description	Geographic regions of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.geo.region

memberCompanyName

Field label	Member company name
Description	Company names of of LinkedIn members engaged with campaigns
Field type	dimension
Data type	string.text.value

DEPRECATED

creativeAdPreviewUrl

Field label	Creative ad preview URL
Description	A 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.
Field type	dimension
Data type	string.text.url
🚫 Deprecated	Deprecated on 2023-02-21

accountTotalBudget

Field label	Account total budget
Field type	dimension
Data type	float.currency.value
🚫 Deprecated	Deprecated on 2020-10-30

adformVersionTag

Field label	Ad form version tag
Description	Version tag of ad form.
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2024-09-20

adformQuestionField

Field label	Ad form question field
Description	Field ID of a question from ad form.
Field type	dimension
Data type	string.text.value
🚫 Deprecated	Deprecated on 2024-09-20

approximateCostPerReachDaily

Field label	Cost per reach 1 day
Description	The average of spend (in the ad account currency) on your ads, divided by member accounts reached, multiplied by 1000. If the date range has more than one day, these metrics are the average for each day in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

approximateFrequency30Day

Field label	Frequency 30 day
Description	The average of impressions shown to each member account that received at least one impression over the last 30 days. If the date range has more than one day, these metrics are the average of multiple reach metrics for each previous 30 day interval in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

approximateCostPerReach30Day

Field label	Cost per reach 30 day
Description	The last 30 days of average of spend (in the ad account currency) on your ads, divided by member accounts reached, multiplied by 1000. If the date range has more than one day, these metrics are the average of multiple reach metrics for each previous 30 day interval in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

approximateFrequencyDaily

Field label	Frequency 1 day
Description	The average of impressions shown to each member account that received at least one impression. If the date range has more than one day, these metrics are the average for each day in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

approximateFrequency7Day

Field label	Frequency 7 day
Description	The average of impressions shown to each member account that received at least one impression over the last 7 days. If the date range has more than one day, these metrics are the average of multiple reach metrics for each previous 7 day interval in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

approximateReach30Day

Field label	Reach 30 day
Description	The average of unique member accounts with at least one impression over the last 30 days. If the date range has more than one day, these metrics are the average of multiple reach metrics for each previous 30 day interval in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

approximateReach7Day

Field label	Reach 7 day
Description	The average of unique member accounts with at least one impression over the last 7 days. If the date range has more than one day, these metrics are the average of multiple reach metrics for each previous 7 day interval in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

approximateReachDaily

Field label	Reach 1 day
Description	The daily reach or unique member accounts with at least one impression. If the date range has more than one day, these metrics are the average for each day in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

approximateCostPerReach7Day

Field label	Cost per reach 7 day
Description	The last 7 days of average of spend (in the ad account currency) on your ads, divided by member accounts reached, multiplied by 1000. If the date range has more than one day, these metrics are the average of multiple reach metrics for each previous 7 day interval in the date range. Only compatible with Campaign level data.
Field type	metric
Data type	float.number.value
🚫 Deprecated	Deprecated on 2022-10-31

DOWNLOADS

downloadClicks

Field label	Download clicks
Description	The number of times users have indicated the intent to download the media in an ad by clicking the download icon. This metric is only available for ad formats supporting media downloads
Field type	metric
Data type	int.number.value

viralDownloadClicks

Field label	Viral download clicks
Description	The number of times users have indicated the intent to download the media in a viral ad by clicking the download icon. Only available for ads supporting media downloads
Field type	metric
Data type	int.number.value

documentFirstQuartileCompletions

Field label	Document first quartile completions
Description	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
Field type	metric
Data type	int.number.value

documentMidpointCompletions

Field label	Document midpoint completions
Description	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
Field type	metric
Data type	int.number.value

documentThirdQuartileCompletions

Field label	Document third quartile completions
Description	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
Field type	metric
Data type	int.number.value

documentCompletions

Field label	Document completions
Description	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
Field type	metric
Data type	int.number.value

viralDocumentFirstQuartileCompletions

Field label	Viral document first quartile completions
Description	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
Field type	metric
Data type	int.number.value

viralDocumentMidpointCompletions

Field label	Viral document midpoint completions
Description	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
Field type	metric
Data type	int.number.value

viralDocumentThirdQuartileCompletions

Field label	Viral document third quartile completions
Description	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
Field type	metric
Data type	int.number.value

viralDocumentCompletions

Field label	Viral document completions
Description	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
Field type	metric
Data type	int.number.value

IMPRESSION DEVICE TYPE

impressionDeviceType

Field label	Impression device type
Description	Group results by the device type the ad made an impression on. Reach metrics and conversion metrics will not be available when this field is used
Field type	dimension
Data type	string.text.value

ONE CLICK LEAD GEN CAMPAIGNS

oneClickLeads

Field label	Leads
Description	The count of leads generated through One Click Lead Gen
Field type	metric
Data type	int.number.value

oneClickLeadFormOpens

Field label	Lead form opens
Description	The count of times users opened the lead form for a One Click Lead Gen campaign
Field type	metric
Data type	int.number.value

viralOneClickLeads

Field label	Viral leads
Description	The count of leads generated through One Click Lead Gen from viral impressions for this activity
Field type	metric
Data type	int.number.value

viralOneClickLeadFormOpens

Field label	Viral form opens
Description	The count of times users opened the lead form for viral impressions from a Lead Gen campaign
Field type	metric
Data type	int.number.value

oneClickLeadsCost

Field label	Cost per lead
Description	Cost per One Click Lead
Field type	metric
Data type	float.currency.value

leadFormCompletionRate

Field label	Lead form completion rate
Description	The lead form completion rate is the number of leads divided by the number of lead form opens
Field type	metric
Data type	float.number.ratio

PERFORMANCE

approximateUniqueImpressions

Field label	Reach
Description	The approximate reach of the campaign
Field type	metric
Data type	int.number.value

impressions

Field label	Impressions
Description	Count of 'impressions' for Direct Ads and Sponsored Updates and 'sends' for InMails
Field type	metric
Data type	int.number.value

clicks

Field label	Clicks
Description	Count of chargeable clicks
Field type	metric
Data type	int.number.value

ctr

Field label	CTR
Description	Click-through rate
Field type	metric
Data type	float.number.ratio

companyPageClicks

Field label	Company page clicks
Description	The count of clicks to view the company page
Field type	metric
Data type	int.number.value

landingPageClicks

Field label	Landing page clicks
Description	The count of clicks which take the user to the creative landing page
Field type	metric
Data type	int.number.value

otherEngagements

Field label	Other engagements
Description	The count of user interactions with the ad unit that do not fit into any other more specific category
Field type	metric
Data type	int.number.value

totalSocialActions

Field label	Total social actions
Description	Likes, comments, shares, follows and other engagements
Field type	metric
Data type	int.number.value

totalEngagements

Field label	Total engagements
Field type	metric
Data type	int.number.value

engagementRate

Field label	Engagement rate
Description	Total engagements divided by impressions
Field type	metric
Data type	float.number.percentage

cpc

Field label	CPC
Description	Cost per click
Field type	metric
Data type	float.currency.value

cpm

Field label	CPM
Description	Cost per 1000 impressions
Field type	metric
Data type	float.currency.value

spend

Field label	Total spent
Description	Campaign cost in the currency of the advertising account
Field type	metric
Data type	float.currency.value

spend_eur

Field label	Total spent (EUR)
Description	Campaign cost converted to euros
Field type	metric
Data type	float.currency.value

spend_gbp

Field label	Total spent (GBP)
Description	Campaign cost converted to British pounds
Field type	metric
Data type	float.currency.value

spend_usd

Field label	Total spent (USD)
Description	Campaign cost converted to US dollars
Field type	metric
Data type	float.currency.value

average_dwell_time

Field label	Average dwell time
Description	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
Field type	metric
Data type	int.number.value

audience_penetration

Field label	Audience penetration
Description	The approximate number of unique members reached by the advertiser divided by the approximate total target audience size. The field can't be selected with a date range more than 92 days. This metric only supports the Campaign report
Field type	metric
Data type	float.number.ratio

QUERY

system_metadata.query_date_range_start

Field label	Start date
Description	The start date of the requested query
Field type	dimension
Data type	string.time.date

system_metadata.query_date_range_end

Field label	End date
Description	The end date of the requested query
Field type	dimension
Data type	string.time.date

system_metadata.query_timezone

Field label	Timezone
Description	The timezone that is supplied to the query
Field type	dimension
Data type	string.time.timezone

system_metadata.query_filters

Field label	Filters
Description	All filters used in the query
Field type	dimension
Data type	string.text.json

system_metadata.query_date_start

Field label	Start
Description	When the query was started
Field type	dimension
Data type	string.time.datetime

system_metadata.query_date_end

Field label	End
Description	When the query completed
Field type	dimension
Data type	string.time.datetime

system_metadata.query_duration

Field label	Duration
Description	The duration in seconds of the query
Field type	dimension
Data type	int.duration.seconds

system_metadata.query_accounts

Field label	Accounts
Description	A list of accounts of which the data was pulled from
Field type	dimension
Data type	string.text.json

REVENUE ATTRIBUTION

rar_revenue_won

Field label	Revenue won
Description	Sales revenue in USD in customer's CRM that can be attributed to being generated through LinkedIn ads
Field type	metric
Data type	float.currency.value

rar_return_on_ad_spend

Field label	ROAS (Revenue attribution)
Description	Ratio of total revenue won attributed to LinkedIn marketing divided by LinkedIn ad spend. Calculated by: Revenue won / Total spent
Field type	metric
Data type	float.number.value

rar_closed_won_opportunities

Field label	Closed won opportunities
Description	Number of closed-won opportunities attributed to LinkedIn marketing
Field type	metric
Data type	int.number.value

rar_opportunity_amount

Field label	Opportunity amount
Description	Total revenue in USD of open opportunities (CRM deals in progress) attributed to LinkedIn marketing. This metric is available only when date range includes current day
Field type	metric
Data type	float.currency.value

rar_open_opportunities

Field label	Open opportunities
Description	Number of open opportunities (CRM deals in progress) attributed to LinkedIn marketing. This metric is available only when date range includes current day
Field type	metric
Data type	int.number.value

rar_opportunity_win_rate

Field label	Opportunity win rate
Description	Rate at which the opportunities are won out of all the closed opportunities. Calculated by: Closed won opportunities / Number of closed opportunities
Field type	metric
Data type	float.number.ratio

rar_average_deal_size

Field label	Average deal size
Description	Of closed-won opportunities, what is the average size of the deals Linkedin is driving. Calculated by: Revenue won / Closed won opportunities
Field type	metric
Data type	float.currency.value

rar_average_days_to_close

Field label	Average days to close
Description	The average number of days to close a won deal attributed to LinkedIn marketing. Calculated by: Opportunity length in days / Closed won opportunities
Field type	metric
Data type	float.number.value

SERVING LOCATION

servingLocation

Field label	Serving location
Description	Breaks down the data based on if it was shown On LinkedIn or in the Audience Network
Field type	dimension
Data type	string.text.value

SOCIAL ACTIONS

likes

Field label	Likes
Description	The count of likes. Sponsored Updates only
Field type	metric
Data type	int.number.value

comments

Field label	Comments
Description	The count of comments. Sponsored Updates only
Field type	metric
Data type	int.number.value

Field label	Shares
Description	The count of shares. Sponsored Updates only
Field type	metric
Data type	int.number.value

reactions

Field label	Reactions
Description	The count of positive reactions on Sponsored Updates which can capture, like, interest, praise, and other responses
Field type	metric
Data type	int.number.value

follows

Field label	Follows
Description	The count of follows. Sponsored Updates only
Field type	metric
Data type	int.number.value

viralClicks

Field label	Viral clicks
Description	The count of clicks on viral impressions. Sponsored Updates only
Field type	metric
Data type	int.number.value

viralImpressions

Field label	Viral impressions
Description	Viral 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
Field type	metric
Data type	int.number.value

viralLikes

Field label	Viral likes
Description	The count of likes from viral impressions. Sponsored Updates only
Field type	metric
Data type	int.number.value

viralComments

Field label	Viral comments
Description	The count of comments from viral impressions. Sponsored Updates only
Field type	metric
Data type	int.number.value

viralShares

Field label	Viral shares
Description	The count of shares from viral impressions. Sponsored Updates only
Field type	metric
Data type	int.number.value

viralFollows

Field label	Viral follows
Description	The count of follows from viral impressions. Sponsored Updates only
Field type	metric
Data type	int.number.value

viralCompanyPageClicks

Field label	Viral company page clicks
Description	The count of clicks to view the company page from viral impressions. Sponsored Updates only
Field type	metric
Data type	int.number.value

viralLandingPageClicks

Field label	Viral landing page clicks
Description	The count of viral impressions to take the user to the creative landing page. Sponsored Updates only
Field type	metric
Data type	int.number.value

viralOtherEngagements

Field label	Viral other engagements
Field type	metric
Data type	int.number.value

viralTotalEngagements

Field label	Viral total engagements
Field type	metric
Data type	int.number.value

viralExternalWebsiteConversions

Field label	Viral external website conversions
Description	The count of conversions indicated by pixel loads on an external advertiser website driven by a viral event
Field type	metric
Data type	int.number.value

viralExternalWebsitePostClickConversions

Field label	Viral external website post click conversion
Description	The count of post-click conversions indicated by pixel loads on an external advertiser website driven by a viral click
Field type	metric
Data type	int.number.value

viralExternalWebsitePostViewConversions

Field label	Viral external website post view conversions
Description	The count of post-view conversions indicated by pixel loads on an external advertiser website driven by a viral impression
Field type	metric
Data type	int.number.value

viralFullScreenPlays

Field label	Viral full screen plays
Description	The count of taps on the video, going into video view mode
Field type	metric
Data type	int.number.value

viralReactions

Field label	Viral reactions
Description	The count of positive reactions on viral Sponsored Updates which can capture like, interest, praise, and other responses
Field type	metric
Data type	int.number.value

TIME

today

Field label	Today
Description	Today's date, e.g. 2017-01-31
Field type	dimension
Data type	string.time.date
Destinations	API, Data warehouse

year

Field label	Year
Description	Year, e.g. 2017
Field type	dimension
Data type	string.time.year

yearOfWeek

Field label	Year of week (Sun-Sat)
Description	Year of week for US-style Sunday-Saturday weeks, e.g. 2017
Field type	dimension
Data type	string.time.year

yearOfWeekIso

Field label	Year of week (Mon-Sun)
Description	Year of week for ISO standard Monday-Sunday weeks, e.g. 2017
Field type	dimension
Data type	string.time.year

yearMonth

Field label	Year & month
Description	Year and month, e.g. 2017\|06
Field type	dimension
Data type	string.time.yearmonth

month

Field label	Month
Description	Month, e.g. 6
Field type	dimension
Data type	string.time.month

yearWeek

Field label	Year & week (Sun-Sat)
Description	Year and week for US-style Sunday-Saturday weeks, e.g. 2017\|08
Field type	dimension
Data type	string.time.yearweek

yearWeekIso

Field label	Year & week (Mon-Sun)
Description	Year and week for ISO standard Monday-Sunday weeks, e.g. 2017\|08
Field type	dimension
Data type	string.time.yearweekiso

week

Field label	Week (Sun-Sat)
Description	US week number, e.g. 51
Field type	dimension
Data type	string.time.week

weekIso

Field label	Week (Mon-Sun)
Description	ISO week number, e.g. 51
Field type	dimension
Data type	string.time.weekiso

dayOfMonth

Field label	Day of month
Description	Day of month, e.g. 2
Field type	dimension
Data type	string.time.dayofmonth

dayOfWeekName

Field label	Day of week (Sun-Sat)
Description	Day of week number & name for US-style Sunday-Saturday weeks, e.g. 0 Sunday
Field type	dimension
Data type	string.time.dayofweek

dayOfWeekNameIso

Field label	Day of week (Mon-Sun)
Description	Day of week number & name for ISO standard Monday to Sunday weeks, e.g. 1 Sunday
Field type	dimension
Data type	string.time.dayofweekiso

date

Field label	Date
Description	Date, e.g. 2017-01-31
Field type	dimension
Data type	string.time.date

VIDEO

videoFirstQuartileCompletions

Field label	Video views at 25%
Description	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
Field type	metric
Data type	int.number.value

videoMidpointCompletions

Field label	Video views at 50%
Description	The 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
Field type	metric
Data type	int.number.value

videoThirdQuartileCompletions

Field label	Video views at 75%
Description	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
Field type	metric
Data type	int.number.value

videoViews

Field label	Video views
Description	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
Field type	metric
Data type	int.number.value

videoCompletions

Field label	Video completions
Description	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
Field type	metric
Data type	int.number.value

viralVideoStarts

Field label	Viral video starts
Description	The count of viral video ads that were started by users
Field type	metric
Data type	int.number.value

viralVideoCompletions

Field label	Viral video completions
Description	The count of viral video ads that played 97-100% of the video. This includes watches that skipped to this point
Field type	metric
Data type	int.number.value

viralVideoFirstQuartileCompletions

Field label	Viral video views at 25%
Description	The count of viral video ads that played through the first quartile of the video. This includes watches that skipped to this point
Field type	metric
Data type	int.number.value

viralVideoMidpointCompletions

Field label	Viral video views at 50%
Description	The count of viral video ads that played through the midpoint of the video. This includes watches that skipped to this point
Field type	metric
Data type	int.number.value

viralVideoThirdQuartileCompletions

Field label	Viral video views at 75%
Description	The count of viral video ads that played through the third quartile of the video. This includes watches that skipped to this point
Field type	metric
Data type	int.number.value

fullScreenPlays

Field label	Full screen plays
Description	Number of times members click on the full screen button or on the video(mobile only) to go into full screen mode
Field type	metric
Data type	int.number.value

videoStarts

Field label	Video starts
Description	The count of video ads that were started by users
Field type	metric
Data type	int.number.value

viralVideoViews

Field label	Viral video views
Description	A viral video ad playing for at least 2 continuous seconds 50% in-view, or a click on the CTA, whichever comes first
Field type	metric
Data type	int.number.value