LinkedIn Conversions API
Send server-side conversion events to LinkedIn for attribution and campaign optimization. Server-side events provide more reliable measurement data compared to browser-based tracking.
Prerequisites
- A LinkedIn Campaign Manager account
- Your LinkedIn Ad Account ID (numeric)
- A conversion rule configured in Campaign Manager
- The conversion rule ID
Authentication
LinkedIn Conversions API uses OAuth 2.0.
- Click Connect with OAuth in Zeotap
- Sign in with your LinkedIn account
- Authorize the requested permissions
OAuth scopes: r_ads, rw_conversions.
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Conversion ID | Text | Yes | The LinkedIn conversion rule ID to send events to |
| Account ID | Text | Yes | Your LinkedIn Ad Account ID (numeric) |
Supported Operations
Sync Modes
| Mode | Supported |
|---|---|
| Insert | Yes |
| Update | — |
| Upsert | — |
| Mirror | — |
Audience Sync Modes
| Mode | Supported |
|---|---|
| Add | Yes |
| Remove | — |
| Mirror | — |
| Upsert | — |
Features
| Feature | Supported |
|---|---|
| Field Mapping | Yes |
| Schema Introspection | No |
Required Mapping Fields
| Field | Description |
|---|---|
email or hashed_email | User identifier for conversion matching. Provide either a raw email (auto-hashed by Zeotap) or a pre-hashed SHA256 email |
Default Destination Fields
Event
| Field | Description |
|---|---|
email | User email address (auto-hashed before sending) |
hashed_email | Pre-hashed SHA256 email (passed through without re-hashing) |
conversion_value | Monetary value of the conversion |
currency_code | ISO 4217 currency code (e.g., USD, EUR) |
event_id | Your unique event identifier for deduplication |
How It Works
Zeotap reads rows from your model query and applies field mapping to transform your data into LinkedIn’s Conversions API format.
PII hashing: Raw email fields are automatically normalized and hashed with SHA256 per LinkedIn’s requirements before being sent. Pre-hashed fields (hashed_email) are passed through without re-hashing.
Individual events: LinkedIn requires one API call per conversion event. Zeotap sends each row as an individual POST to the conversionEvents endpoint.
Conversion value: If conversion_value and currency_code are mapped, they are included in the conversion event payload for revenue attribution.
Rate Limits
- 1 event per API call — LinkedIn requires individual POST requests per conversion event
- LinkedIn Marketing API rate limits apply based on your application’s access tier
Troubleshooting
Invalid Conversion ID
Verify your conversion rule ID in LinkedIn Campaign Manager under Analyze > Conversion Tracking. The ID should be numeric.
Permission denied
Ensure the authenticated LinkedIn user has Campaign Manager access with conversion tracking permissions. The OAuth scopes r_ads and rw_conversions are required.
Events not appearing
Conversion events may take up to 24 hours to appear in LinkedIn reporting. Verify that the conversion rule is active and correctly configured in Campaign Manager.
Token expired
LinkedIn OAuth tokens expire after 60 days. Zeotap automatically refreshes tokens when refresh credentials are available. If authentication fails, reconnect via OAuth.