The table below gives information about all the data fields that you can import from LinkedIn.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs. As a result, the fields shown here may not be the same as the fields available in Adverity. If you notice a difference between this documentation and the fields you see in Adverity, please contact your Adverity account manager for more information.
To see the fields you can collect from another data source, go back to the Available fields in Adverity overview.
|
Field UI name |
Field API name |
Description |
Use in Adverity |
Docs |
|---|---|---|---|---|
|
|
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 |
Seniorities to be targeted. |
dimension |
|
|
|
account.changeAuditStamps.created.time |
Audit change stamps including creation timestamp and last updated timestamp |
dimension |
|
|
|
account.changeAuditStamps.lastModified.actor |
Audit change stamps including creation timestamp and last updated timestamp |
dimension |
|
|
|
account.changeAuditStamps.lastModified.time |
Audit change stamps including creation timestamp and last updated timestamp |
dimension |
|
|
|
account.currency |
The ISO 4217 currency code of the account- such as 'USD' for United States dollar |
dimension |
|
|
|
account.id |
Id of the account |
dimension |
|
|
|
account.name |
A label for the account |
dimension |
|
|
|
account.notifiedOnCampaignOptimization |
Indicates if campaign contact is notified about campaign optimization opportunities. |
dimension |
|
|
|
account.notifiedOnCreativeApproval |
Indicates if creative contact is notified when a creative has been reviewed and approved. |
dimension |
|
|
|
account.notifiedOnCreativeRejection |
Indicates if creative contact is notified when a creative has been rejected due to content. |
dimension |
|
|
|
account.notifiedOnEndOfCampaign |
Indicates if campaign contact is notified when an associated campaign has been completed. |
dimension |
|
|
|
account.reference |
The entity on whose behalf the account advertises. |
dimension |
|
|
|
account.servingStatuses |
Serving status of the account |
dimension |
|
|
|
account.status |
Status of the account |
dimension |
|
|
|
account.type |
The type of account. |
dimension |
|
|
|
account.version.versionTag |
The version tag |
dimension |
|
|
|
actionClicks |
The count of clicks on the action button of the Sponsored InMail. Sponsored InMail only. |
metric |
|
|
|
adUnitClicks |
The count of clicks on the ad unit displayed alongside the Sponsored InMail. Sponsored InMail only. |
metric |
|
|
|
campaign.account |
URN identifying the advertising account associated with the Campaign. This value is immutable once set |
dimension |
|
|
|
campaign.associatedEntity |
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 |
Enable Audience Expansion for the campaign provides query expansion for certain targeting criteria |
dimension |
|
|
|
campaign.changeAuditStamps.created.time |
Audit change stamps including creation timestamp and last updated timestamp |
dimension |
|
|
|
campaign.changeAuditStamps.lastModified.time |
For ex: [ |
dimension |
|
|
|
campaign.costType |
CPM - Cost per thousand advertising impressions - CPC - Cost per individual click on the associated link |
dimension |
|
|
|
campaign.creativeSelection |
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 |
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 |
Maximum amount to spend per day. The currency must match that of the parent account. ISO currency code |
metric |
|
|
|
campaign.id |
Id of the campaign |
dimension |
|
|
|
campaign.locale.country |
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 |
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 |
The name of the Campaign; primarily used to make it easier to reference a Campaign and to recall its purpose |
dimension |
|
|
|
campaign.objectiveType |
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 |
Allow this campaign access to be served on the LinkedIn Advertising Network. Default value is |
dimension |
|
|
|
campaign.offsitePreferences.iabCategories.exclude |
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 |
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 |
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 |
Serving status of the campaign |
dimension |
|
|
|
campaign.status |
Status of the campaign |
dimension |
|
|
|
campaign.targeting.excludedTargetingFacets.audienceMatchingSegments |
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 |
Specific companies to match against member's current employer. |
dimension |
|
|
|
campaign.targeting.excludedTargetingFacets.followedCompanies |
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 |
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 |
For ex: [ |
dimension |
|
|
|
campaign.targeting.excludedTargetingFacets.seniorities |
Seniorities to be targeted. |
dimension |
|
|
|
campaign.targeting.excludedTargetingFacets.staffCountRanges |
The version tag of the campaign record |
dimension |
|
|
|
campaign.targeting.excludedTargetingFacets.titles |
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 |
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 |
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 |
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 |
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 |
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 |
Interface locales to be targeted. Currently limited to one locale. |
dimension |
|
|
|
campaign.targeting.includedTargetingFacets.jobFunctions |
Top level groupings of supertitles to be targeted. |
dimension |
|
|
|
campaign.targeting.includedTargetingFacets.locations |
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 |
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 |
For ex: [ |
dimension |
|
|
|
campaign.targeting.includedTargetingFacets.seniorities |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Maximum amount to spend over the life of the Campaign. The currency must match that of the Account. ISO currency code |
metric |
|
|
|
campaign.type |
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 |
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 |
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 |
The resource defining the membership of the associated segment |
dimension |
|
|
|
campaign.version.versionTag |
The version tag of the campaign record |
dimension |
|
|
|
cardClicks |
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 |
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 |
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 |
Clicks |
metric |
|
|
|
commentLikes |
The count of likes of a comment. Sponsored Updates only. |
metric |
|
|
|
comments |
The count of comments. Sponsored Updates only. |
metric |
|
|
|
comments |
Comments |
metric |
|
|
|
company.id |
ID of the Company |
dimension |
|
|
|
company.name |
Company Name |
dimension |
|
|
|
companyPageClicks |
The count of clicks to view the company page. |
metric |
|
|
|
conversionValueInLocalCurrency |
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 |
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 |
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 |
dimension |
|
|
|
endDate |
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 |
Engagements |
metric |
|
|
|
externalWebsiteConversions |
The count of conversions indicated by pixel loads on an external advertiser website. |
metric |
|
|
|
externalWebsitePostClickConversions |
The count of post-click conversions indicated by pixel loads on an external advertiser website. |
metric |
|
|
|
externalWebsitePostViewConversions |
The count of post-view conversions indicated by pixel loads on an external advertiser website. |
metric |
|
|
|
follows |
The count of follows. Sponsored Updates only. |
metric |
|
|
|
fullScreenPlays |
The count of taps on the video- going into video view mode. |
metric |
|
|
|
impressionCount |
Number of Impressions |
metric |
|
|
|
impressions |
This is the count of |
metric |
|
|
|
impressions |
Impressions |
metric |
|
|
|
landingPageClicks |
The count of clicks which take the user to the creative landing page. |
metric |
|
|
|
leadGenerationMailContactInfoShares |
The number of times users shared contact info through the One Click Lead Gen for Sponsored InMail. Sponsored InMail only. |
metric |
|
|
|
leadGenerationMailInterestedClicks |
The count of InMail recipients who clicked to demonstrate interest. Sponsored InMail only. |
metric |
|
|
|
likes |
The count of likes. Sponsored Updates only. |
metric |
|
|
|
likes |
Number of Likes |
metric |
|
|
|
member_country.$URN |
Standardized country URN |
dimension |
|
|
|
member_country.countryCode |
The country code. |
dimension |
|
|
|
member_country.countryGroup |
The country group URN that this country belongs to. |
dimension |
|
|
|
member_country.name.locale.country |
Country name in various locales. Represented as LocaleString type. |
dimension |
|
|
|
member_country.name.locale.language |
A lowercase two-letter language code as defined by ISO-639 |
dimension |
|
|
|
member_country.name.value |
An uppercase two-letter country code as defined by ISO-3166. |
dimension |
|
|
|
oneClickLeadFormOpens |
The count of times users opened the lead form for a One Click Lead Gen campaign. |
metric |
|
|
|
oneClickLeads |
The count of leads generated through One Click Lead Gen. |
metric |
|
|
|
opens |
The count of opens of Sponsored InMail. Sponsored InMail only. |
metric |
|
|
|
organicFollowerCount |
Organic Follower Count |
metric |
|
|
|
otherEngagements |
The count of user interactions with the ad unit that do not fit into any other more specific category. |
metric |
|
|
|
paidFollowerCount |
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 |
Array ofShare URN |
metric |
|
|
|
shares |
Number of Shares |
metric |
|
|
|
startDate |
Represents the inclusive start time range of the analytics. If unset- it indicates an open range up to the end time. |
dimension |
|
|
|
textUrlClicks |
The count of clicks on any links (anchor tags) that were included in the body of the Sponsored InMail. Sponsored InMail only. |
metric |
|
|
|
totalEngagements |
The count of all user interactions with the ad unit. |
metric |
|
|
|
totalFollowerCount |
Total Followers |
metric |
|
|
|
urn |
URN |
dimension |
|
|
|
videoCompletions |
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 |
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 |
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 |
The count of video ads that were started by users. |
metric |
|
|
|
videoThirdQuartileCompletions |
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 |
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 |
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 |
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 |
The count of clicks on viral impressions. See viral impressions definition. Sponsored Updates only. |
metric |
|
|
|
viralComments |
The count of comments from viral impressions for this activity. See viral impressions definition. Sponsored Updates only. |
metric |
|
|
|
viralCompanyPageClicks |
The count of clicks to view the company page from viral impressions for this activity. See viral impressions definition. Sponsored Updates only. |
metric |
|
|
|
viralExternalWebsiteConversions |
The count of conversions indicated by pixel loads on an external advertiser website driven by a viral event. See viral impressions definition. |
metric |
|
|
|
viralExternalWebsitePostClickConversions |
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 |
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 |
The count of follows from viral impressions for this activity. See viral impressions definition. Sponsored Updates only. |
metric |
|
|
|
viralFullScreenPlays |
The count of taps on the video- going into video view mode. See viralImpressions definition. |
metric |
|
|
|
viralImpressions |
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 |
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 |
The count of likes from viral impressions for this activity. See viral impressions definition. Sponsored Updates only. |
metric |
|
|
|
viralOneClickLeadFormOpens |
The count of times users opened the lead form for viral impressions from a Lead Gen campaign. See viral impressions definition. |
metric |
|
|
|
viralOneClickLeads |
The count of leads generated through One Click Lead Gen from viral impressions for this activity. See viral impressions definition. |
metric |
|
|
|
viralOtherEngagements |
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 |
The count of shares from viral impressions for this activity. See viral impressions definition. Sponsored Updates only. |
metric |
|
|
|
viralTotalEngagements |
The count of all user interactions with a viral ad unit. See viral impressions definition. Sponsored Updates only. |
metric |
|
|
|
viralVideoCompletions |
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 |
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 |
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 |
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 |
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 |
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 |
|