LinkedIn Ads Conversions API Quick Start Guide
Destination Info
Supports Track calls
Supports HIPAA mode
Supports forwarding from the Google Tag Manager Integration
Refer to this destination as LinkedIn Ads Conversions API in the Integrations object
Connection Modes:
Web
Mobile
Server
Getting Started
This guide enables you to fully enable the LinkedIn Ads Conversions API destination for your site. For simplicity the event used for demonstration purposes is the generic Page View
event. For more complex events see our additional documentation. Additionally this guide assumes you have the Freshpaint snippet installed on your site, if you do not please follow this guide.
Enable the Freshpaint LinkedIn Ads destination
If in HIPAA mode enable the required fields
Configure Freshpaint
To configure your LinkedIn Ads Conversions API destination you will need to connect with LinkedIn via OAuth 2.0. Click the "Connect With LinkedIn" button on the destination configuration page to get started. You must have one of the following Ad Account Roles in LinkedIn to authenticate:
Account Billing Admin
Account Manager
Campaign Manager
Creative Manager

Optional: Customers that use HIPAA mode should then configure the required properties and enable
$li_fat_id
andconversion_id

Click "Enable"
Once you've successfully authenticated and follow the steps above you can start sending events to LinkedIn Conversions API.
Finding the conversion ID
To configure your LinkedIn Ads Conversions API destination events, you'll first need at least one Conversion Rule.
Log in to your LinkedIn campaign manager account
Select the ‘Measurement tab’ on the left toolbar
Select ‘Conversion tracking’
Click into the applicable conversion event.
Reference the 2nd ID listed in the URL string – this is your conversion ID:
https://www.linkedin.com/campaignmanager/accounts/{account_id}/conversions/{conversion_id}
The conversion rule ID should begin with
urn:
Conversion rules must have a data source of 'Direct API', otherwise conversion events will not be able to be streamed to your account.
Enable LinkedIn Ads Events
Navigate to the Event Library.
Select/create the event you want your
conversion_id
to be associated with.In this example we are going to associate it with every page view for demonstration purposes.
At the bottom of the event page enable
LinkedIn Ads Conversions API
.

Connect Conversion ID to Events
Navigate to Event Transformations.
Click the
Create New
button.Select
Modify Data.
Select your event (in this demo we will select
Page View
) .Select
LinkedIn Ads Conversions API
for the destination.
Set the following values for the transform fields.
Send Constant Property
for transform type.Your conversion ID for the property value.
Text
for the property type.conversion_id
for property name.

Confirm and Validate Conversions in Freshpaint
Navigate to your site and visit a page that should trigger your event (For demonstration purposes we will use FreshHealth.co).
Add a query parameter called
li_fat_id
to the URL (Example: https://www.freshhealth.co/?li_fat_id=TEST).Trigger your event (Our demonstration event is any
Page View
).Navigate to the Event Verification tool.
Select
LinkedIn Ads Conversions API
and verify your event went through.This can take up to 90 seconds.
Verify the event is marked as
OK
or resolve missing property issues.

Confirm and Validate Conversions in LinkedIn
To check whether LinkedIn Ads is receiving events.
Click
Analyze > Conversion tracking
on the left menu.Click on
Data sources
in the middle of the screen.
The source status should show up as Active
if receiving events from your website. More information on status definitions is available in the official LinkedIn documentation.

Required Properties
Freshpaint property
LinkedIn Ads parameter
Type
Requirement
Description
$li_fat_id
LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID
string
Required
A query parameter that connects a page view or conversion event to a specific ad, which Freshpaint captures as $li_fat_id
conversion_id
conversion
string
Required
A conversion rule ID provided by LinkedIn that allows you to trigger a specific event.
The conversion ID will have a similar format to: urn:li:sponsoredAccount:5123456
Last updated
Was this helpful?