Skip to main content

Configure the Cometly LinkedIn Conversion API

Learn how to configure the Cometly Conversion API for LinkedIn to send accurate data back to the LinkedIn ad platform.

Updated this week

How does this work & what are the benefits?

Passing Cometly's high quality data back to the Meta ads platform has many benefits.

Video below sourced from: Cometly 101: How it works

How to configure the Cometly LinkedIn conversion API

The information below outlines the setup steps for configuring the Cometly LinkedIn Conversion API.

Navigate to your LinkedIn Ads Campaign Manager to configure your conversion events

  1. Click "Analyze" and then "Conversion Tracking"

2. Select "Create Conversion" and "Conversion API"

3. Create your conversion (Recommended settings below)

"Define the key conversion behavior you want to track" - Select an option inside the "Lead" or "Sale" category

"Select the timeframe for when the conversion can be counted" - Select 90 days for both Clicks and Views

"Select the attribution model to specify how each ad interaction is credited" - Select "Last Touch - Each Campaign"

4. Select "Direct API" for the integration

5. Select the campaign you want to track with this specific conversion and click "Create"

6. Now navigate to Cometly "Conversion API" page to map the LinkedIn Conversion to the desired event inside Cometly

7. You'll see your LinkedIn conversion event on the left, now you can Map this conversion to the event inside of Cometly on the right

And then click "SAVE"

When you do this, whenever Cometly tracks that event, it will pass the data to LinkedIn and fire on your selected LinkedIn conversion event


LinkedIn Conversion API: Required Permissions

Before connecting the LinkedIn Conversion API, the person authenticating the connection must have the correct permissions on both the LinkedIn Ad Account and the LinkedIn Company Page. If either is missing, the connection will fail or conversions won't sync.

Ad Account Role

The connecting user needs one of the following roles on the LinkedIn Ads account:

  • Account Manager

  • Campaign Manager

  • Creative Manager

  • Billing Admin

Viewer access will not work. LinkedIn blocks Viewer-level users from accessing the Conversions API entirely.

  • You can check your role by going to LinkedIn Campaign Manager β†’ Account Settings β†’ Manage access.

Page Admin Role

The connecting user also needs one of the following roles on the LinkedIn Company Page linked to the ad account:

  • Super Admin

  • Content Admin

This is the most commonly missed requirement. You can check your role by going to your Company Page β†’ Settings β†’ Manage admins.

Troubleshooting Permission Issues

No ad accounts show up during setup:

  • The authenticating user likely only has Viewer access. Have an Account Manager or Campaign Manager connect instead.

Connection works but no conversions appear:

  • Allow up to 24 hours for data to push, plus another 48 hours for LinkedIn to process it. Also confirm the conversion is associated with the correct campaigns in LinkedIn Campaign Manager, and that contacts have either a LinkedIn click ID (li_fat_id) or an email address.

Permissions changed after connecting:

  • If the connecting user's role gets downgraded to Viewer or their Page admin access is removed, the sync may break. Disconnect and reconnect with a user who has the required permissions.

Did this answer your question?