LinkedIn Ads Conversions API Reference
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
This is a reference document for the LinkedIn Ads destination. For information on how to set up this integration, see the LinkedIn Ads Conversions API Quick Start Guide.
Events
When you send an event to the LinkedIn Ads Conversions API destination from Freshpaint, Freshpaint will create an event in the LinkedIn campaign manager by hitting LinkedIn's API.
Track Events
When you send an event to the LinkedIn Ads Conversions API destination, you can track conversions from your ads based on those events.
Below are the Required, Recommended, and Optional properties which are mapped to the LinkedIn Ads Conversions API request:
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
conversionId
string
Required
A conversion 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
email
SHA256_EMAIL
string
Optional
Email hashed with SHA 256 algorithm. Used to improve match rates. Use with caution. LinkedIn will be able to match hashes with original emails if the emails are recorded in their system.
currency_code
currencyCode
string
Optional
Currency code in ISO format (e.g. "USD")
Must be provided with amount
amount
amount
string
Optional
Monetary amount as a decimal string (e.g. "50.0")
Must be provided with currency_code.
first_name
first_name
string
Optional
User's first name. Can improve match rates. Unmasked PII. Use with caution.
last_name
last_name
string
Optional
User's last name. Can improve match rates. Unmasked PII. Use with caution.
job_title
title
string
Optional
User's job title. Can improve match rates. Unmasked PII. Use with caution.
company_name
company_name
string
Optional
User's company name. Can improve match rates. Unmasked PII. Use with caution.
country_code
country_code
string
Optional
User's country code. Can improve match rates. Unmasked PII. Use with caution.
Last updated
Was this helpful?