LinkedIn Conversions API

LinkedIn CAPI

LinkedIn is a business and employment-focused social media platform. Using this destination you can stream conversion events to LinkedIn through their Conversions API. This allows to measure the performance of your LinkedIn marketing campaigns no matter where the conversion happens and use this data to power campaign optimization. This destination can help strengthen performance and decrease cost per action with more complete attribution, improved data reliability, and better optimized delivery.

Key features

The LinkedIn destination provides the following key features:

• Events structure: our Events reference model matches LinkedIn's conversion rules, meaning that your data is properly bridged to the expected fields in an optimized way.

• Prebuilt mappings: data mapping for event-based destinations happens automatically, which simplifies user inputs.

• Automatic hashing: information is automatically hashed matching partner specifications.

• Smart mapping: data mapping can be readjusted using your datalayer defined fields.

Destination setup

Before using this destination, review your conversion rules and campaigns in LinkedIn:

First, ensure at least one conversion rule is defined in LinkedIn by accessing your Campaign Manager account and select Analyze (1) → Conversion tracking (2) from the left menu:

You can also create a new conversion rule by clicking Create conversion (3) → Conversions API or CSV conversion (4) :

Lastly, you need to associate your conversion rule with one or more campaigns. From the Conversion tracking section, click your conversion rule and reach step 3 where you can select the campaigns you want to track with the conversion:

In order to set the optional "Smart Mapping" field Linkedin UUID or the related cookie li_fat_id , advertisers need to enable enhanced conversion tracking from Campaign Manager. This activates first party cookies that append a click identifier parameter ("li_fat_id") to the click URLs. Refer Enabling Click Ids for implementation details.

LinkedIn CAPI supports deduplication with your client-side Insight Tag. Check the "Smart Mapping" field Event Id , Field Mappings (See property eventId ) or this LINK for more details.

Configuration

Settings	Description
Credentials	Required if API Token is not provided Your credentials with LinkedIn Campaign Manager as set in the Commanders Act interface following: Administration ➜ Connector Credentials ➜ Add connector credentials ➜ LinkedinAds
API Token	Required if Credentials is not provided Select Use API Token to input your API Token. This can be found in your Campaign Manager account by following Data → Signals manager → Direct API → Generate access token. At least one of the following is required: Credentials or API Token, and the latter has priority over the former.
Mapping	Required Map LinkedIn conversion rules with your events by setting at least a couple Conversion rule name and Your event name . One entry is required. You can create/edit a conversion rule by accessing your Campaign Manager account and select "Analyze" → "Conversion tracking" from the left menu.

Quick reference

Commanders Act Events	LinkedIn Tracking
[Any Event] [1]	[Any Conversion Rule] [2]

1. Use Destination filters to specify your matching events. 2. See Conversion Rule Name in Configuration for more details.

Field mappings

Properties can be remapped using our Smart Mapping feature.

At least one of the following "Smart Mapping" fields must be set with a proper value unless other valid user identifier is provided: • User Email SHA256 • Linkedin UUID or the cookie li_fat_id • LiveRamp ACXIOM Id • Oracle MOAT Id • Device IP • Device Mobile Identifier Moreover, If you send any user information via "Smart Mapping" fields (User Company Name , User Job Title , or User Country ), you must set the User First Name and User Last Name fields regardless if you provide other identity values listed above. More details are available following this LINK.

Smart Mapping Fields	Commanders Act Default Properties	LinkedIn Properties
-	Conversion rule name	conversion [1][*]
Event Timestamp	context.event_timestamp	conversionHappenedAt [*]
Transaction Value	value	conversionValue.amount
Currency	currency	conversionValue.currencyCode
Event Id	context.event_id	eventId [2]
User Email SHA256 Linkedin UUID LiveRamp ACXIOM Id Oracle MOAT Id Device IP Device Mobile Identifier	user.email_sha256 partners.linkedin.uuid partners.linkedin.acxiom_id partners.linkedin.moat_id context.device.ip context.device.advertising_id	user.userIds.X.idValue [3]
User Email SHA256 Linkedin UUID LiveRamp ACXIOM Id Oracle MOAT Id Device IP Device Mobile Identifier	user.email_sha256 partners.linkedin.uuid partners.linkedin.acxiom_id partners.linkedin.moat_id context.device.ip context.device.advertising_id	user.userIds.X.idType [4]
User First Name	user.firstname	user.userInfo.firstName
User Last Name	user.lastname	user.userInfo.lastName
User Country	user.country	user.userInfo.countryCode
User Job Title	user.title	user.userInfo.title
User Company Name	user.company_name	user.userInfo.companyName

* Mandatory property. 1. Value includes the static string "urn:lla:llaPartnerConversion:". See Mapping in Configuration for more details. 2. The unique id generated by advertisers to indicate each event. This is used for deduplication. More details are available following this LINK. 3. If a clear text user email is provided, it's automatically hashed via SHA256. The "Smart Mapping" field Linkedin UUID has priority over the cookie li_fat_id . 4. Depending on the value being set in user.userIds.X.idValue , this is one of the following strings: • SHA256_EMAIL • LINKEDIN_FIRST_PARTY_ADS_TRACKING_UUID • ACXIOM_ID • ORACLE_MOAT_ID • PLAINTEXT_IP_ADDRESS • GOOGLE_AID More details are available following this LINK.