LinkedIn Ads Field Reference

Sample

 

https://connectors.windsor.ai/linkedin?api_key=[your API key]&date_preset=last_7d&fields=campaign,clicks,spend,impressions,date,source&_renderer=csv


Fields

IDTypeNameDescriptionReport
account_idTEXTAccount IDAdvertisement account ID
account_nameTEXTAccount NameA label for the account.
account_typeTEXTAccount typeAccount type
accountidTEXTAccount ID (Duplicate)Advertisement account ID (Duplicate)
ad_nameTEXTAd NameThe ad nameCREATIVE
adnetwork_conversionsNUMERICAd Network ConversionsThe Ad Network Reported Conversions
adnetwork_revenueNUMERICAd Network RevenueThe Ad Network Reported Revenue
approximate_unique_impressionsNUMERICApproximate Unique ImpressionsThe approximate reach of the campaign. The number of unique member accounts with at least one impression.
average_frequencyNUMERICAverage frequencyAverage number of impressions seen by each member account exposed to at least one impression
campaignTEXTCampaignThe campaign nameCAMPAIGN
campaign_accountTEXTCampaign AccountAccount where campaign is runningCAMPAIGN
campaign_cost_typeTEXTCampaign Cost TypeCampaign cost typeCAMPAIGN
campaign_daily_budget_amountTEXTCampaign daily budget amountDaily Budget Amount
campaign_end_dateDATECampaign end dateCampaign End DateCAMPAIGN
campaign_group_backfilledBOOLEANCampaign Group BackfilledFlag that denotes whether the campaign group was created organically or to backfill existing campaigns. This is a read-only field set by the system.CAMPAIGN_GROUP
campaign_group_idNUMERICCampaign Group IDTumerical identifier for the campaign group. This is a read-only field set by the system.CAMPAIGN_GROUP
campaign_group_nameTEXTCampaign Group NameThe name of the campaign group used to make it easier to reference a campaign group and recall its purpose. The value of this field cannot exceed 100 characters.CAMPAIGN_GROUP
campaign_group_run_scedule_end_timeDATECampaign Group Run Scedule End TimeRepresents the exclusive (strictly less than) date when to stop running the associated campaigns under this campaign group. If this field is unset, it indicates an open range with no end date. This field is required if totalBudget is set.CAMPAIGN_GROUP
campaign_group_run_scedule_start_timeDATECampaign Group Run Scedule Start TimeRepresents the inclusive (greater than or equal to) date when to start running the associated campaigns under this campaign group. This field is required.CAMPAIGN_GROUP
campaign_group_statusTEXTCampaign Group StatusStatus of campaign group.CAMPAIGN_GROUP
campaign_group_total_budgetNUMERICCampaign Group Total BudgetMaximum amount to spend across all associated campaigns and creatives for duration of the campaign group.CAMPAIGN_GROUP
campaign_idTEXTCampaign IDThe campaign IDCAMPAIGN
campaign_start_dateDATECampaign Start DateCampaign Start DateCAMPAIGN
campaign_statusTEXTCampaign Group StatusStatus of campaign group.CAMPAIGN
campaign_total_budget_amountTEXTCampaign total budget amountTotal Budget AmountCAMPAIGN
campaign_typeTEXTCampaign TypeCampaign typeCAMPAIGN
clicksNUMERICClicksThe count of clicks.
commentsNUMERICCommentsNumber of Comments
completionsNUMERICCompletionsThe count of video ads that played 97-100% of the video.
conversionsNUMERICShare conversionsNumber of External Website Conversions after Post View
conversionvalueinlocalcurrencyNUMERICConversion Value (Local 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.
cost_in_usdNUMERICShare cost in USDCampaign Cost in USD
cost_per_externalwebsiteconversionsNUMERICCost Per External Website ConversionsCost in the account's local currency divided by the count of conversions indicated by pixel loads on an external advertiser website.
cost_per_externalwebsitepostclickconversionsNUMERICCost Per External Website Post Click ConversionsCost in the account's local currency divided by the count of post-click conversions indicated by pixel loads.on an external advertiser website.
cost_per_externalwebsitepostviewconversionsNUMERICCost Per External Website Post View ConversionsCost in the account's local currency divided by the count of post-view conversions indicated by pixel loads on an external advertiser website.
cost_per_job_applicationNUMERICCost Per Job ApplicationCost in the account's local currency divided by the number of times a member completed a job application
country_codeTEXTCountry CodeList of target locations
cpcNUMERICCPCCost-per-click (CPC)
cpmNUMERICCPMCost per mille (CPM).It is the cost an advertiser pays for one thousand views or impressions of an advertisement (1000 * cost / impressions)
creative_creation_datetimeDATECreative Creation DatetimeCreative Creation Date and TimeCREATIVE
creative_idTEXTCreative IDCreative IDCREATIVE
creative_last_modified_datetimeDATECreative Last Modified DatetimeCreative Last Modified Date and TimeCREATIVE
creative_statusTEXTCreative StatusCreative StatusCREATIVE
ctrPERCENTCTRClick-through rate (CTR)
currencyTEXTCurrencyAccount currency (default="USD")
dateDATEDateDates covered by the report data point. Date is specified in UTC.
engagement_rateNUMERICEngagement RateNumber of times members interacted with your ad (paid and free clicks divided by total impressions)
engagementsNUMERICEngagementsThe total number of actions that people took on your Linkedin Ads.
externalwebsiteconversionsNUMERICExternal Website ConversionsThe count of conversions indicated by pixel loads on an external advertiser website.
externalwebsitepostclickconversionsNUMERICExternal Website Post Click ConversionsThe count of post-click conversions indicated by pixel loads on an external advertiser website.
externalwebsitepostviewconversionsNUMERICExternal Website Post View ConversionsThe count of post-view conversions indicated by pixel loads on an external advertiser website.
followsNUMERICFollowsThe count of follows. Sponsored Updates only.
full_screen_playsNUMERICShare full screen playsNumber of Full Screen Plays
impressionsNUMERICImpressionsThis is the count of "impressions" for Direct Ads and Sponsored Updates and "sends" for InMails.
job_applicationsNUMERICJob ApplicationsThe number of times a member completed a job applicationafter viewing or clicking on an ad. Currently, this metric is broken down into postViewJobApplications (if the member applied after viewing the ad) and postClickJobApplications (if the member applied after clicking the ad).
job_apply_clicksNUMERICJob Apply ClicksThe number of times a member clicked on the job’s apply button on an LinkedIn jobs page after viewing or clicking on an ad which has a LinkedIn job landing page. Currently, this metric is broken down into postViewJobApplyClicks (if the member performed the action after viewing the ad) and postClickJobApplyClicks (if the member performed the action after clicking the ad).
landing_page_clicksNUMERICShare landing page clicksNumber of Clicks to the Landing Page
landingpageclicksNUMERICLanding Page ClicksThe count of clicks which take the user to the creative landing page.
leadgenerationmailcontactinfosharesNUMERICLead Generation Mail Contact Info SharesThe number of times users shared contact info through the One Click Lead Gen for Sponsored InMail. Sponsored InMail only.
likesNUMERICLikesThe count of likes. Sponsored Updates only.
member_company_nameTEXTMember company nameCompany names of LinkedIn members engaged with campaignsMEMBER_COMPANY
member_company_sizeTEXTMember company sizeApproximate company size of LinkedIn members engaged with campaignsMEMBER_COMPANY_SIZE
member_countryTEXTMember countryCountries of LinkedIn members engaged with campaignsMEMBER_COUNTRY_V2
member_industryTEXTMember industryIndustry of LinkedIn members engaged with campaignsMEMBER_INDUSTRY
member_job_functionTEXTMember job functionJob functions of LinkedIn members engaged with campaignsMEMBER_JOB_FUNCTION
member_job_titleTEXTMember job titleJob titles of LinkedIn members engaged with campaignsMEMBER_JOB_TITLE
member_regionTEXTMember regionGeographic regions of LinkedIn members engaged with campaignsMEMBER_REGION_V2
member_seniorityTEXTMember senioritySeniority of LinkedIn members engaged with campaignsMEMBER_SENIORITY
objective_typeTEXTObjective TypeCampaign Objective type values.
oneclickleadformopensNUMERICOne Click Lead Form OpensThe count of times users opened the lead form for a One Click Lead Gen campaign.
oneclickleadsNUMERICOne Click LeadsThe count of leads generated through One Click Lead Gen.
opensNUMERICOpensThe count of opens of Sponsored InMail. Sponsored InMail only.
optimization_target_typeTEXTOptimization Target TypeDetermines how this campaign is optimized for spending. If this is not set, there is no optimization.
other_engagementsNUMERICShare other engagementsNumber of Other Engagements
quartile_1NUMERICVideo watches at 25%The count of video ads that played through the first quartile of the video.
quartile_2NUMERICVideo watches at 50%The count of video ads that played through the midpoint of the video.
quartile_3NUMERICVideo watches at 75%The count of video ads that played through the third quartile of the video.
reactionsNUMERICShare reactionsNumber of Reactions by Campaign
share_creation_datetimeDATEShare creation datetimePost Creation Date and TimeCREATIVE
share_idTEXTShare IDShare (Post) IDCREATIVE
share_landing_pageTEXTShare landing pagePost landing pageCREATIVE
share_last_modified_datetimeDATEShare last modified datetimePost Last Modification Date and TimeCREATIVE
share_textTEXTShare textPost TextCREATIVE
share_titleTEXTShare titlePost TitleCREATIVE
share_typeTEXTShare TypeShare/post media categoryCREATIVE
sharesNUMERICSharesThis is the count of "shares" for sponsored Shares.
spendNUMERICSpendCost in the account's local currency
targeting_exclude_agerangesOBJECTTargeting Exclude Age RangeA segment of members who will be excluded from the advertising campaign's targeting by organization.CAMPAIGN
targeting_exclude_employersOBJECTTargeting Exclude EmployersA segment of members who will be excluded from the advertising campaign's targeting by age rate.CAMPAIGN
targeting_exclude_groupsOBJECTTargeting Exclude GroupsA segment of members who will be excluded from the advertising campaign's targeting by groups.CAMPAIGN
targeting_exclude_industriesOBJECTTargeting Exclude IndustriesA segment of members who will be excluded from the advertising campaign's targeting by standardized industries.CAMPAIGN
targeting_exclude_interfacelocalesOBJECTTargeting Exclude Interface LocalesA segment of members who will be excluded from the advertising campaign's targeting by interface locales.CAMPAIGN
targeting_exclude_jobfunctionsOBJECTTargeting Exclude Job FunctionsA segment of members who will be excluded from the advertising campaign's targeting by standardized job functions.CAMPAIGN
targeting_exclude_locationsOBJECTTargeting Exclude LocationsA segment of members who will be excluded from the advertising campaign's targeting by locations.CAMPAIGN
targeting_exclude_senioritiesOBJECTTargeting Exclude SenioritiesA segment of members who will be excluded from the advertising campaign's targeting by standardized seniorities.CAMPAIGN
targeting_exclude_titlesOBJECTTargeting Exclude TitlesA segment of members who will be excluded from the advertising campaign's targeting by standardized titles.CAMPAIGN
targeting_include_agerangesOBJECTTargeting Include Age RangeA segment of members who will be included in the advertising campaign's targeting by organization.CAMPAIGN
targeting_include_employersOBJECTTargeting Include EmployersA segment of members who will be included in the advertising campaign's targeting by age rate.CAMPAIGN
targeting_include_groupsOBJECTTargeting Include GroupsA segment of members who will be included in the advertising campaign's targeting by groups.CAMPAIGN
targeting_include_industriesOBJECTTargeting Include IndustriesA segment of members who will be included in the advertising campaign's targeting by standardized industries.CAMPAIGN
targeting_include_interfacelocalesOBJECTTargeting Include Interface LocalesA segment of members who will be included in the advertising campaign's targeting by interface locales.CAMPAIGN
targeting_include_jobfunctionsOBJECTTargeting Include Job FunctionsA segment of members who will be included in the advertising campaign's targeting by standardized job functions.CAMPAIGN
targeting_include_locationsOBJECTTargeting Include LocationsA segment of members who will be included in the advertising campaign's targeting by locations.CAMPAIGN
targeting_include_senioritiesOBJECTTargeting Include SenioritiesA segment of members who will be included in the advertising campaign's targeting by standardized seniorities.CAMPAIGN
targeting_include_titlesOBJECTTargeting Include TitlesA segment of members who will be included in the advertising campaign's targeting by standardized titles.CAMPAIGN
total_engagementsNUMERICShare total engagementsNumber of total Engagements
totalcostNUMERICTotal CostCost in the account's local currency (Duplicate of Spend)
transactionrevenueNUMERICTransaction Revenue (Local Currency)Conversion Value (Duplicate of Conversion Value (Local Currency))
transactionsNUMERICTransactionsThe number of transactions (Duplicate of External Website Conversions)
video_completionsNUMERICVideo CompletionsThe count of video ads that played 97-100% of the video.
video_startNUMERICVideo playsThe number of times a video starts to play
video_startsNUMERICVideo playsThe number of times a video starts to play
video_viewed_25pcntNUMERICVideo watches at 25% (Duplicate)The count of video ads that played through the first quartile of the video. (Duplicate)
video_viewed_50pcntNUMERICVideo watches at 50% (Duplicate)The count of video ads that played through the midpoint of the video. (Duplicate)
video_viewed_75pcntNUMERICVideo watches at 75% (Duplicate)The count of video ads that played through the third quartile of the video. (Duplicate)
video_viewsNUMERICVideo views2 or more continuous seconds of playback while the video is at least 50% on screen, or a click on the CTA, whichever comes first.
viral_clicksNUMERICShare viral clicksNumber of Viral Clicks Aggregated by Campaign
viral_commentsNUMERICShare viral commentsNumber of Viral Comments by Campaign
viral_conversionsNUMERICViral External Website ConversionsThe count of conversions indicated by pixel loads on an external advertiser website driven by a viral event.
viral_followsNUMERICShare viral followsNumber of Viral Follows by Campaign
viral_full_screen_playsNUMERICShare viral full screen playsNumber of Viral Full Screen Plays
viral_impressionsNUMERICShare viral impressoinsNumber of Viral Impressions Aggregated by Campaign
viral_landing_page_clicksNUMERICShare viral landing page clicksNumber of Viral Clicks to the Landing Page
viral_likesNUMERICShare viral likesNumber of Viral Likes by Campaign
viral_reactionsNUMERICShare viral reactionsNumber of Viral Reactoins by Campaign
viral_sharesNUMERICShare viral sharesNumber of Viral Shares by Share
viral_total_engagementsNUMERICShare viral total engagementsViral Total Engagements
viral_video_completionsNUMERICShare viral video completionsNumber of Viral Video Views to 100%
viral_video_startsNUMERICShare viral video startsNumber of Viral Video Starts
viral_video_viewed_25pcntNUMERICShare viral video viewed 25pcntNumber of Viral Video Views to 25%
viral_video_viewed_50pcntNUMERICShare viral video viewed 50pcntNumber of Viral Video Views to 50%
viral_video_viewed_75pcntNUMERICShare viral video viewed 75pcntNumber of Viral Video Views to 75%
viral_video_viewsNUMERICShare viral video viewsNumber of Viral Video Views
viralexternalwebsiteconversionsNUMERICViral External Website Conversions (Duplicate)The count of conversions indicated by pixel loads on an external advertiser website driven by a viral event.
viralexternalwebsitepostclickconversionsNUMERICViral External Website Post Click ConversionsThe count of post-click conversions indicated by pixel loads on an external advertiser website driven by a viral click.
viralexternalwebsitepostviewconversionsNUMERICViral External Website Post View ConversionsThe count of post-view conversions indicated by pixel loads on an external advertiser website driven by a viral impression.
viraloneclickleadsNUMERICViral One Click LeadsThe count of leads generated through One Click Lead Gen from viral impressions for this activity.