LinkedIn Ads

LinkedIn Ads is a B2B advertising platform that lets you run sponsored content, lead gen forms, video ads, and more across LinkedIn's professional network. With Coupler.io, you can automatically export your LinkedIn Ads data — campaign performance, creatives, leads, and analytics — to any destination without writing a single line of code.

Why connect LinkedIn Ads to Coupler.io?

• Pull ad analytics by single or multiple dimensions (company, country, job title, placement, and more) into your reporting tool of choice

• Export sponsored leads directly from LinkedIn Lead Gen Forms into Google Sheets, a CRM, or a database

• Combine LinkedIn Ads data with other paid channels using Append or Join transformations for a unified view

• Send performance data to AI destinations like ChatGPT, Claude, or Gemini for automated analysis and recommendations

• Keep your dashboards in Looker Studio, Power BI, or BigQuery refreshed on a schedule

Before you start, make sure you have:

• A LinkedIn account with access to at least one LinkedIn Ads account

• Admin or Analyst role on the ad account(s) you want to pull data from

• A Coupler.io account (free trial works)

Quick start

If you want campaign performance data, start with Ad analytics by single dimension — it's the most flexible report and covers most use cases right away.

1

Create a new data flow. In Coupler.io, click Add data flow and search for LinkedIn Ads as your source.

2

Authenticate with LinkedIn. Click Sign in with LinkedIn and authorize Coupler.io to access your LinkedIn Ads data. You'll be redirected back automatically after approval.

3

Select your ad account(s). Choose one or more ad accounts to pull data from. If you manage multiple accounts, you can select all of them — use Append mode to stack their data in one output.

4

Choose an entity. Pick the data type you need — for example, Ad analytics by single dimension for performance metrics, or Sponsored leads for lead gen form submissions.

5

Configure your destination. Choose where to send the data: Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination like ChatGPT or Claude.

6

Run the data flow. Click Run to execute a manual sync. Once it completes successfully, your data will appear in the destination.

Available entities

Entity	Group	What it contains
Ad analytics by single dimension	Reports	Performance metrics broken down by one dimension (e.g., campaign, country, device)
Ad analytics by multiple dimensions	Reports	Performance metrics broken down by up to several dimensions at once
Sponsored leads	Leads generation	Lead submissions from LinkedIn Lead Gen Forms
Ad account users	Core components	Users with access to your ad accounts
Campaign groups	Core components	Top-level groupings of campaigns
Campaigns	Core components	Individual campaign settings and status
Creatives	Core components	Ad creative details (copy, format, status)
Video ads	Core components	Video ad metadata
Shares (creative sponsored content)	Core components	Organic and sponsored post data
Conversions	Core components	Conversion event definitions

LinkedIn Ads data overview

LinkedIn Ads in Coupler.io gives you access to two types of data: analytics reports (what happened with your ads) and core components (what your account is made of). Understanding which entity to use will save you a lot of time when building reports.

Entity summary

Entity	Best for	Date range support
Ad analytics by single dimension	Performance reporting by one pivot	Yes (with period split)
Ad analytics by multiple dimensions	Cross-dimensional analysis	Yes (with period split)
Sponsored leads	Exporting lead form submissions	Yes
Campaigns	Campaign settings and status	Start date only
Campaign groups	Budget and grouping info	Start date only
Creatives	Ad creative metadata	Start date only
Video ads	Video ad details	Start date only
Conversions	Conversion definitions	Start date only
Ad account users	Account access management	No
Shares	Sponsored content post data	No

Analytics reports

Dimensions available for single-dimension reports

Dimension	What it tells you
Account	Performance rolled up per ad account
Campaign	Metrics per individual campaign
Campaign group	Metrics per campaign group
Creative	Metrics per ad creative
Company	Reach and engagement by target company
Member country	Geographic breakdown by country
Member region	Sub-country regional breakdown
Member company size	Audience breakdown by company size
Member industry	Audience breakdown by industry
Member job function	Audience breakdown by job function
Member job title	Audience breakdown by job title
Member seniority	Audience breakdown by seniority level
Impression device type	Desktop vs. mobile performance
Placement	LinkedIn feed, messaging, etc.
Serving location	On-site vs. off-site delivery
Conversion	Performance per conversion event
Card index	Carousel card-level performance
Conversation node	Message ad conversation path
Shares (creative sponsored content)	Post-level performance

Dimensions available for multi-dimension reports

Dimension	Notes
Account
Campaign
Campaign group
Creative
Company
Campaign objective type	Not available in single-dimension
Conversion
Impression device type
Placement name
Serving location
Card index
Shares (creative sponsored content)

Available metrics (both report types)

