LinkedIn Ads Connector Reference

87 metrics146 dimensions

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

The LinkedIn Ads connector exposes 233 fields (87 metrics, 146 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


Available actions


Enable Campaign Group Enable a paused LinkedIn Ads campaign group. Reversible via pause_campaign_group.

Enable a paused LinkedIn Ads campaign group. Reversible via pause_campaign_group.

Parameters
campaign_group_idstringRequired
Pause Campaign Group Pause an active LinkedIn Ads campaign group. Reversible via enable_campaign_group.

Pause an active LinkedIn Ads campaign group. Reversible via enable_campaign_group.

Parameters
campaign_group_idstringRequired
Enable Campaign Enable a paused LinkedIn Ads campaign. Reversible via pause_campaign.

Enable a paused LinkedIn Ads campaign. Reversible via pause_campaign.

Parameters
campaign_idstringRequired
Pause Campaign Pause an active LinkedIn Ads campaign. Reversible via enable_campaign.

Pause an active LinkedIn Ads campaign. Reversible via enable_campaign.

Parameters
campaign_idstringRequired
Enable Creative Enable a paused LinkedIn Ads creative. Reversible via pause_creative.

Enable a paused LinkedIn Ads creative. Reversible via pause_creative.

Parameters
creative_idstringRequired
Pause Creative Pause an active LinkedIn Ads creative. Reversible via enable_creative.

Pause an active LinkedIn Ads creative. Reversible via enable_creative.

Parameters
creative_idstringRequired
Set Campaign Group Budget Set the total budget of a LinkedIn Ads campaign group. The amount is in the account currency major unit (e.g. 100.00 means one hundred); the currency is resolved automatically from the account. The campaign group must have a schedule end date for a total budget to apply.

Set the total budget of a LinkedIn Ads campaign group. The amount is in the account currency major unit (e.g. 100.00 means one hundred); the currency is resolved automatically from the account. The campaign group must have a schedule end date for a total budget to apply.

Parameters
campaign_group_idstringRequiredamountstringRequired
Set Campaign Budget Set the daily or total budget of a LinkedIn Ads campaign. The amount is in the account currency major unit (e.g. 100.00 means one hundred); the currency is resolved automatically from the account. A total budget requires the campaign to have a schedule end date.

Set the daily or total budget of a LinkedIn Ads campaign. The amount is in the account currency major unit (e.g. 100.00 means one hundred); the currency is resolved automatically from the account. A total budget requires the campaign to have a schedule end date.

Parameters
campaign_idstringRequiredbudget_typestringRequiredamountstringRequired

LinkedIn Ads Fields

LinkedIn Ads Account fields

The Account report of the LinkedIn Ads connector includes 5 fields.

IDTypeNameDescription
account_idTEXTAccount IDAdvertisement account ID
account_nameTEXTAccount NameA label for the account.
account_typeTEXTAccount typeAccount type
accountidTEXTAccount ID (Duplicate)Advertisement account ID (Duplicate)
currencyTEXTCurrencyAccount currency (default="USD")

LinkedIn Ads Campaign fields

The Campaign report of the LinkedIn Ads connector includes 38 fields.

IDTypeNameDescription
campaignTEXTCampaign (Ad Set in LinkedIn UI)The campaign name. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_accountTEXTCampaign AccountAccount where the campaign is running. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_cost_typeTEXTCampaign Cost TypeCost type of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_daily_budget_amountTEXTCampaign Daily Budget AmountDaily budget amount of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_end_dateDATECampaign End DateEnd date of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_idTEXTCampaign ID (Ad Set ID in LinkedIn UI)The campaign ID. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_start_dateDATECampaign Start DateStart date of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_statusTEXTCampaign Status (Ad Set Status in LinkedIn UI)Status of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_total_budget_amountTEXTCampaign Total Budget AmountTotal budget amount of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
campaign_typeTEXTCampaign TypeType of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
conversionsNUMERICShare conversionsNumber of External Website Conversions after Post View
cost_in_usdNUMERICShare cost in USDCampaign Cost in USD
landing_page_clicksNUMERICShare landing page clicksNumber of Clicks to the Landing Page
objective_typeTEXTObjective TypeCampaign Objective type values.
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
reactionsNUMERICShare reactionsNumber of Reactions by Campaign
targeting_exclude_agerangesOBJECTTargeting Exclude Age RangeA segment of members who will be excluded from the advertising campaign's targeting by organization.
targeting_exclude_employersOBJECTTargeting Exclude EmployersA segment of members who will be excluded from the advertising campaign's targeting by age rate.
targeting_exclude_groupsOBJECTTargeting Exclude GroupsA segment of members who will be excluded from the advertising campaign's targeting by groups.
targeting_exclude_industriesOBJECTTargeting Exclude IndustriesA segment of members who will be excluded from the advertising campaign's targeting by standardized industries.
targeting_exclude_interfacelocalesOBJECTTargeting Exclude Interface LocalesA segment of members who will be excluded from the advertising campaign's targeting by interface locales.
targeting_exclude_jobfunctionsOBJECTTargeting Exclude Job FunctionsA segment of members who will be excluded from the advertising campaign's targeting by standardized job functions.
targeting_exclude_locationsOBJECTTargeting Exclude LocationsA segment of members who will be excluded from the advertising campaign's targeting by locations.
targeting_exclude_senioritiesOBJECTTargeting Exclude SenioritiesA segment of members who will be excluded from the advertising campaign's targeting by standardized seniorities.
targeting_exclude_titlesOBJECTTargeting Exclude TitlesA segment of members who will be excluded from the advertising campaign's targeting by standardized titles.
targeting_include_agerangesOBJECTTargeting Include Age RangeA segment of members who will be included in the advertising campaign's targeting by organization.
targeting_include_employersOBJECTTargeting Include EmployersA segment of members who will be included in the advertising campaign's targeting by age rate.
targeting_include_groupsOBJECTTargeting Include GroupsA segment of members who will be included in the advertising campaign's targeting by groups.
targeting_include_industriesOBJECTTargeting Include IndustriesA segment of members who will be included in the advertising campaign's targeting by standardized industries.
targeting_include_interfacelocalesOBJECTTargeting Include Interface LocalesA segment of members who will be included in the advertising campaign's targeting by interface locales.
targeting_include_jobfunctionsOBJECTTargeting Include Job FunctionsA segment of members who will be included in the advertising campaign's targeting by standardized job functions.
targeting_include_locationsOBJECTTargeting Include LocationsA segment of members who will be included in the advertising campaign's targeting by locations.
targeting_include_senioritiesOBJECTTargeting Include SenioritiesA segment of members who will be included in the advertising campaign's targeting by standardized seniorities.
targeting_include_titlesOBJECTTargeting Include TitlesA segment of members who will be included in the advertising campaign's targeting by standardized titles.
total_engagementsNUMERICShare total engagementsNumber of total Engagements
viral_conversionsNUMERICViral External Website ConversionsThe count of conversions indicated by pixel loads on an external advertiser website driven by a viral event.
viral_landing_page_clicksNUMERICShare viral landing page clicksNumber of Viral Clicks to the Landing Page

LinkedIn Ads Campaign Group fields

The Campaign Group report of the LinkedIn Ads connector includes 7 fields.

IDTypeNameDescription
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 groups in the LinkedIn API correspond to 'Campaigns' in the LinkedIn Campaign Manager UI.
campaign_group_idTEXTCampaign Group ID (Campaign ID in LinkedIn UI)Numerical identifier for the campaign group. This is a read-only field set by the system. Campaign groups in the LinkedIn API correspond to 'Campaigns' in the LinkedIn Campaign Manager UI.
campaign_group_nameTEXTCampaign Group Name (Campaign Name in LinkedIn UI)The 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 groups in the LinkedIn API correspond to 'Campaigns' in the LinkedIn Campaign Manager UI.
campaign_group_run_scedule_end_timeTIMESTAMPCampaign Group Run Schedule 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 groups in the LinkedIn API correspond to 'Campaigns' in the LinkedIn Campaign Manager UI.
campaign_group_run_scedule_start_timeTIMESTAMPCampaign Group Run Schedule 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 groups in the LinkedIn API correspond to 'Campaigns' in the LinkedIn Campaign Manager UI.
campaign_group_statusTEXTCampaign Group Status (Campaign Status in LinkedIn UI)Status of the campaign group. Campaign groups in the LinkedIn API correspond to 'Campaigns' in the LinkedIn Campaign Manager UI.
campaign_group_total_budgetNUMERICCampaign Group Total BudgetMaximum amount to spend across all associated campaigns and creatives for duration of the campaign group. Campaign groups in the LinkedIn API correspond to 'Campaigns' in the LinkedIn Campaign Manager UI.

LinkedIn Ads Conversion fields

The Conversion report of the LinkedIn Ads connector includes 12 fields.

IDTypeNameDescription
conversion_attribution_typeTEXTConversion Attribution TypeThe model that describes how conversion actions are to be counted. Acceptable values are: LAST_TOUCH_BY_CAMPAIGN and LAST_TOUCH_BY_CONVERSION
conversion_createdDATEConversion Created DateConversion Created Date
conversion_enabledBOOLEANConversion EnabledSet to true or false to enable or disable this rule from matching on the advertiser’s website. The initial state can be either, but only rules that are enabled will trigger conversion events.
conversion_idTEXTConversion IDConversion ID
conversion_last_callback_atDATEConversion Last Callback At DateThe last time one or more of the URL match rules fired and called back to the server.
conversion_last_modifiedDATEConversion Last Modified DateA date corresponding to the last modification of this resource.
conversion_nameTEXTConversion NameA short name for this conversion.
conversion_ownership_typeTEXTConversion Ownership TypeOwnership of the conversion rule. Always OWNED today: the connector only fetches conversion rules owned by the ad account, not rules shared with it from another ad account in the same Business Manager.
conversion_pivotTEXTConversion PivotGroup results by conversion.
conversion_post_click_attribution_window_sizeTEXTConversion Post Click Attribution Window SizeSpecifies a user's settings on the post click attribution window in days.
conversion_typeTEXTConversion TypeThe type of the conversion.
conversion_view_through_attribution_window_sizeTEXTConversion View Through Attribution Window SizeSpecifies a user's settings on the view through (post view) attribution window in days.

LinkedIn Ads Creative fields

The Creative report of the LinkedIn Ads connector includes 23 fields.

IDTypeNameDescription
ad_nameTEXT(Deprecated) Ad NameDeprecated field. Alias for sponsored_creative_content_title. Probably you are looking for 'Creative Ad Context DSC Name' (creative_content_data_share_ad_context_dsc_name)
ad_post_urlTEXTAd Post URLURL that opens the sponsored post directly in LinkedIn. Populated for creatives that reference a share/UGC post.
creative_content_data_share_ad_context_ad_typeTEXTCreative Ad Context DSC Ad TypeThe type of DSC (e.g. VIDEO, STANDARD, CAROUSEL, etc.)
creative_content_data_share_ad_context_dsc_nameTEXTCreative Ad Context DSC NamePlain text name of the DSC post.
creative_content_data_share_ad_context_dsc_statusTEXTCreative Ad Context DSC StatusThe status of the advertising company content. Representing whether the content is usable from the advertiser's perspective as a DSC
creative_creation_datetimeTIMESTAMPCreative Creation DatetimeCreative Creation Date and Time
creative_form_idTEXTCreative Lead Form IDNumerical ID of the lead form linked to the creative. Present on the creative, independent of any lead submission.
creative_idTEXTCreative IDCreative ID
creative_is_servingBOOLEANCreative Is ServingTrue when the creative is currently serving.
creative_last_modified_datetimeTIMESTAMPCreative Last Modified DatetimeCreative Last Modified Date and Time
creative_review_statusTEXTCreative Review StatusAd review status of the creative. Values: PENDING, APPROVED, REJECTED, NEEDS_REVIEW. Empty while the creative is a draft.
creative_serving_hold_reasonsTEXTCreative Serving Hold ReasonsReasons the creative is not serving, comma-separated (for example UNDER_REVIEW, REJECTED, FORM_HOLD). Empty when the creative serves.
creative_statusTEXTCreative StatusCreative Status
creative_thumbnailIMAGE_URLCreative thumbnailCreative thumbnail
landing_pageTEXTLanding PageLanding Page
share_creation_datetimeTIMESTAMPShare creation datetimePost Creation Date and Time
share_idTEXTShare IDShare (Post) ID
share_landing_pageTEXTShare landing pagePost landing page
share_last_modified_datetimeTIMESTAMPShare last modified datetimePost Last Modification Date and Time
share_textTEXTShare textPost Text
share_titleTEXTShare titlePost Title
share_typeTEXTShare TypeShare/post media category
video_asset_urlTEXTVideo Asset URLDownload URL of the video asset for video ad creatives, from the LinkedIn Videos API. The URL is signed and time-limited, so it is fetched fresh on each request and never cached.

LinkedIn Ads Form fields

The Form report of the LinkedIn Ads connector includes 25 fields.

IDTypeNameDescription
ad_form_descriptionTEXTForm DescriptionDescription of the form, visible to both the owner and the viewer.
ad_form_headlineTEXTForm HeadlineHeadline of the form, visible to both the owner and the viewer.
TEXTForm Legal DisclaimerOwner's legal disclaimer to accompany this form. Optional since the owner may alternatively use other fields (e.g. legalDisclaimer, consents) to surface the privacy policy.
TEXTForm Legal Info IDUnique identifier of the LeadGenFormLegalInfo.
ad_form_nameTEXTForm NameName of the Lead Form provided by the owner..
ad_form_post_review_last_updatedDATEForm Review Last UpdatedThe date indicating when the review status is initiated/last updated.
ad_form_post_review_last_updated_datetimeTIMESTAMPForm Review Last Updated DatetimeThe date and time indicating when the review status is initiated/last updated.
ad_form_post_review_rejection_reasonsTEXTForm Review Reject ReasonAn array of rejection reasons for the Lead Form. It's Non-empty if the review status is REJECTED in the latest review.
ad_form_post_review_statusTEXTForm Review StatusIndicate the state of review for the Lead Form. PENDING - The form is pending review and not serving. APPROVED - The form is approved for serving. REJECTED - The form is rejected. PREAPPROVED - form has been pre-approved, it's ready for serving but still need further review. AUTO_APPROVED - The form has been auto approved by content model. NEEDS_REVIEW - The form has been rejected by content model or policy checker or returned by fallback case that auto approval didn't make any decision. AUTO_REJECTED - The form has been auto rejected by content model.
ad_form_post_submission_info_cta_labelTEXTForm Post Submission Call To Action LabelLabel for the call to action shown to the viewer. Default is VISIT_COMPANY_WEBSITE
ad_form_post_submission_info_cta_targetTEXTForm Post Submission Call To Action TargetTarget where the user is taken after clicking on the CTA. E.g. a LandingPageUrl which is a url redirect to a web page. It can be empty for CTA's which don't require additional information.
ad_form_post_submission_info_messageTEXTForm Post Submission MessageThe message displayed to a member after the Lead Form is submitted.
ad_form_privacy_policy_urlTEXTForm Privacy Policy URLThe URL of the privacy policy that covers any data passed to the owner of the form. Optional since it is not required to be present for all the use cases.
ad_form_statusTEXTForm StatusDRAFT, PUBLISHED, ARCHIVED. Draft - The form is still being edited. Published - The form is published, i.e. it has gone through processing (e.g. manual review) and is ready to be used. Archived - The form is archived.
ad_form_thank_you_messageTEXTForm Post Submission Message (Duplicate)The message displayed to a member after the Lead Form is submitted.
ad_form_thank_you_page_call_to_actionTEXTForm Post Submission Call To Action Label (Duplicate)Label for the call to action shown to the viewer. Default is VISIT_COMPANY_WEBSITE
form_created_datetimeDATEForm Created DateDate and time corresponding to the creation of the form.
form_creation_locale_countryCOUNTRYForm Creation Locale CountryA lowercase two-letter language code as defined by ISO-639-1
form_creation_locale_languageTEXTForm Creation Locale LanguageAn uppercase two-letter country code as defined by ISO-3166
form_idTEXTForm IDNumerical identifier for the form.
form_last_modified_datetimeDATEForm Last Modified DateDate and time corresponding to the last modified date of the form.
form_owner_idTEXTForm Owner IDID that identifies the owner of the Lead Form.
form_version_idTEXTForm Version IDThe version ID of the form. This is a derived field and is generated on the server side.
form_version_tagTEXTForm Version TagThe number of times the form has been modified.
hidden_fieldsOBJECTForm Hidden FieldsHidden fields used by the owner to track key attributes of the form that generated the lead. The field is empty if the owner chooses to not append any tracking attributes to the Lead Form.

LinkedIn Ads Form Response fields

The Form Response report of the LinkedIn Ads connector includes 14 fields.

IDTypeNameDescription
answersTEXTForm Response AnswersAll answers on form response
form_campaign_idTEXTForm Response Campaign IDCampaign id that this form response is connected. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
form_campaign_nameTEXTForm Response Campaign NameCampaign name that this form response is connected. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
form_campaign_typeTEXTForm Response Campaign TypeCampaign type that this form response is connected. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI.
form_creative_idTEXTForm Response Creative IDForm creative id
form_owner_account_nameTEXTForm Response Owner Account Info NameName of the owner of the Lead Form Response.
form_response_associated_creative_statusTEXTForm Response Associated Creative StatusStatus of creative, associated with this Form Response
TEXTForm Response Consent ResponsesAll Consent Response answers on this Form Response
form_response_idTEXTForm Response idID of a Form response
form_response_owner_idTEXTForm Response Owner IDID that identifies the owner of the Lead Form Response.
form_submitterTEXT(Deprecated) Form Response Submitter(Deprecated) ID that identifies the person who submitted the Lead Form Response.
lead_typeTEXTForm Response Lead typeType of the lead representing the origination of the lead.
submitted_atDATEForm Response submitted at timeForm response submitted time f: YYYY-MM-DD
test_leadBOOLEANForm Response Is Test LeadTrue/False is this test lead form response

LinkedIn Ads Job fields

The Job report of the LinkedIn Ads connector includes 3 fields.

IDTypeNameDescription
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
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).

