Kochava

Datafly Signal sends in-app events from the Datafly iOS and Android SDKs to Kochava through its server-to-server post-install event API (control.kochava.com/track/json).

Prerequisites

Find your App GUID

In Kochava, open the app’s App Settings and copy the App GUID (kochava_app_id).

Send events from the mobile SDKs

Kochava attributes by device ID. Events need the advertising ID (IDFA on iOS once ATT is granted, GAID on Android) or, on iOS, the IDFV. Web events are not sent.

Configure in Signal

Configuration Fields

Field	Required	Description
`app_guid`	Yes	The Kochava App GUID (kochava_app_id), found in your Kochava dashboard under App Settings. It identifies and authenticates the app on the S2S event endpoint.
`api_key`	No	Not used for event delivery: Kochava’s post-install event endpoint authenticates by the App GUID. Kept for existing installs.
`account_id`	No	Not used for event delivery. Kept for existing installs.

Management UI Setup

Go to Integrations > Add Integration > Kochava.
Choose a preset: Default (default), Retail (ecommerce), Gaming (gaming), Media & Subscription (media), Travel (travel), Insurance (insurance).
Fill in the fields above and click Save.

Request format

POST https://control.kochava.com/track/json
{"action":"event","kochava_app_id":"<App GUID>","kochava_device_id":"df_dev_t2",
 "data":{"event_name":"Purchase","usertime":1758500000,"origination_ip":"203.0.113.9",
  "device_ua":"ShopApp/5.2 (iPhone; iOS 17.5.1)","device_ver":"iPhone16,2-iOS-17.5.1","currency":"GBP",
  "device_ids":{"idfa":"29DDE430-...","idfv":"59E27F41-..."},
  "app_tracking_transparency":{"att":true},
  "gdpr_privacy_consent":{"gdpr_applies":1,"tc_string":"...","ad_user_data":1,"ad_personalization":1},
  "event_data":{"sum":259.99,"price":259.99,"order_id":"ORD-1001","content_id":"SKU_1,SKU_2","name":"Parka,Gloves","user_id":"crm-user-9"}}}

Event Mapping

Signal event	Vendor event	Presets
`view_item`	`View`	Default, Retail, Travel
`add_to_cart`	`Add to Cart`	Default, Retail
`begin_checkout`	`Checkout Start`	Default, Retail, Travel
`purchase`	`Purchase`	Default, Retail, Gaming, Travel, Insurance
`sign_up`	`Registration Complete`	Default, Retail, Gaming, Media & Subscription, Insurance
`search`	`Search`	Default, Retail, Travel
`trial_started`	`Start Trial`	Default, Media & Subscription
`subscription_started`	`Subscribe`	Default, Media & Subscription
`add_to_wishlist`	`Add to Wishlist`	Retail
`tutorial_completed`	`Tutorial Complete`	Gaming
`level_completed`	`Level Complete`	Gaming
`achievement_unlocked`	`Achievement`	Gaming
`item_purchased`	`Purchase`	Gaming
`content_viewed`	`View`	Media & Subscription
`flight_searched`	`Search`	Travel
`hotel_searched`	`Search`	Travel
`booking_completed`	`Purchase`	Travel
`quote_started`	`Quote Started`	Insurance
`quote_completed`	`Quote Complete`	Insurance
`policy_purchased`	`Purchase`	Insurance

Identity

data.device_ids: idfa and idfv (upper-cased) on iOS, adid (the GAID) on Android. Events with neither an advertising ID nor an IDFV are not sent.
kochava_device_id: the Kochava SDK ID when an ID provider collects it as kochava_device_id, else the Signal device ID.
data.device_ver is model-OS-version, as Kochava documents; origination_ip and device_ua are the device’s.
event_data.user_id is your user ID. No email, phone or name is sent.

app_tracking_transparency.att (iOS): whether the user granted ATT. Kochava assumes no consent and drops the IDFA when it is missing.
device_limit_tracking (Android): the limit-ad-tracking flag.
gdpr_privacy_consent: gdpr_applies (from the TCF signal, else EEA, UK or Switzerland by geo), the TCF string, and ad_user_data / ad_personalization from marketing consent, for Google’s DMA requirements.

Blueprint

The Kochava blueprint version is 0.7.0. It was last reviewed against the vendor’s documentation on 2026-09-23.