> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn Ads integration

> Connect LinkedIn Ads to Cometly to see spend next to the leads and sales each campaign and ad produced, and send those conversions back to LinkedIn.

When you connect LinkedIn Ads to Cometly, your campaign groups, campaigns and ads come into the Cometly **Ads Manager** with their spend, impressions and clicks, so Cometly can attribute each conversion to the ad that produced it. You can then send those conversions back to LinkedIn through the Conversion API, the server-side connection that reports your Cometly events (the leads, sales and other actions Cometly records) to the ad platform.

This lets you see what each LinkedIn campaign costs next to the leads and sales it produced. You can then decide which campaigns and creatives to scale, pause or rework.

## Before you start

* **A LinkedIn login with access to the ad accounts.** Cometly lists the business ad accounts your LinkedIn login can access.
* **The right LinkedIn roles, if you plan to send conversions or track lead forms.** See [Required permissions](https://docs.cometly.com/guides/conversion-api/linkedin.md#required-permissions) and [LinkedIn Lead Gen Form tracking](https://docs.cometly.com/integrations/forms/linkedin-lead-forms.md).
* **The Administrator or Advertiser role** in the Cometly space (a space is the workspace that holds one business's tracking, ad accounts and reports).
* **The Cometly pixel** (the tracking script that records your visitors) on your landing pages. See [Install the pixel](https://docs.cometly.com/getting-started/install-pixel.md).

## Connect LinkedIn Ads

**1. Open the LinkedIn Ads row**

In Cometly, click **Integrations** in the left sidebar and find **LinkedIn Ads** under **Ad Platforms**.

**2. Sign in with LinkedIn**

Click **Sign in with LinkedIn**. A pop-up window opens on LinkedIn. Sign in and allow the access Cometly asks for. When the window comes back to Cometly, click **Done** to close it.

**3. Find your ad accounts**

The row expands and the **Ad Accounts** table lists the accounts your LinkedIn login can access. Use **Search ad account** to find one.

**4. Connect each ad account to the space**

In the space the account should report into, click **Connect & Sync Data** next to it. You see **Ad Account Connected - Data will sync in 30-60 minutes**.

> [!WARNING]
>
> You can connect one LinkedIn profile to your Cometly user. If you sign in with a different LinkedIn profile, Cometly removes the previous one and disconnects its ad accounts from their spaces. To undo that, click **Resync**, sign in with the original profile and click **Connect & Sync Data** on each account again.

> [!NOTE]
>
> Your LinkedIn sign-in is personal: only you can see and manage it. An ad account can be connected to one space at a time. See [Same ad account in two spaces](https://docs.cometly.com/support/troubleshooting/ad-accounts/same-ad-account-in-two-spaces.md).

## Check it worked

The account now shows **Connected** with the space's name in the **Space** column, and it appears in the **Connected LinkedIn Ad Accounts** card, where everyone in the space can see which LinkedIn profile connected it. Within 30 to 60 minutes, your active campaigns start to appear in the **Ads Manager** with their spend, impressions and clicks.

## Add Cometly's URL parameters

Add these parameters to your LinkedIn ads:

```text theme={null}
comet_source=linkedin&comet_campaign={{CAMPAIGN_ID}}&comet_ad_id={{CREATIVE_ID}}
```

![Setup step 4, Add URL parameters to your ads, with LinkedIn Ads selected, showing the LinkedIn Ads URL Parameters template and the Copy Parameters button.](https://mintcdn.com/cometly/BM7eSn6-ecx8ZzBx/images/integrations/ad-platforms/linkedin/02.webp?fit=max\&auto=format\&n=BM7eSn6-ecx8ZzBx\&q=85\&s=bf9287db77d302988d850ff9406a814e)

At the Campaigns level in LinkedIn Campaign Manager, go to **URL tracking parameters** and add the parameters, or append them to the ones you already have. To copy them in Cometly, open **Setup**, step 4 **Add URL parameters to your ads**, choose **LinkedIn Ads** under **Select integration** and click **Copy Parameters**.

LinkedIn renamed its dynamic parameters in October 2025, and newer ad accounts use different names. [LinkedIn Ads URL parameters](https://docs.cometly.com/getting-started/url-parameters.md#linkedin-ads-url-parameters) lists both sets and shows how to append to existing parameters.

> [!WARNING]
>
> Cometly does not check LinkedIn ads for its parameters. A LinkedIn ad never shows a **UTM Setup Error**, and the **Tracking Status** column preset does not flag missing parameters, so check them yourself in Campaign Manager whenever you launch or edit an ad.

## Send conversions back (Conversion API)

The **LinkedIn** section of the Conversion API (**Events Manager**, then the **Conversion API** tab) sends your Cometly events to LinkedIn. You create a Conversions API conversion in LinkedIn Campaign Manager, turn on data sharing, and map each LinkedIn conversion to a Cometly event with a rule: **Send all events** or **Only send attributed events**. See [Configure the LinkedIn Conversion API](https://docs.cometly.com/guides/conversion-api/linkedin.md).

## What to expect after connecting

* **Data.** Active campaigns start populating within 30 to 60 minutes. After that, Cometly refreshes LinkedIn Ads data every 30 minutes and pulls the previous two days again once a day, so LinkedIn's later adjustments are captured.
* **Ads Manager.** The level tabs follow LinkedIn's structure: **Campaign Groups**, **Campaigns** and **Creatives**. Besides **Default**, the **Columns** menu has the presets **Delivery**, **All Events** and **Linkedin Forms**. If you have ads management permission, you can turn campaign groups, campaigns and creatives on or off, rename campaign groups and campaigns, and change a campaign's daily or lifetime budget from Cometly.
* **Lead forms.** Submissions of LinkedIn Lead Gen Forms on a connected ad account are recorded as leads. See [LinkedIn Lead Gen Form tracking](https://docs.cometly.com/integrations/forms/linkedin-lead-forms.md).
* **Campaigns.** New campaigns are picked up automatically while **Auto-track new campaigns** is on (**Settings**, then **Campaign tracking** under **Workspace**). If a campaign that was already running is missing, see [Manually turn on tracking](https://docs.cometly.com/support/troubleshooting/ad-data/manually-turn-on-tracking.md).
* **Status.** The row shows **Connected**, or **Connection Issue, Resync Required** when Cometly cannot load your ad accounts from LinkedIn: click **Resync** to sign in again (see [Ad data not syncing](https://docs.cometly.com/support/troubleshooting/ad-data/ad-data-not-syncing.md)). **Last Synced** is the last time Cometly renewed its connection to your LinkedIn profile, not the time of the last data refresh.
* **Disconnect.** At the top of the expanded row it removes your LinkedIn profile, and ad data stops tracking immediately in every space that uses its ad accounts. Next to one ad account it removes only that account from its space.

## Troubleshooting

### You received "Action Required: Resync LinkedIn Connection"

LinkedIn no longer accepts the sign-in made by the user named in the message, so ad data has stopped for that space. LinkedIn sign-ins expire: Cometly renews its access on its own for as long as LinkedIn allows, and after that LinkedIn requires you to sign in again. That user clicks **Resync** on the **LinkedIn Ads** row and signs in. Cometly posts this notification in the space and sends it by email. When data flows again you get **LinkedIn Connection Restored**, and the last 48 hours of data are restored automatically.

### The table says "No ad accounts found"

Your LinkedIn login has no business ad account that Cometly can list. Ask for access to the ad account in LinkedIn Campaign Manager, or have a user who has it connect instead, then click **Resync**.

### LinkedIn spend is missing from a dashboard report

A filter on a URL parameter can hide ad metrics. See [Troubleshoot LinkedIn data on a dashboard](https://docs.cometly.com/support/troubleshooting/ad-data/manually-turn-on-tracking.md#troubleshoot-linkedin-data-on-a-dashboard).

### Conversions do not appear in LinkedIn

See the [troubleshooting section of the LinkedIn Conversion API guide](https://docs.cometly.com/guides/conversion-api/linkedin.md#troubleshooting).

## Frequently asked questions

### Does Cometly import LinkedIn campaigns that were running before I connected?

Not retroactively. Cometly tracks a campaign from the moment its tracking is turned on, and from that point forward. For campaigns that were already running, see [Tracking historical ad data](https://docs.cometly.com/support/troubleshooting/ad-data/historical-ad-data.md).

### Do I need the LinkedIn Conversion API to see which LinkedIn ads produce conversions?

No. Cometly attributes conversions to your LinkedIn ads from the pixel on your landing pages and the URL parameters on your ads. The Conversion API is a separate step that sends those conversions back to LinkedIn.

## Next steps

* [Add URL parameters to your ads](https://docs.cometly.com/getting-started/url-parameters.md), so every LinkedIn click can be attributed to its campaign and ad.
* [Configure the LinkedIn Conversion API](https://docs.cometly.com/guides/conversion-api/linkedin.md) to send your Cometly events back to LinkedIn.
* [LinkedIn Lead Gen Form tracking](https://docs.cometly.com/integrations/forms/linkedin-lead-forms.md) to record lead form submissions as leads.
* [Use the Ads Manager](https://docs.cometly.com/guides/ads-manager/overview.md) to read your LinkedIn spend and conversions side by side.

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.