LinkedIn Ads Performance fields

The Performance report of the LinkedIn Ads connector includes 25 fields.

IDTypeNameDescription
appointmentsscheduledNUMERICAppointments ScheduledThe count of appointments booked through Lead Gen campaigns.
approximate_unique_impressionsNUMERICApproximate Unique Impressions(reach)The approximate reach of the campaign. The number of unique member accounts with at least one impression. Can be requested for date ranges with a maximum range of 92 days. The expected delay for current UTC day will be 24-48 hours. Requests which include today in the date range will only return reach for days where data exists.
audience_penetrationPERCENTAudience PenetrationThe approximate number of unique members reached by the advertiser divided by the approximate total target audience size. The field will be null if the date range has more than 92 days. This metric only supports the CAMPAIGN pivot.
average_dwell_timeNUMERICAverage Dwell TimeThis measures the average time (in seconds) that users spend viewing the ad when at least 50% of the pixels are present on the screen.
average_frequencyPERCENTAverage frequencyAverage number of impressions seen by each member account exposed to at least one impression
clicksNUMERICClicksThe count of clicks.
commentsNUMERICCommentsNumber of Comments
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.
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)
ctrPERCENTCTRClick-through rate (CTR)
engagement_ratePERCENTEngagement 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.
impressionsNUMERICImpressionsThis is the count of "impressions" for Direct Ads and Sponsored Updates and "sends" for InMails.
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.
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 and Sponsored Messaging ads.only.
sendsNUMERICSendsThe count of sends of Sponsored Messaging ads.
sharesNUMERICSharesThis is the count of "shares" for sponsored Shares.
spendNUMERICSpendCost in the account's local currency
totalcostNUMERICTotal CostCost in the account's local currency (Duplicate of Spend)
transactionrevenueNUMERICTransaction Revenue (Local Currency)Conversion Value (Duplicate of Conversion Value (Local Currency))

