LinkedIn Ads Conversions API Quick Start Guide

Destination Info

Client-side
Server-side

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.

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

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

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

  1. Log in to your LinkedIn campaign manager account

  2. Select the ‘Measurement tab’ on the left toolbar

  3. Select ‘Conversion tracking’

  4. Click into the applicable conversion event.

  5. 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}

    1. The conversion rule ID should begin with urn:

Enable LinkedIn Ads Events

  1. Navigate to the Event Library.

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

  3. At the bottom of the event page enable LinkedIn Ads Conversions API.

Connect Conversion ID to Events

  1. Click the Create New button.

  2. Select Modify Data.

    • Select your event (in this demo we will select Page View) .

    • Select LinkedIn Ads Conversions API for the destination.

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

Send conversion_id as a constant property transformation

Confirm and Validate Conversions in Freshpaint

  1. Navigate to your site and visit a page that should trigger your event (For demonstration purposes we will use FreshHealth.co).

  2. Add a query parameter called li_fat_id to the URL (Example: https://www.freshhealth.co/?li_fat_id=TEST).

  3. Trigger your event (Our demonstration event is any Page View).

  4. Navigate to the Event Verification tool.

  5. Select LinkedIn Ads Conversions API and verify your event went through.

    • This can take up to 90 seconds.

  6. Verify the event is marked as OK or resolve missing property issues.

Our LinkedIn Ads event went through smoothly with all required properties in place

Confirm and Validate Conversions in LinkedIn

To check whether LinkedIn Ads is receiving events.

  1. Click Analyze > Conversion tracking on the left menu.

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

Example of conversion with no data

Required Properties

The following event properties are required in order to attribute events to specific ads, and if in HIPAA mode, must be selected in the Required Properties Allow List.

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?