LinkedIn Ads Connector Reference
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.
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.
Enable Campaign Enable a paused LinkedIn Ads campaign. Reversible via pause_campaign.
Enable a paused LinkedIn Ads campaign. Reversible via pause_campaign.
Pause Campaign Pause an active LinkedIn Ads campaign. Reversible via enable_campaign.
Pause an active LinkedIn Ads campaign. Reversible via enable_campaign.
Enable Creative Enable a paused LinkedIn Ads creative. Reversible via pause_creative.
Enable a paused LinkedIn Ads creative. Reversible via pause_creative.
Pause Creative Pause an active LinkedIn Ads creative. Reversible via enable_creative.
Pause an active LinkedIn Ads creative. Reversible via enable_creative.
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.
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.
LinkedIn Ads Fields
LinkedIn Ads Account fields
The Account report of the LinkedIn Ads connector includes 5 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| account_id | TEXT | Account ID | Advertisement account ID |
| account_name | TEXT | Account Name | A label for the account. |
| account_type | TEXT | Account type | Account type |
| accountid | TEXT | Account ID (Duplicate) | Advertisement account ID (Duplicate) |
| currency | TEXT | Currency | Account currency (default="USD") |
LinkedIn Ads Campaign fields
The Campaign report of the LinkedIn Ads connector includes 38 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| campaign | TEXT | Campaign (Ad Set in LinkedIn UI) | The campaign name. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| campaign_account | TEXT | Campaign Account | Account where the campaign is running. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| campaign_cost_type | TEXT | Campaign Cost Type | Cost type of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| campaign_daily_budget_amount | TEXT | Campaign Daily Budget Amount | Daily budget amount of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| campaign_end_date | DATE | Campaign End Date | End date of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| campaign_id | TEXT | Campaign 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_date | DATE | Campaign Start Date | Start date of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| campaign_status | TEXT | Campaign 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_amount | TEXT | Campaign Total Budget Amount | Total budget amount of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| campaign_type | TEXT | Campaign Type | Type of the campaign. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| conversions | NUMERIC | Share conversions | Number of External Website Conversions after Post View |
| cost_in_usd | NUMERIC | Share cost in USD | Campaign Cost in USD |
| landing_page_clicks | NUMERIC | Share landing page clicks | Number of Clicks to the Landing Page |
| objective_type | TEXT | Objective Type | Campaign Objective type values. |
| optimization_target_type | TEXT | Optimization Target Type | Determines how this campaign is optimized for spending. If this is not set, there is no optimization. |
| other_engagements | NUMERIC | Share other engagements | Number of Other Engagements |
| reactions | NUMERIC | Share reactions | Number of Reactions by Campaign |
| targeting_exclude_ageranges | OBJECT | Targeting Exclude Age Range | A segment of members who will be excluded from the advertising campaign's targeting by organization. |
| targeting_exclude_employers | OBJECT | Targeting Exclude Employers | A segment of members who will be excluded from the advertising campaign's targeting by age rate. |
| targeting_exclude_groups | OBJECT | Targeting Exclude Groups | A segment of members who will be excluded from the advertising campaign's targeting by groups. |
| targeting_exclude_industries | OBJECT | Targeting Exclude Industries | A segment of members who will be excluded from the advertising campaign's targeting by standardized industries. |
| targeting_exclude_interfacelocales | OBJECT | Targeting Exclude Interface Locales | A segment of members who will be excluded from the advertising campaign's targeting by interface locales. |
| targeting_exclude_jobfunctions | OBJECT | Targeting Exclude Job Functions | A segment of members who will be excluded from the advertising campaign's targeting by standardized job functions. |
| targeting_exclude_locations | OBJECT | Targeting Exclude Locations | A segment of members who will be excluded from the advertising campaign's targeting by locations. |
| targeting_exclude_seniorities | OBJECT | Targeting Exclude Seniorities | A segment of members who will be excluded from the advertising campaign's targeting by standardized seniorities. |
| targeting_exclude_titles | OBJECT | Targeting Exclude Titles | A segment of members who will be excluded from the advertising campaign's targeting by standardized titles. |
| targeting_include_ageranges | OBJECT | Targeting Include Age Range | A segment of members who will be included in the advertising campaign's targeting by organization. |
| targeting_include_employers | OBJECT | Targeting Include Employers | A segment of members who will be included in the advertising campaign's targeting by age rate. |
| targeting_include_groups | OBJECT | Targeting Include Groups | A segment of members who will be included in the advertising campaign's targeting by groups. |
| targeting_include_industries | OBJECT | Targeting Include Industries | A segment of members who will be included in the advertising campaign's targeting by standardized industries. |
| targeting_include_interfacelocales | OBJECT | Targeting Include Interface Locales | A segment of members who will be included in the advertising campaign's targeting by interface locales. |
| targeting_include_jobfunctions | OBJECT | Targeting Include Job Functions | A segment of members who will be included in the advertising campaign's targeting by standardized job functions. |
| targeting_include_locations | OBJECT | Targeting Include Locations | A segment of members who will be included in the advertising campaign's targeting by locations. |
| targeting_include_seniorities | OBJECT | Targeting Include Seniorities | A segment of members who will be included in the advertising campaign's targeting by standardized seniorities. |
| targeting_include_titles | OBJECT | Targeting Include Titles | A segment of members who will be included in the advertising campaign's targeting by standardized titles. |
| total_engagements | NUMERIC | Share total engagements | Number of total Engagements |
| viral_conversions | NUMERIC | Viral External Website Conversions | The count of conversions indicated by pixel loads on an external advertiser website driven by a viral event. |
| viral_landing_page_clicks | NUMERIC | Share viral landing page clicks | Number of Viral Clicks to the Landing Page |
LinkedIn Ads Campaign Group fields
The Campaign Group report of the LinkedIn Ads connector includes 7 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| campaign_group_backfilled | BOOLEAN | Campaign Group Backfilled | Flag 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_id | TEXT | Campaign 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_name | TEXT | Campaign 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_time | Campaign Group Run Schedule End Time | Represents 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_time | Campaign Group Run Schedule Start Time | Represents 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_status | TEXT | Campaign 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_budget | NUMERIC | Campaign Group Total Budget | Maximum 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 Carousel Ad fields
The Carousel Ad report of the LinkedIn Ads connector includes 5 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| card_clicks | NUMERIC | Card Clicks | The number of clicks for each card of a carousel ad. |
| card_clicks_viral | NUMERIC | Card Clicks (Viral) | The number of viralClicks for each card of a carousel ad. |
| card_impressions | NUMERIC | Card Impressions | The number of impressions for each card of a carousel ad. |
| card_impressions_viral | NUMERIC | Card Impressions (Viral) | The number of viralImpressions for each card of a carousel ad. |
| card_index | TEXT | Card Index | Group results by conversion. |
LinkedIn Ads Conversion fields
The Conversion report of the LinkedIn Ads connector includes 12 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| conversion_attribution_type | TEXT | Conversion Attribution Type | The model that describes how conversion actions are to be counted. Acceptable values are: LAST_TOUCH_BY_CAMPAIGN and LAST_TOUCH_BY_CONVERSION |
| conversion_created | DATE | Conversion Created Date | Conversion Created Date |
| conversion_enabled | BOOLEAN | Conversion Enabled | Set 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_id | TEXT | Conversion ID | Conversion ID |
| conversion_last_callback_at | DATE | Conversion Last Callback At Date | The last time one or more of the URL match rules fired and called back to the server. |
| conversion_last_modified | DATE | Conversion Last Modified Date | A date corresponding to the last modification of this resource. |
| conversion_name | TEXT | Conversion Name | A short name for this conversion. |
| conversion_ownership_type | TEXT | Conversion Ownership Type | Ownership 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_pivot | TEXT | Conversion Pivot | Group results by conversion. |
| conversion_post_click_attribution_window_size | TEXT | Conversion Post Click Attribution Window Size | Specifies a user's settings on the post click attribution window in days. |
| conversion_type | TEXT | Conversion Type | The type of the conversion. |
| conversion_view_through_attribution_window_size | TEXT | Conversion View Through Attribution Window Size | Specifies 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.
| ID | Type | Name | Description |
|---|---|---|---|
| ad_name | TEXT | (Deprecated) Ad Name | Deprecated 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_url | TEXT | Ad Post URL | URL that opens the sponsored post directly in LinkedIn. Populated for creatives that reference a share/UGC post. |
| creative_content_data_share_ad_context_ad_type | TEXT | Creative Ad Context DSC Ad Type | The type of DSC (e.g. VIDEO, STANDARD, CAROUSEL, etc.) |
| creative_content_data_share_ad_context_dsc_name | TEXT | Creative Ad Context DSC Name | Plain text name of the DSC post. |
| creative_content_data_share_ad_context_dsc_status | TEXT | Creative Ad Context DSC Status | The status of the advertising company content. Representing whether the content is usable from the advertiser's perspective as a DSC |
| creative_creation_datetime | Creative Creation Datetime | Creative Creation Date and Time | |
| creative_form_id | TEXT | Creative Lead Form ID | Numerical ID of the lead form linked to the creative. Present on the creative, independent of any lead submission. |
| creative_id | TEXT | Creative ID | Creative ID |
| creative_is_serving | BOOLEAN | Creative Is Serving | True when the creative is currently serving. |
| creative_last_modified_datetime | Creative Last Modified Datetime | Creative Last Modified Date and Time | |
| creative_review_status | TEXT | Creative Review Status | Ad review status of the creative. Values: PENDING, APPROVED, REJECTED, NEEDS_REVIEW. Empty while the creative is a draft. |
| creative_serving_hold_reasons | TEXT | Creative Serving Hold Reasons | Reasons the creative is not serving, comma-separated (for example UNDER_REVIEW, REJECTED, FORM_HOLD). Empty when the creative serves. |
| creative_status | TEXT | Creative Status | Creative Status |
| creative_thumbnail | IMAGE_URL | Creative thumbnail | Creative thumbnail |
| landing_page | TEXT | Landing Page | Landing Page |
| share_creation_datetime | Share creation datetime | Post Creation Date and Time | |
| share_id | TEXT | Share ID | Share (Post) ID |
| share_landing_page | TEXT | Share landing page | Post landing page |
| share_last_modified_datetime | Share last modified datetime | Post Last Modification Date and Time | |
| share_text | TEXT | Share text | Post Text |
| share_title | TEXT | Share title | Post Title |
| share_type | TEXT | Share Type | Share/post media category |
| video_asset_url | TEXT | Video Asset URL | Download 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.
| ID | Type | Name | Description |
|---|---|---|---|
| ad_form_description | TEXT | Form Description | Description of the form, visible to both the owner and the viewer. |
| ad_form_headline | TEXT | Form Headline | Headline of the form, visible to both the owner and the viewer. |
| ad_form_legal_disclaimer | TEXT | Form Legal Disclaimer | Owner'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. |
| ad_form_legal_info_id | TEXT | Form Legal Info ID | Unique identifier of the LeadGenFormLegalInfo. |
| ad_form_name | TEXT | Form Name | Name of the Lead Form provided by the owner.. |
| ad_form_post_review_last_updated | DATE | Form Review Last Updated | The date indicating when the review status is initiated/last updated. |
| ad_form_post_review_last_updated_datetime | Form Review Last Updated Datetime | The date and time indicating when the review status is initiated/last updated. | |
| ad_form_post_review_rejection_reasons | TEXT | Form Review Reject Reason | An 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_status | TEXT | Form Review Status | Indicate 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_label | TEXT | Form Post Submission Call To Action Label | Label for the call to action shown to the viewer. Default is VISIT_COMPANY_WEBSITE |
| ad_form_post_submission_info_cta_target | TEXT | Form Post Submission Call To Action Target | Target 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_message | TEXT | Form Post Submission Message | The message displayed to a member after the Lead Form is submitted. |
| ad_form_privacy_policy_url | TEXT | Form Privacy Policy URL | The 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_status | TEXT | Form Status | DRAFT, 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_message | TEXT | Form Post Submission Message (Duplicate) | The message displayed to a member after the Lead Form is submitted. |
| ad_form_thank_you_page_call_to_action | TEXT | Form Post Submission Call To Action Label (Duplicate) | Label for the call to action shown to the viewer. Default is VISIT_COMPANY_WEBSITE |
| form_created_datetime | DATE | Form Created Date | Date and time corresponding to the creation of the form. |
| form_creation_locale_country | COUNTRY | Form Creation Locale Country | A lowercase two-letter language code as defined by ISO-639-1 |
| form_creation_locale_language | TEXT | Form Creation Locale Language | An uppercase two-letter country code as defined by ISO-3166 |
| form_id | TEXT | Form ID | Numerical identifier for the form. |
| form_last_modified_datetime | DATE | Form Last Modified Date | Date and time corresponding to the last modified date of the form. |
| form_owner_id | TEXT | Form Owner ID | ID that identifies the owner of the Lead Form. |
| form_version_id | TEXT | Form Version ID | The version ID of the form. This is a derived field and is generated on the server side. |
| form_version_tag | TEXT | Form Version Tag | The number of times the form has been modified. |
| OBJECT | Form Hidden Fields | Hidden 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.
| ID | Type | Name | Description |
|---|---|---|---|
| answers | TEXT | Form Response Answers | All answers on form response |
| form_campaign_id | TEXT | Form Response Campaign ID | Campaign id that this form response is connected. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| form_campaign_name | TEXT | Form Response Campaign Name | Campaign name that this form response is connected. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| form_campaign_type | TEXT | Form Response Campaign Type | Campaign type that this form response is connected. Campaigns in the LinkedIn API correspond to 'Ad sets' in the LinkedIn Campaign Manager UI. |
| form_creative_id | TEXT | Form Response Creative ID | Form creative id |
| form_owner_account_name | TEXT | Form Response Owner Account Info Name | Name of the owner of the Lead Form Response. |
| form_response_associated_creative_status | TEXT | Form Response Associated Creative Status | Status of creative, associated with this Form Response |
| form_response_consent_responses | TEXT | Form Response Consent Responses | All Consent Response answers on this Form Response |
| form_response_id | TEXT | Form Response id | ID of a Form response |
| form_response_owner_id | TEXT | Form Response Owner ID | ID that identifies the owner of the Lead Form Response. |
| form_submitter | TEXT | (Deprecated) Form Response Submitter | (Deprecated) ID that identifies the person who submitted the Lead Form Response. |
| lead_type | TEXT | Form Response Lead type | Type of the lead representing the origination of the lead. |
| submitted_at | DATE | Form Response submitted at time | Form response submitted time f: YYYY-MM-DD |
| test_lead | BOOLEAN | Form Response Is Test Lead | True/False is this test lead form response |
LinkedIn Ads Job fields
The Job report of the LinkedIn Ads connector includes 3 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| cost_per_job_application | NUMERIC | Cost Per Job Application | Cost in the account's local currency divided by the number of times a member completed a job application |
| job_applications | NUMERIC | Job Applications | The 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_clicks | NUMERIC | Job Apply Clicks | The 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.
| ID | Type | Name | Description |
|---|---|---|---|
| appointmentsscheduled | NUMERIC | Appointments Scheduled | The count of appointments booked through Lead Gen campaigns. |
| approximate_unique_impressions | NUMERIC | Approximate 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_penetration | PERCENT | Audience Penetration | The 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_time | NUMERIC | Average Dwell Time | This 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_frequency | PERCENT | Average frequency | Average number of impressions seen by each member account exposed to at least one impression |
| clicks | NUMERIC | Clicks | The count of clicks. |
| comments | NUMERIC | Comments | Number of Comments |
| conversionvalueinlocalcurrency | NUMERIC | Conversion 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. |
| cpc | NUMERIC | CPC | Cost-per-click (CPC) |
| cpm | NUMERIC | CPM | Cost per mille (CPM).It is the cost an advertiser pays for one thousand views or impressions of an advertisement (1000 * cost / impressions) |
| ctr | PERCENT | CTR | Click-through rate (CTR) |
| engagement_rate | PERCENT | Engagement Rate | Number of times members interacted with your ad (paid and free clicks divided by total impressions) |
| engagements | NUMERIC | Engagements | The total number of actions that people took on your Linkedin Ads. |
| impressions | NUMERIC | Impressions | This is the count of "impressions" for Direct Ads and Sponsored Updates and "sends" for InMails. |
| landingpageclicks | NUMERIC | Landing Page Clicks | The count of clicks which take the user to the creative landing page. |
| leadgenerationmailcontactinfoshares | NUMERIC | Lead Generation Mail Contact Info Shares | The number of times users shared contact info through the One Click Lead Gen for Sponsored InMail. Sponsored InMail only. |
| likes | NUMERIC | Likes | The count of likes. Sponsored Updates only. |
| oneclickleadformopens | NUMERIC | One Click Lead Form Opens | The count of times users opened the lead form for a One Click Lead Gen campaign. |
| oneclickleads | NUMERIC | One Click Leads | The count of leads generated through One Click Lead Gen. |
| opens | NUMERIC | Opens | The count of opens of Sponsored InMail and Sponsored Messaging ads.only. |
| sends | NUMERIC | Sends | The count of sends of Sponsored Messaging ads. |
| shares | NUMERIC | Shares | This is the count of "shares" for sponsored Shares. |
| spend | NUMERIC | Spend | Cost in the account's local currency |
| totalcost | NUMERIC | Total Cost | Cost in the account's local currency (Duplicate of Spend) |
| transactionrevenue | NUMERIC | Transaction 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.
| ID | Type | Name | Description |
|---|---|---|---|
| company_page_clicks | NUMERIC | Company Page Clicks | The count of clicks to view the company page. |
| cost_per_externalwebsiteconversions | NUMERIC | Cost Per External Website Conversions | Cost in the account's local currency divided by the count of conversions indicated by pixel loads on an external advertiser website. |
| cost_per_externalwebsitepostclickconversions | NUMERIC | Cost Per External Website Post Click Conversions | Cost 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_externalwebsitepostviewconversions | NUMERIC | Cost Per External Website Post View Conversions | Cost in the account's local currency divided by the count of post-view conversions indicated by pixel loads on an external advertiser website. |
| download_clicks | NUMERIC | Download Clicks | The count of times users clicked the download icon to save the ad media. Only available for ad formats supporting media downloads. |
| externalwebsiteconversions | NUMERIC | External Website Conversions | The count of conversions indicated by pixel loads on an external advertiser website. |
| externalwebsitepostclickconversions | NUMERIC | External Website Post Click Conversions | The count of post-click conversions indicated by pixel loads on an external advertiser website. |
| externalwebsitepostviewconversions | NUMERIC | External Website Post View Conversions | The count of post-view conversions indicated by pixel loads on an external advertiser website. |
| follows | NUMERIC | Follows | The count of follows. Sponsored Updates only. |
| full_screen_plays | NUMERIC | Share full screen plays | Number of Full Screen Plays |
| transactions | NUMERIC | Transactions | The number of transactions (Duplicate of External Website Conversions) |
| viral_company_page_clicks | NUMERIC | Viral Company Page Clicks | The 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.
| ID | Type | Name | Description |
|---|---|---|---|
| sponsored_creative_content_commentary | TEXT | Creative Commentary | Sponsored creative (ad) commentary |
| sponsored_creative_content_description | TEXT | Creative Description | Sponsored creative (ad) description |
| sponsored_creative_content_title | TEXT | Creative Title | creative (ad) title |
LinkedIn Ads Video fields
The Video report of the LinkedIn Ads connector includes 13 fields.
| ID | Type | Name | Description |
|---|---|---|---|
| average_video_watch_time | NUMERIC | Average Video Watch Time | Average 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. |
| completions | NUMERIC | Completions | The count of video ads that played 97-100% of the video. |
| quartile_1 | NUMERIC | Video watches at 25% | The count of video ads that played through the first quartile of the video. |
| quartile_2 | NUMERIC | Video watches at 50% | The count of video ads that played through the midpoint of the video. |
| quartile_3 | NUMERIC | Video watches at 75% | The count of video ads that played through the third quartile of the video. |
| video_completions | NUMERIC | Video Completions | The count of video ads that played 97-100% of the video. |
| video_start | NUMERIC | Video plays | The number of times a video starts to play |
| video_starts | NUMERIC | Video plays (duplicate) | The number of times a video starts to play |
| video_viewed_25pcnt | NUMERIC | Video watches at 25% (Duplicate) | The count of video ads that played through the first quartile of the video. (Duplicate) |
| video_viewed_50pcnt | NUMERIC | Video watches at 50% (Duplicate) | The count of video ads that played through the midpoint of the video. (Duplicate) |
| video_viewed_75pcnt | NUMERIC | Video watches at 75% (Duplicate) | The count of video ads that played through the third quartile of the video. (Duplicate) |
| video_views | NUMERIC | Video views | 2 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_time | NUMERIC | Video Watch Time | The 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.
| ID | Type | Name | Description |
|---|---|---|---|
| viral_clicks | NUMERIC | Share viral clicks | Number of Viral Clicks Aggregated by Campaign |
| viral_comments | NUMERIC | Share viral comments | Number of Viral Comments by Campaign |
| viral_follows | NUMERIC | Share viral follows | Number of Viral Follows by Campaign |
| viral_full_screen_plays | NUMERIC | Share viral full screen plays | Number of Viral Full Screen Plays |
| viral_impressions | NUMERIC | Share viral impressoins | Number of Viral Impressions Aggregated by Campaign |
| viral_likes | NUMERIC | Share viral likes | Number of Viral Likes by Campaign |
| viral_reactions | NUMERIC | Share viral reactions | Number of Viral Reactoins by Campaign |
| viral_shares | NUMERIC | Share viral shares | Number of Viral Shares by Share |
| viral_total_engagements | NUMERIC | Share viral total engagements | Viral Total Engagements |
| viral_video_completions | NUMERIC | Share viral video completions | Number of Viral Video Views to 100% |
| viral_video_starts | NUMERIC | Share viral video starts | Number of Viral Video Starts |
| viral_video_viewed_25pcnt | NUMERIC | Share viral video viewed 25pcnt | Number of Viral Video Views to 25% |
| viral_video_viewed_50pcnt | NUMERIC | Share viral video viewed 50pcnt | Number of Viral Video Views to 50% |
| viral_video_viewed_75pcnt | NUMERIC | Share viral video viewed 75pcnt | Number of Viral Video Views to 75% |
| viral_video_views | NUMERIC | Share viral video views | Number of Viral Video Views |
| viralexternalwebsiteconversions | NUMERIC | Viral External Website Conversions (Duplicate) | The count of conversions indicated by pixel loads on an external advertiser website driven by a viral event. |
| viralexternalwebsitepostclickconversions | NUMERIC | Viral External Website Post Click Conversions | The count of post-click conversions indicated by pixel loads on an external advertiser website driven by a viral click. |
| viralexternalwebsitepostviewconversions | NUMERIC | Viral External Website Post View Conversions | The count of post-view conversions indicated by pixel loads on an external advertiser website driven by a viral impression. |
| viraloneclickleads | NUMERIC | Viral One Click Leads | The 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.
| ID | Type | Name | Description | Report |
|---|---|---|---|---|
| adnetwork_conversions | NUMERIC | Ad Network Conversions | The Ad Network Reported Conversions | Ad Network |
| adnetwork_revenue | NUMERIC | Ad Network Revenue | The Ad Network Reported Revenue | Ad Network |
| country_code | COUNTRY | Country Code | List of country codes of target locations | Country |
| data_fetched_at | Data fetched at | UTC 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. | ||
| datasource | TEXT | Data Source | The name of the Windsor connector returning the row | |
| date | DATE | Date | Dates covered by the report data point. Date is specified in UTC. | Time |
| day_of_month | TEXT | Day of month | Day of the month | |
| impression_device_type | TEXT | Impression device type | Group 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_name | TEXT | Member company name | Company 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_size | TEXT | Member company size | Approximate 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_country | COUNTRY | Member country | Countries of LinkedIn members engaged with campaigns. Groups metrics by audience countries, cannot be combined with any other aggregation fields. | Country |
| member_industry | TEXT | Member industry | Industry of LinkedIn members engaged with campaigns. Groups metrics by audience industries, cannot be combined with any other aggregation fields. | Member Industry |
| member_job_function | TEXT | Member job function | Job 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_title | TEXT | Member job title | Job titles of LinkedIn members engaged with campaigns. Groups metrics by audience job titles, cannot be combined with any other aggregation fields. | Demographics |
| member_region | REGION | Member region | Geographic regions of LinkedIn members engaged with campaigns. Groups metrics by audience regions, cannot be combined with any other aggregation fields. | Region |
| member_seniority | TEXT | Member seniority | Seniority of LinkedIn members engaged with campaigns. Groups metrics by audience seniorities, cannot be combined with any other aggregation fields. | Member Seniority |
| month | TEXT | Month | Number of the month | |
| now | Now | Current timestamp | ||
| placement_name | TEXT | Placement Name | Group results by placement. | Placement |
| serving_location | TEXT | Service Location | Group results by serving location, onsite or offsite. | Serving Location |
| source | TEXT | Source | The name of the Windsor connector returning the row | |
| today | DATE | Today | Today's date | |
| week | TEXT | Week | Week (Sun-Sat). | |
| week_day | TEXT | Day of week and day number | Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday. | |
| week_day_iso | TEXT | Day of week and day number, ISO | Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7 | |
| week_iso | TEXT | Week ISO | Week, ISO format (Mon-Sun). | |
| year | TEXT | Year | Year | |
| year_month | TEXT | Yearmonth | Year and month, e.g. 2024|3 | |
| year_month_name | TEXT | Year month name | Year and month with the month name written out, e.g. "Jan 2025". | |
| year_of_week | TEXT | Year of week | The year that contains first day of the week (Sun-Sat). | |
| year_of_week_iso | TEXT | Year of week, ISO | The year that contains first day of the ISO week (Mon-Sun). | |
| year_week | TEXT | Year week | Year and week for US weeks (Sun-Sat), e.g. 2024|15 | |
| year_week_iso | TEXT | Year week ISO | Year and week for ISO weeks (Mon-Sun), e.g. 2024|20 |