LinkedIn Ads Social Actions fields

The Social Actions report of the LinkedIn Ads connector includes 12 fields.

IDTypeNameDescription
company_page_clicksNUMERICCompany Page ClicksThe count of clicks to view the company page.
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.
download_clicksNUMERICDownload ClicksThe count of times users clicked the download icon to save the ad media. Only available for ad formats supporting media downloads.
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
transactionsNUMERICTransactionsThe number of transactions (Duplicate of External Website Conversions)
viral_company_page_clicksNUMERICViral Company Page ClicksThe count of clicks to view the company page from viral impressions for this activity. Sponsored Content only.

LinkedIn Ads Sponsored Creative fields

The Sponsored Creative report of the LinkedIn Ads connector includes 3 fields.

IDTypeNameDescription
TEXTCreative CommentarySponsored creative (ad) commentary
TEXTCreative DescriptionSponsored creative (ad) description
TEXTCreative Titlecreative (ad) title

LinkedIn Ads Video fields

The Video report of the LinkedIn Ads connector includes 13 fields.

IDTypeNameDescription
average_video_watch_timeNUMERICAverage Video Watch TimeAverage video watch time in milliseconds, as reported by LinkedIn. Note: this metric may be delayed by up to 48 hours and is not reported for professional demographic (member) breakdowns.
completionsNUMERICCompletionsThe count of video ads that played 97-100% of the video.
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.
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 plays (duplicate)The 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.
video_watch_timeNUMERICVideo Watch TimeThe total watch time in milliseconds for a video ad. This metric is populated if a user's watching behavior is qualified for the video views metric. Note: this metric may be delayed by up to 48 hours and is not reported for professional demographic (member) breakdowns.

