> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/ppc/linkedin-ads.md).

# LinkedIn Ads

Export LinkedIn Ads campaigns, creatives, leads, and analytics to Google Sheets or BigQuery without code via Coupler.io.

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

{% hint style="success" %}
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.
{% endhint %}

{% stepper %}
{% step %}
**Create a new data flow.** In Coupler.io, click **Add data flow** and search for **LinkedIn Ads** as your source.
{% endstep %}

{% step %}
**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.
{% endstep %}

{% step %}
**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.
{% endstep %}

{% step %}
**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.
{% endstep %}

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

{% step %}
**Run the data flow.** Click **Run** to execute a manual sync. Once it completes successfully, your data will appear in the destination.
{% endstep %}
{% endstepper %}

## 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)                                                      |

{% hint style="warning" %}
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.
{% endhint %}

#### 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

{% tabs %}
{% tab title="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
  {% endtab %}

{% tab title="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
  {% endtab %}

{% tab title="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
  {% endtab %}
  {% endtabs %}

## 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

<details>

<summary>I can't see all my ad accounts after connecting</summary>

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.

</details>

<details>

<summary>I get an error when connecting to Looker Studio</summary>

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.

</details>

<details>

<summary>My data flow fails with a timeout error</summary>

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.

</details>

### Missing data

<details>

<summary>The Reach metric or approximateUniqueImpressions column is empty</summary>

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.

</details>

<details>

<summary>I'm missing columns when pulling from multiple ad accounts</summary>

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.

</details>

<details>

<summary>I can't find ad names in the analytics report</summary>

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.

</details>

<details>

<summary>My Sponsored leads export is missing some submissions</summary>

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.

</details>

### Permission errors

<details>

<summary>I get a "permission denied" or "unauthorized" error</summary>

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.

</details>

### Data discrepancies

<details>

<summary>Numbers in Coupler.io don't match what I see in Campaign Manager</summary>

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.

</details>

<details>

<summary>Preview data looks different from exported data</summary>

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.

</details>

### Rate limits

<details>

<summary>My data flow fails with a rate limit error</summary>

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.

</details>

## LinkedIn Ads FAQ

<details>

<summary>Can I pull data from multiple LinkedIn Ads accounts at once?</summary>

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.

</details>

<details>

<summary>How do I get ad names in my analytics report?</summary>

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.

</details>

<details>

<summary>Why am I limited to 18 metrics?</summary>

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

</details>

<details>

<summary>Can I get company-level or country-level data per campaign?</summary>

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.

</details>

<details>

<summary>Why is the Reach metric empty in my report?</summary>

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.

</details>

<details>

<summary>How do I export LinkedIn Lead Gen Form submissions?</summary>

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.

</details>

<details>

<summary>Can I combine LinkedIn Ads data with other ad platforms?</summary>

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.

</details>

<details>

<summary>Can I send LinkedIn Ads data to an AI tool for analysis?</summary>

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.

</details>

<details>

<summary>Why does my data flow time out?</summary>

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.

</details>

{% hint style="info" %}
For metric definitions and dimension options, see the [Data Overview](#linkedin-ads-data-overview) article. For troubleshooting connection and data problems, see [Common Issues](#linkedin-ads-common-issues). For setup recommendations specific to LinkedIn Ads, see [Best Practices](https://docs.coupler.io/sources/category/ppc/linkedin-ads/best-practices.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.coupler.io/sources/category/ppc/linkedin-ads.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
