Documentation

Kochava

Suggest Edits

📘

This integration is currently in beta. Contact your MetaRouter support team to get started.

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 ParameterDescription
KOCHAVA_APP_IDYour 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 KeyDescriptionExpected 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_versionString: App version running on the device.context.app.version
data.usertimeInteger: Event timestamp in milliseconds.Expression – convert RFC3339 timestamp to epoch
data.event_data.referrerString: Referrer URL of the page.context.page.referrer

Event Specific

Application Installed

Output KeyDescriptionExpected Input
action
Required		String: Event type.Enrichment – 'install'
data.event_data.device_modelString: Device model.context.device.model

Products Searched

Output KeyDescriptionExpected Input
action
Required		String: Event type.Enrichment – 'event'
data.event_nameString: Name of the event.Enrichment – 'Search'
data.event_data.queryString: Search query.properties.query

Product List Viewed

Output KeyDescriptionExpected Input
action
Required		String: Event type.Enrichment – 'event'
data.event_nameString: Name of the event.event
data.event_data.sumFloat: Total value of listed products.Expression – sum of product values
data.event_data.currencyString: ISO currency code.properties.currency
data.event_data.content_idsArray: Product IDs.properties.products.product_id
data.event_data.contentsArray: Detailed product info.Expression – map to content_id, name, quantity, price

Product Viewed

Output KeyDescriptionExpected Input
action
Required		String: Event type.Enrichment – 'event'
data.event_nameString: Name of the event.event
data.event_data.sumFloat: Product value.Expression – sum of product value
data.event_data.currencyString: ISO currency code.properties.currency
data.event_data.content_idsArray: Product ID.Expression – from properties.product_id
data.event_data.contentsArray: Product details.Expression – create object with id, name, quantity, price

Product Added

Output KeyDescriptionExpected Input
action
Required		String: Event type.Enrichment – 'event'
data.event_nameString: Name of the event.Enrichment – 'Add to Cart'
data.event_data.sumFloat: Product value.Expression – sum of product value
data.event_data.currencyString: ISO currency code.properties.currency
data.event_data.content_idsArray: Product ID.Expression – from properties.product_id
data.event_data.contentsArray: Product details.Expression – create object with id, name, quantity, price

Cart Viewed

Output KeyDescriptionExpected Input
action
Required		String: Event type.Enrichment – 'event'
data.event_nameString: Name of the event.event
data.event_data.sumFloat: Total cart value.Expression – sum of product values
data.event_data.currencyString: ISO currency code.properties.currency
data.event_data.content_idsArray: Product IDs.properties.products.product_id
data.event_data.contentsArray: Product details.Expression – create objects with content_id, name, quantity, price

Checkout Started

Output KeyDescriptionExpected Input
action
Required		String: Event type.Enrichment – 'event'
data.event_nameString: Name of the event.Enrichment – 'Checkout Start'
data.event_data.sumFloat: Total checkout value.Expression – sum of product values
data.event_data.currencyString: ISO currency code.properties.currency
data.event_data.content_idsArray: Product IDs.properties.products.product_id
data.event_data.contentsArray: Product details.Expression – create objects with content_id, name, quantity, price

Order Completed

Output KeyDescriptionExpected Input
action
Required		String: Event type.Enrichment – 'event'
data.event_nameString: Name of the event.Enrichment – 'Purchase'
data.event_data.transaction_idString: Order ID.properties.order_id
data.event_data.sumFloat: Order value.Expression – sum of product values
data.event_data.currencyString: ISO currency code.properties.currency
data.event_data.content_idsArray: Product IDs.properties.products.product_id
data.event_data.contentsArray: 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.

AttributeExampleSync Injector Required?
kochava_device_id
Required		abcd1234efgh5678No
data.origination_ip
Required		73.220.15.94No
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.36No
idfa
Recommended		AEBE52E7-03EE-455A-B3C4-E57283966239No
idfv
Recommended		00000000-0000-0000-0000-000000000000No
adid
Recommended		38400000-8cf0-11bd-b23e-10b96e40000dNo
android_id
Recommended		c4d9d60f29f53e5eNo

Integration Validation

To validate event delivery in the Kochava UI:

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

Additional Kochava Documentation

Integration Change Log

Updated 6 days ago