LinkedIn Ads Viral fields

The Viral report of the LinkedIn Ads connector includes 19 fields.

IDTypeNameDescription
viral_clicksNUMERICShare viral clicksNumber of Viral Clicks Aggregated by Campaign
viral_commentsNUMERICShare viral commentsNumber of Viral Comments by Campaign
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_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.

LinkedIn Ads other fields

The LinkedIn Ads connector has 33 fields that do not belong to a named report, or belong to a report with only one or two fields.

IDTypeNameDescriptionReport
adnetwork_conversionsNUMERICAd Network ConversionsThe Ad Network Reported ConversionsAd Network
adnetwork_revenueNUMERICAd Network RevenueThe Ad Network Reported RevenueAd Network
country_codeCOUNTRYCountry CodeList of country codes of target locationsCountry
data_fetched_atTIMESTAMPData fetched atUTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed.
datasourceTEXTData SourceThe name of the Windsor connector returning the row
dateDATEDateDates covered by the report data point. Date is specified in UTC.Time
day_of_monthTEXTDay of monthDay of the month
impression_device_typeTEXTImpression device typeGroup results by the device type the ad made an impression on. Reach metrics and conversion metrics will not be available when this pivot is used.Impression Device Type
member_company_nameTEXTMember company nameCompany names of LinkedIn members engaged with campaigns. Groups metrics by audience companies, cannot be combined with any other aggregation fields.Member Company Name
member_company_sizeTEXTMember company sizeApproximate company size of LinkedIn members engaged with campaigns. Groups metrics by audience company sizes, cannot be combined with any other aggregation fields.Member Company Size
member_countryCOUNTRYMember countryCountries of LinkedIn members engaged with campaigns. Groups metrics by audience countries, cannot be combined with any other aggregation fields.Country
member_industryTEXTMember industryIndustry of LinkedIn members engaged with campaigns. Groups metrics by audience industries, cannot be combined with any other aggregation fields.Member Industry
member_job_functionTEXTMember job functionJob functions of LinkedIn members engaged with campaigns. Groups metrics by audience job functions, cannot be combined with any other aggregation fields.Member Function
member_job_titleTEXTMember job titleJob titles of LinkedIn members engaged with campaigns. Groups metrics by audience job titles, cannot be combined with any other aggregation fields.Demographics
member_regionREGIONMember regionGeographic regions of LinkedIn members engaged with campaigns. Groups metrics by audience regions, cannot be combined with any other aggregation fields.Region
member_seniorityTEXTMember senioritySeniority of LinkedIn members engaged with campaigns. Groups metrics by audience seniorities, cannot be combined with any other aggregation fields.Member Seniority
monthTEXTMonthNumber of the month
nowTIMESTAMPNowCurrent timestamp
placement_nameTEXTPlacement NameGroup results by placement.Placement
serving_locationTEXTService LocationGroup results by serving location, onsite or offsite.Serving Location
sourceTEXTSourceThe name of the Windsor connector returning the row
todayDATETodayToday's date
weekTEXTWeekWeek (Sun-Sat).
week_dayTEXTDay of week and day numberWeekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_isoTEXTDay of week and day number, ISOWeekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_isoTEXTWeek ISOWeek, ISO format (Mon-Sun).
yearTEXTYearYear
year_monthTEXTYearmonthYear and month, e.g. 2024|3
year_month_nameTEXTYear month nameYear and month with the month name written out, e.g. "Jan 2025".
year_of_weekTEXTYear of weekThe year that contains first day of the week (Sun-Sat).
year_of_week_isoTEXTYear of week, ISOThe year that contains first day of the ISO week (Mon-Sun).
year_weekTEXTYear weekYear and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_isoTEXTYear week ISOYear and week for ISO weeks (Mon-Sun), e.g. 2024|20