Skip to main content
The LinkedIn Conversion API (LinkedIn calls it the Conversions API) is a server-to-server connection that lets Cometly send the conversions it tracks straight to your LinkedIn ad account. You create a conversion in LinkedIn Campaign Manager, then map it to a Cometly event (an action Cometly tracks, such as a lead or a purchase). This matters because LinkedIn can only optimize and report on the conversions it knows about. Once the mapping is saved, the leads and sales Cometly ties back to your ads are recorded on your LinkedIn campaigns, so LinkedIn’s reporting and optimization work from more complete data.

How it works and why it helps

Sending Cometly’s conversion data back to the LinkedIn ads platform gives LinkedIn more complete data to report on and optimize with. The video below comes from Cometly 101: How it works.

Before you start

  • Connect your LinkedIn ad account to the space. See Connect your ad platforms.
  • The person who connects LinkedIn needs the right roles on the ad account and on the company page. See Required permissions below.
  • Make sure the events you want to send are tracking accurately in Cometly.

Step 1: Create a Conversions API conversion in LinkedIn

Do this in LinkedIn Campaign Manager.
  1. Click Analyze, then Conversion tracking.
    LinkedIn Campaign Manager side menu with arrows on Analyze and Conversion tracking
  2. Click Create conversion, then Conversions API.
    LinkedIn Conversion tracking page with the Create conversion menu open and Conversions API highlighted
  3. Fill in the conversion settings. We recommend:
    • Define the key conversion behavior you want to track: select an option in 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 as the integration.
    LinkedIn Create conversions API conversion screen, Sources step, with an arrow on Direct API
  5. Select the campaigns you want to track with this conversion and click Create.
    LinkedIn Create conversions API conversion screen, Campaigns step, with one campaign ticked

Step 2: Map the LinkedIn conversion to a Cometly event

  1. In Cometly, click Events Manager in the sidebar, open the Conversion API tab, and click the LinkedIn row to expand it.
    Cometly Conversion API tab in Events Manager listing the ad platform rows, with an arrow pointing at the LinkedIn row
  2. Under Manage data sharing, select Turn on data sharing. The change is saved straight away.
  3. Under LinkedIn ad account, select the account that holds the conversion you created. Cometly lists that account’s enabled Conversions API conversions under LinkedIn conversions.
  4. For each LinkedIn conversion you want to use, pick the event to send under Cometly events, then choose a Rule:
    • Send all events: sends every occurrence of the event to this LinkedIn account, whether or not it is attributed to one of its ads.
    • Only send attributed events: sends the event only when Cometly attributed it to this LinkedIn account.
  5. Click Save.
    Expanded LinkedIn row with Turn on data sharing selected, an ad account chosen and LinkedIn conversions mapped to Cometly events with a Rule, with arrows on the first mapped Cometly events dropdown and the Save button
From now on, whenever Cometly tracks a mapped event, it sends the data to LinkedIn and records it on the LinkedIn conversion you selected.

Check it worked

On the Conversion API tab, the LinkedIn row now shows an Active badge. When you expand the row and select the same account under LinkedIn ad account, each LinkedIn conversion shows the Cometly event and Rule you saved. After the next mapped event is tracked, look for it on the conversion in LinkedIn Campaign Manager. Cometly sends it about 15 minutes after the event, and LinkedIn can take up to 48 hours to process it.

Required permissions

The person who connects LinkedIn to Cometly must have the correct permissions on both the LinkedIn ad account and the LinkedIn company page. If either is missing, the connection fails or conversions do not sync.

Ad account role

The connecting user needs one of these 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 the Conversions API entirely. To check your role, go to LinkedIn Campaign Manager > Account settings > Manage access.

Page admin role

The connecting user also needs one of these roles on the LinkedIn company page linked to the ad account:
  • Super Admin
  • Content Admin
This is the most commonly missed requirement. To check your role, go to your company page > Settings > Manage admins.

Troubleshooting

No ad accounts show up during setup The user who connected LinkedIn probably only has Viewer access. Have an Account Manager or Campaign Manager connect instead. The connection works but no conversions appear
  • Cometly sends each conversion about 15 minutes after the event is tracked. Allow up to 48 hours for LinkedIn to process it.
  • Confirm the conversion is associated with the correct campaigns in LinkedIn Campaign Manager.
  • Confirm the contact has an email address. Cometly identifies the person to LinkedIn by a hashed email.
  • Confirm the event is mapped to the LinkedIn conversion, and check its Rule: with Only send attributed events, conversions that Cometly did not attribute to this LinkedIn account are not sent.
Permissions changed after connecting If the connecting user’s role is 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.

Frequently asked questions

Why is my LinkedIn conversion not showing in Cometly?

Cometly only lists conversions that are enabled in LinkedIn and were created with the Conversions API method. A conversion created another way, for example with the Insight Tag, does not appear. Create a new conversion as described in Step 1, then select the account again under LinkedIn ad account to reload the list.

What conversion value does Cometly send to LinkedIn?

If the Cometly event has an amount, Cometly sends that amount in your space’s currency (a space is one workspace in Cometly, usually one business or website). If the event has no amount, Cometly sends the value set on the LinkedIn conversion itself.

Can I use the LinkedIn Conversion API with more than one ad account?

Yes. Each LinkedIn ad account has its own mapping. Select each account in turn under LinkedIn ad account, map its conversions to Cometly events, and click Save for each one.

Next steps

Still have questions or need a hand? We’re happy to help. Reach our team at support@cometly.com.