Category	Metrics
Clicks	Clicks, Action clicks, Ad unit clicks, Card clicks, Company page clicks, Download clicks, Job apply clicks, Landing page clicks, Text URL clicks
Impressions & reach	Impressions, Card impressions, Viral impressions, Viral card impressions, Reach, Audience penetration, Average dwell time
Spend	Amount spend in local currency, Amount spend in USD, Conversion value in local currency
Conversions	Conversions, Post-click conversions, Post-view conversions, Viral conversions, Registrations, Job applications
Leads	Leads, Lead form opens, Lead generation mail interested clicks, Lead generation mail contact info shares, Talent leads, Valid work email leads, Viral leads
Engagement	Likes, Comments, Shares, Follows, Reactions, Opens, Sends, Other engagements, Comment likes, Engagements
Video	Video starts, Video views, Video 25/50/75% completions, Video completions, Full screen plays
Document ads	Document 25/50/75% completions, Document completions
Viral variants	Most of the above metrics have a viral equivalent (e.g., Viral clicks, Viral likes, Viral video views)

LinkedIn Ads limits analytics reports to 18 metrics per request. If you need more, create a second data flow with the remaining metrics and use Append or Join to combine them in your destination.

Period split options

Option	Use case
Totals only	Overall performance for the date range
Daily	Day-by-day trend analysis
Monthly	Month-over-month comparisons
Yearly	Annual reporting

Use cases by role

Performance marketers

• Use Ad analytics by single dimension with Campaign or Creative dimension + daily split to track performance trends and identify underperforming ads

• Pull Member country or Member industry dimension data to understand which audiences convert best — then use this to refine targeting

• Join campaign analytics with the Campaigns entity to enrich performance data with campaign names, objectives, and budget settings

• Send weekly performance exports to ChatGPT or Claude for automated commentary and anomaly detection

Demand gen & lead gen teams

• Use the Sponsored leads entity to export all lead form submissions directly into Google Sheets or a CRM pipeline

• Filter by specific lead generation forms using the form selector to keep each export scoped to one campaign or form type

• Append lead data from multiple ad accounts into a single sheet for a consolidated view of all lead gen activity

Analysts & BI teams

• Use Ad analytics by multiple dimensions to cross-tab campaign performance with audience attributes (e.g., Campaign × Member seniority)

• Load raw data into BigQuery and join with CRM or revenue data to calculate pipeline influenced by LinkedIn Ads

• Use Append mode with daily refreshes to build a historical time series — LinkedIn's UI only shows a rolling window

• Combine LinkedIn Ads data with Google Ads and Meta Ads data flows using Coupler.io's Join transformation for a cross-channel paid media dashboard in Looker Studio

Platform-specific notes

• The Reach metric and related fields (frequency, CPM) are only available when the Reach metric is specifically selected — they won't appear in all reports automatically

• Ad name is not a dimension in analytics reports; to get ad names, join the analytics report with the Creatives entity on the creative ID

• The approximateUniqueImpressions field (used for reach) may return null for campaigns with small audience sizes due to LinkedIn's privacy thresholds

• Conversions and Shares entities do not support date filtering — they return all data available in your account

• LinkedIn enforces a hard cap of 18 metrics per analytics request; plan your metric selection carefully before running large reports

LinkedIn Ads common issues

Connection issues

I can't see all my ad accounts after connecting

This usually means your LinkedIn profile doesn't have the right role on those accounts. LinkedIn Ads requires you to have at least an Analyst role on an account for it to appear in Coupler.io. Ask your LinkedIn Ads admin to check your access level in Campaign Manager under Account settings > Manage access.

If you manage accounts through a Business Manager, make sure the LinkedIn profile you authenticated with is also added directly to the ad accounts — Business Manager access alone is not always sufficient.

I get an error when connecting to Looker Studio

If you're using the Coupler.io Looker Studio community connector, make sure you've completed a successful manual run of the data flow first before connecting to Looker Studio. If you see a connector error, try disconnecting and reconnecting the data source in Looker Studio, then re-authorizing.

My data flow fails with a timeout error

Timeout errors typically happen when you're requesting too much data at once — for example, a very wide date range combined with many metrics and a daily split across multiple ad accounts. Try narrowing the date range, reducing the number of selected metrics to under 18, or splitting the request into multiple data flows.

Missing data

The Reach metric or approximateUniqueImpressions column is empty

LinkedIn applies privacy thresholds to reach-related metrics. If an audience segment is too small, LinkedIn returns null instead of a value. This is a LinkedIn platform limitation and affects all tools — not just Coupler.io. Broaden your targeting or aggregate over a longer period to get non-null values.

I'm missing columns when pulling from multiple ad accounts

