API Connectors

users-love-us medal soc2
Send your LinkedIn Ads data to
Data StudioGoogle SheetsChatGPTClaudePower BIExcelTableauGoogle BigQueryAmazon S3Azure Blob StorageSnowflakeMySQLPostgreSQLPythonAzure SQLAmazon RedshiftDatabricksWindsor MCPMicrosoft FabricCopilot AgentPerplexityLovableAntigravitySupabase

LinkedIn Ads Connector Reference

87 metrics150 dimensions
Fields Actions

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 237 fields (87 metrics, 150 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
Rename Campaign Change the name of a LinkedIn Ads campaign. Only the name changes; budget, schedule, targeting and status are left untouched, and reporting stays attached because it keys on the campaign id.

Change the name of a LinkedIn Ads campaign. Only the name changes; budget, schedule, targeting and status are left untouched, and reporting stays attached because it keys on the campaign id.

Parameters
campaign_idstringRequirednamestringRequired
Set Campaign Schedule Change the run schedule of a LinkedIn Ads campaign. Provide start_date and/or end_date as YYYY-MM-DD; at least one is required. The unspecified bound keeps its current value. The end date is exclusive: the campaign stops at the start of that day. The start date cannot be changed once the campaign has started.

Change the run schedule of a LinkedIn Ads campaign. Provide start_date and/or end_date as YYYY-MM-DD; at least one is required. The unspecified bound keeps its current value. The end date is exclusive: the campaign stops at the start of that day. The start date cannot be changed once the campaign has started.

Parameters
campaign_idstringRequiredstart_datestringend_datestring
Create Creative Create a new ad (creative) in a LinkedIn Ads campaign from an existing post. post_urn must reference a published post or InMail content (urn:li:ugcPost:..., urn:li:share:... or urn:li:adInMailContent:...); the connector does not build post content from scratch. Created as DRAFT by default so it does not serve until enabled with enable_creative.

Create a new ad (creative) in a LinkedIn Ads campaign from an existing post. post_urn must reference a published post or InMail content (urn:li:ugcPost:..., urn:li:share:... or urn:li:adInMailContent:...); the connector does not build post content from scratch. Created as DRAFT by default so it does not serve until enabled with enable_creative.

Parameters
campaign_idstringRequiredpost_urnstringRequiredintended_statusstringnamestring
Set Campaign Targeting Replace the target audience (targetingCriteria) of a LinkedIn Ads campaign. include and exclude map a facet name to a list of full entity URNs, for example {"locations": ["urn:li:geo:103644278"], "interfaceLocales": ["urn:li:locale:en_US"], "industries": ["urn:li:industry:9"]}. Included facets are AND-ed together and the values within a facet are OR-ed. interfaceLocales is required. locations and profileLocations cannot be used together. The resulting audience must have at least 300 members. This replaces the campaign's entire audience.

Replace the target audience (targetingCriteria) of a LinkedIn Ads campaign. include and exclude map a facet name to a list of full entity URNs, for example {"locations": ["urn:li:geo:103644278"], "interfaceLocales": ["urn:li:locale:en_US"], "industries": ["urn:li:industry:9"]}. Included facets are AND-ed together and the values within a facet are OR-ed. interfaceLocales is required. locations and profileLocations cannot be used together. The resulting audience must have at least 300 members. This replaces the campaign's entire audience.

Parameters
campaign_idstringRequiredincludeobjectRequiredexcludestring

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 TIMESTAMP 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 TIMESTAMP 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 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 TIMESTAMP 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 TIMESTAMP 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 TIMESTAMP 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 TIMESTAMP 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.
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.
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 TIMESTAMP 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.
hidden_fields 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
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
TEXT Creative Commentary Sponsored creative (ad) commentary
TEXT Creative Description Sponsored creative (ad) description
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 TIMESTAMP 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 TIMESTAMP 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