Kochava IdentityLink

Send identity graph data to Kochava IdentityLink for cross-device identity resolution and audience linking.

⚠️

This integration is currently in beta. Configuration and behaviour may change.

Prerequisites

Complete these steps in the Kochava dashboard before configuring Signal. IdentityLink is an add-on feature that must be enabled on your Kochava account.

Create a Kochava account

Sign up at kochava.com and log in to the Kochava dashboard. If you already have a Kochava account, log in with your existing credentials.

Enable IdentityLink

Contact your Kochava account manager or submit a request through the Kochava dashboard to enable the IdentityLink feature on your account. This feature is not available by default and requires activation.

Register your app

If you have not already done so, click Add App in the dashboard and register the app you want to link identities for. Note the App GUID from the app’s settings page.

Find your API key

Navigate to Account Settings > API Keys or the app’s Settings > API Credentials. Copy your API Key. This authenticates IdentityLink API calls.

Obtain your Partner ID

Your Kochava account manager will assign a Partner ID for your IdentityLink integration. This ID identifies your organisation within the IdentityLink identity graph. Request it directly from your account manager if you do not have it.

Define identity mapping strategy

Work with your Kochava account manager to define which identity types you will link (e.g. email hashes, device IDs, customer IDs). This determines the fields your blueprint needs to map.

Configuration

Field	Type	Required	Description
`app_guid`	string	Yes	The Kochava App GUID associated with the IdentityLink integration.
`api_key`	secret	Yes	The Kochava API key for authenticating IdentityLink API calls.
`partner_id`	string	Yes	Your Kochava Partner ID assigned for IdentityLink.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Kochava IdentityLink or filter by Attribution.
Click Install, select a variant if available, and fill in the required fields.
Click Install Integration to create the integration with a ready-to-use default blueprint.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/kochava_identitylink/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Kochava IdentityLink",
    "variant": "default",
    "config": {
      "app_guid": "koexample-app-guid-1234",
      "api_key": "your_api_key",
      "partner_id": "partner-abc-123"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal events are mapped to Kochava IdentityLink identity sync calls via your blueprint. Common mappings include:

Signal Event	IdentityLink Mapping	Notes
`identify`	Identity link call	Maps user identifiers (email hash, customer ID, device ID) to the identity graph
`login`	Identity link call	Links authenticated user identifiers to device identifiers
`sign_up`	Identity link call	Establishes initial identity links for new users

IdentityLink works by associating multiple identifiers for the same user. Ensure your events include at least two different identifier types (e.g. hashed email + device ID) for effective cross-device linking.

Testing

Send a test identity event through Signal using the Test Event button on the integration detail page.
Include at least two identifier types (e.g. a hashed email and a device ID) in the test payload.
Contact your Kochava account manager to confirm the identity link was received and processed.
Check Live Logs in Signal to confirm delivery returned 200 OK.
Verify cross-device audience reports in the Kochava dashboard reflect the linked identities.

Troubleshooting

Symptom	Cause	Resolution
`401 Unauthorized`	Invalid API key	Verify `api_key` in Kochava Account Settings and update Signal.
`400 Bad Request`	Missing required identifiers	Ensure the event payload includes at least one valid identifier type.
Identity links not appearing	IdentityLink not enabled	Confirm IdentityLink is active on your account with your Kochava account manager.
Wrong partner	Incorrect `partner_id`	Verify the Partner ID with your Kochava account manager.
Partial linking	Single identifier only	Include multiple identifier types per event for cross-device resolution.

Visit Kochava IdentityLink documentation for full API reference and credential setup instructions.

Kochava Rakuten Conversions