When accounts have different campaign types or settings, some columns may not be populated for all accounts. Make sure you're selecting the same metrics and dimensions across all accounts. If you're using Append mode to combine multiple account exports, column alignment depends on both sources returning the same schema.

I can't find ad names in the analytics report

Ad name is not exposed as a dimension in LinkedIn Ads analytics — this is a LinkedIn API limitation. To get ad names, pull the Creatives entity separately and use Coupler.io's Join transformation to match it to your analytics report on the creative ID field.

My Sponsored leads export is missing some submissions

Check that you haven't filtered by specific lead gen forms when you intended to pull from all forms. Leave the Lead generation forms field blank to fetch leads from every form under the selected ad account. Also verify the date range includes the period when the leads were submitted.

Permission errors

I get a "permission denied" or "unauthorized" error

Re-authenticate the LinkedIn connection in Coupler.io. LinkedIn OAuth tokens can expire or be revoked, especially if you changed your LinkedIn password or revoked app permissions. Go to your data flow's source settings, disconnect the account, and sign in again.

Data discrepancies

Numbers in Coupler.io don't match what I see in Campaign Manager

The most common cause is a timezone mismatch. LinkedIn Campaign Manager uses your account's timezone setting, while the API may return data in UTC. Check your Split data by period setting and compare the totals (not daily breakdowns) first to rule out day-boundary differences.

Also confirm you're using the same date range. LinkedIn's UI sometimes defaults to a different window than what you've set in your data flow.

Preview data looks different from exported data

The preview in Coupler.io shows a sample of your data and may not reflect the full export. Always verify against the actual destination output after a successful run rather than relying on the preview.

Rate limits

My data flow fails with a rate limit error

LinkedIn's Ads API has rate limits that can be hit when pulling large volumes of data — especially with many ad accounts, a long date range, and daily granularity all at once. If you hit a rate limit, space out your data flows, reduce the date range, or split one large data flow into multiple smaller ones.

LinkedIn Ads FAQ

Can I pull data from multiple LinkedIn Ads accounts at once?

Yes. When configuring your data flow, you can select multiple ad accounts in the Ad accounts field. All selected accounts will be included in a single export. If the accounts have different structures, use Append mode to combine their data cleanly in your destination.

How do I get ad names in my analytics report?

LinkedIn's API doesn't include ad names in analytics reports — only creative IDs. To get ad names, add a second source using the Creatives entity in the same data flow, then use Coupler.io's Join transformation to match the two datasets on the creative ID field. See the Data Overview article for more detail on available fields.

Why am I limited to 18 metrics?

This is a LinkedIn Ads API restriction — not a Coupler.io limitation. LinkedIn only allows 18 metrics per analytics request. If you need more, create a second data flow with the additional metrics using the same dimension and date range, then join the two outputs on the shared key columns (e.g., creative ID + date).

Can I get company-level or country-level data per campaign?

Yes, but you have to choose one dimension at a time in Ad analytics by single dimension. Select the Member country or Company dimension to see performance broken down geographically or by target company. If you need both dimensions together, use Ad analytics by multiple dimensions and add both — check first that LinkedIn supports that combination.

Why is the Reach metric empty in my report?

LinkedIn withholds reach data when the audience segment is too small, for privacy reasons. This returns a null value for approximateUniqueImpressions and related fields. This is a LinkedIn platform behavior and cannot be overridden. Try aggregating over a longer time period or a broader audience segment.

How do I export LinkedIn Lead Gen Form submissions?

Use the Sponsored leads entity. You can leave the Lead generation forms filter blank to export all submissions, or pick specific forms if you want a per-form breakdown. Set a start date to limit how far back the export goes. The leads will include form field responses and submission timestamps.

Can I combine LinkedIn Ads data with other ad platforms?

Yes. Set up separate data flows for each platform (e.g., LinkedIn Ads, Google Ads, Meta Ads) and use Coupler.io's Append transformation to stack them into a unified dataset. Make sure the metric and dimension column names align across sources, or use the Join transformation if you're matching on a shared key like campaign name or date.

Can I send LinkedIn Ads data to an AI tool for analysis?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Perplexity, Cursor, and OpenClaw. You can send your LinkedIn Ads performance data directly to these tools for automated insights, anomaly detection, or natural language summaries.

Why does my data flow time out?

Timeout errors happen when a request is too large — usually a combination of many ad accounts, a long date range, daily granularity, and many metrics. Narrow the date range to 30 days or less, reduce your metric count, or split the data flow into smaller pieces. See Common Issues for more troubleshooting steps.

For metric definitions and dimension options, see the Data Overview article. For troubleshooting connection and data problems, see Common Issues. For setup recommendations specific to LinkedIn Ads, see Best Practices.