LinkedIn Conversion API Connector
LinkedIn’s Conversion API (CAPI) enables you to send conversion data for online and offline events directly to LinkedIn, making conversion tracking more accurate and reliable. This connector supports sending personally identifiable information (PII) and anonymous IDs for improved match quality, leveraging the full scope of your customer profile data through data graphs for ID enrichment.
- Available with add-on license: Ad Audiences
- Structured
The direction of available connection methods.
Create a connection for sending conversion events to external platforms.
Supported connection method(s):
- Streaming
- Direct API
Once the connection is set up, conversion events are sent to LinkedIn Business Manager using LinkedIn’s Conversions API.
- API limits: The number of requests is capped at a maximum of 600 requests per minute and 300,000 requests per day. You can use batch requests (up to 5,000 events in one batch) to avoid hitting rate limits.
- Event Validity: Send an event to LinkedIn within 90 days of when it actually happened. If you send data for an event older than 90 days, it's automatically rejected.
Here are the attributes that you can activate to LinkedIn, along with related details.
| Attribute Display Name | Description | Recommended DMO Mapping | Data Type | Data Ingestion Format | Encryption State for Activation | Optional or Required |
|---|---|---|---|---|---|---|
| user_userlds_email | Email address of the user | ContactPointEmail > EmailAddress | String | Standard Email, formatted internally for hashing and activating | Encrypted with SHA256 | Required |
| conversionHappenedAt | Time of the conversion event | String | Epoch timestamp in milliseconds | Required | ||
| eventld | A unique, advertiser-generated string used to identify a specific conversion event instance. | String | Plain text, maximum length of 64 characters | Required | ||
| user_userinfo_firstName | User's legal first name | Individual > FirstName | String | Plain text, maximum length of 35 characters | Optional | |
| user_userinfo_lastName | User's legal last name | Individual > LastName | String | Plain text, maximum length of 35 characters | Optional | |
| user_userinfo_title | Professional job title | String | Plain text, maximum length of 50 characters | Optional | ||
| user_userinfo_companyName | Name of the employer | String | Plain text, maximum length of 50 characters | Optional | ||
| user_userinfo_countryCode | User's location country | String | ISO-standardized two letter country code | Optional | ||
| conversionValue_currencyCode | Currency of the value | String | ISO-standardized currency code | Optional | ||
| conversionValue_amount | Monetary value of event | Decimal String | Decimal string (e.g., "100.05") | Optional | ||
| user_userlds_linkedinFirstPartyTrackingUUID | LinkedIn Click ID | String | Optional | |||
| user_externalids | Your internal unique ID | List (string) | Currently LinkedIn’s maximum list size is 1 - LinkedIn will select the first value. | Optional |
If you send the firstName attribute, send the lastName attribute as well.