What Is Kochava?

Kochava is a mobile attribution and analytics platform that enables marketers to measure and optimize user acquisition campaigns. It provides real-time insights into install and post-install activity across devices and channels. Kochava supports deep linking, fraud prevention, and audience targeting, helping brands drive better ROI from mobile marketing efforts.

Product Type: Mobile Attribution

Integration Type: Starter Kit

Event Source Type: Web & Mobile

Event Scope: Full-Funnel Events

Capabilities

Tracks installs and post-install events for mobile apps
Supports event ingestion via server-to-server API
Provides detailed payloads for eCommerce, engagement, and lifecycle events
Enriches event data with user device and app metadata

Considerations

Events like identify are excluded from Kochava delivery
- Please see the Kochava Identity Link integration for identity use case
Ensure device IDs such as IDFA, ADID, or anonymous ID are included for attribution
Currency values are normalized to uppercase; default is USD if none provided

Limitations

Integration is limited to event delivery and does not support ad campaign management or delivery
Identity resolution is not supported within this starter kit; use Identity Link for that use case

Starter Kit Setup Guide

1. Gather Credentials

Ask vendor representatives for the following credentials:

KOCHAVA_APP_ID: Your unique Kochava application identifier

2. Add a Kochava Integration

From the integration library, add a Kochava integration. Then, fill out the Connection Parameters:

Connection Parameter	Description
`KOCHAVA_APP_ID`	Your Kochava app ID used to route events to the correct app.

3. Configure Event Mapping

MetaRouter provides all of the event mappings that Kochava integrations typically require. You may add custom events, parameters, or mappings in accordance with Kochava’s API documentation.

4. Deploy to Pipeline

In the Pipelines tab, add your Kochava integration.
Select the correct integration revision
Click Add Integration to finalize deployment.

Event Mappings

Global

Output Key	Description	Expected Input
`kochava_app_id` Required	String: Kochava application ID.	`$$KOCHAVA_APP_ID$$`
`kochava_device_id` Required	String: Anonymous user or device ID.	`anonymousId`
`data.device_ver` Required	String: Operating system version.	`context.os.version`
`data.app_tracking_transparency.att` Required	Boolean: ATT status for iOS devices.	`context.device.adTrackingEnabled`
`data.device_ids` Required	Assigns IDFA/IDFV for iOS and ADID/Android ID for Android.	Expression – auto-generates device identifiers
`data.origination_ip` Required	String: IP address of the user.	`context.ip`
`data.device_ua` Required	String: User agent string.	`context.userAgent`
`data.app_version`	String: App version running on the device.	`context.app.version`
`data.usertime`	Integer: Event timestamp in milliseconds.	Expression – convert RFC3339 timestamp to epoch
`data.event_data.referrer`	String: Referrer URL of the page.	`context.page.referrer`

Event Specific

Application Installed

Output Key	Description	Expected Input
`action` Required	String: Event type.	Enrichment – `'install'`
`data.event_data.device_model`	String: Device model.	`context.device.model`

Products Searched

Output Key	Description	Expected Input
`action` Required	String: Event type.	Enrichment – `'event'`
`data.event_name`	String: Name of the event.	Enrichment – `'Search'`
`data.event_data.query`	String: Search query.	`properties.query`

Product List Viewed

Output Key	Description	Expected Input
`action` Required	String: Event type.	Enrichment – `'event'`
`data.event_name`	String: Name of the event.	`event`
`data.event_data.sum`	Float: Total value of listed products.	Expression – sum of product values
`data.event_data.currency`	String: ISO currency code.	`properties.currency`
`data.event_data.content_ids`	Array: Product IDs.	`properties.products.product_id`
`data.event_data.contents`	Array: Detailed product info.	Expression – map to `content_id`, `name`, `quantity`, `price`

Product Viewed

Output Key	Description	Expected Input
`action` Required	String: Event type.	Enrichment – `'event'`
`data.event_name`	String: Name of the event.	`event`
`data.event_data.sum`	Float: Product value.	Expression – sum of product value
`data.event_data.currency`	String: ISO currency code.	`properties.currency`
`data.event_data.content_ids`	Array: Product ID.	Expression – from `properties.product_id`
`data.event_data.contents`	Array: Product details.	Expression – create object with `id`, `name`, `quantity`, `price`

Product Added

Output Key	Description	Expected Input
`action` Required	String: Event type.	Enrichment – `'event'`
`data.event_name`	String: Name of the event.	Enrichment – `'Add to Cart'`
`data.event_data.sum`	Float: Product value.	Expression – sum of product value
`data.event_data.currency`	String: ISO currency code.	`properties.currency`
`data.event_data.content_ids`	Array: Product ID.	Expression – from `properties.product_id`
`data.event_data.contents`	Array: Product details.	Expression – create object with `id`, `name`, `quantity`, `price`

Cart Viewed

Output Key	Description	Expected Input
`action` Required	String: Event type.	Enrichment – `'event'`
`data.event_name`	String: Name of the event.	`event`
`data.event_data.sum`	Float: Total cart value.	Expression – sum of product values
`data.event_data.currency`	String: ISO currency code.	`properties.currency`
`data.event_data.content_ids`	Array: Product IDs.	`properties.products.product_id`
`data.event_data.contents`	Array: Product details.	Expression – create objects with `content_id`, `name`, `quantity`, `price`

Checkout Started

Output Key	Description	Expected Input
`action` Required	String: Event type.	Enrichment – `'event'`
`data.event_name`	String: Name of the event.	Enrichment – `'Checkout Start'`
`data.event_data.sum`	Float: Total checkout value.	Expression – sum of product values
`data.event_data.currency`	String: ISO currency code.	`properties.currency`
`data.event_data.content_ids`	Array: Product IDs.	`properties.products.product_id`
`data.event_data.contents`	Array: Product details.	Expression – create objects with `content_id`, `name`, `quantity`, `price`

Order Completed

Output Key	Description	Expected Input
`action` Required	String: Event type.	Enrichment – `'event'`
`data.event_name`	String: Name of the event.	Enrichment – `'Purchase'`
`data.event_data.transaction_id`	String: Order ID.	`properties.order_id`
`data.event_data.sum`	Float: Order value.	Expression – sum of product values
`data.event_data.currency`	String: ISO currency code.	`properties.currency`
`data.event_data.content_ids`	Array: Product IDs.	`properties.products.product_id`
`data.event_data.contents`	Array: Product details.	Expression – create objects with `content_id`, `name`, `quantity`, `price`

Required & Recommended Identifiers

These identifiers must be mapped to Kochava in order for successful user matching to occur. Without these IDs, any events sent to Kochava may not be accurately reflected in reporting.

Attribute	Example	Sync Injector Required?
`kochava_device_id` Required	abcd1234efgh5678	No
`data.origination_ip` Required	73.220.15.94	No
`data.device_ua` Required	Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.5735.198 Safari/537.36	No
`idfa` Recommended	AEBE52E7-03EE-455A-B3C4-E57283966239	No
`idfv` Recommended	00000000-0000-0000-0000-000000000000	No
`adid` Recommended	38400000-8cf0-11bd-b23e-10b96e40000d	No
`android_id` Recommended	c4d9d60f29f53e5e	No

Integration Validation

To validate event delivery in the Kochava UI:

Log in to your Kochava account.
Navigate to Event Manager under Apps & Assets in the left-hand menu.
Use this interface to verify that your events are being received, and to inspect event names and parameters.

Additional Kochava Documentation