Kochava S2S events need an app id, device IP, and user agent
JSON to /track/json. kochava_app_id, action, kochava_device_id, and data.event_name are required. origination_ip, device_ua, and device_ver may sit at the root or inside data. An empty device_ver is valid. A hashed IP or user agent is an error.
What this pack matches
Rules
Codes are stable. A finding in CI, MCP, or the playground lands on the same id.
| Field | Required | What it checks | Rule ids | Source |
|---|---|---|---|---|
kochava_app_id |
required | It is the Kochava app GUID, and the S2S event article requires it on every post-install payload. Native JSON type: string. Fix: Set `kochava_app_id` to the app GUID from the Kochava dashboard. | vendor.kochava.body.kochava_app_id.missingvendor.kochava.body.kochava_app_id.emptyvendor.kochava.body.kochava_app_id.invalid |
docs |
action |
required | It names the S2S call. The post-install event article's sample sends `event`. Native JSON type: string. Fix: Set `action` to `event` for a post-install event. | vendor.kochava.body.action.missingvendor.kochava.body.action.emptyvendor.kochava.body.action.invalid |
docs |
kochava_device_id |
required | The article requires the `kochava_device_id` key on every post-install payload. The value may be empty when `device_ids` carries an ID instead. Native JSON type: string. Fix: Send `kochava_device_id` as a stable per-install string, or send it empty and put an ID in `device_ids`. | vendor.kochava.body.kochava_device_id.missingvendor.kochava.body.kochava_device_id.invalid |
docs |
data |
required | Kochava documents a `data` object on every post-install event payload. Native JSON type: object. Fix: Add a `data` object with `event_name`. | vendor.kochava.body.data.missingvendor.kochava.body.data.invalid |
docs |
data.event_name |
required | It is the event name. The article places `event_name` inside `data`. Native JSON type: string. Fix: Set `data.event_name` to the event the marketer expects. | vendor.kochava.body.data.event_name.missingvendor.kochava.body.data.event_name.emptyvendor.kochava.body.data.event_name.invalid |
docs |
origination_ip |
optional | It is the device IP. Kochava documents `origination_ip` as required; the field table puts it at the root and the samples put it inside `data`. Native JSON type: string. Fix: Send the device IP as `origination_ip` or `data.origination_ip`. | vendor.kochava.body.origination_ip.emptyvendor.kochava.body.origination_ip.invalid |
docs |
data.origination_ip |
optional | It is the device IP inside `data`, which is where Kochava's JSON samples put `origination_ip`. Native JSON type: string. Fix: Send the device IP as `data.origination_ip` or `origination_ip`. | vendor.kochava.body.data.origination_ip.emptyvendor.kochava.body.data.origination_ip.invalid |
docs |
device_ua |
optional | It is the device user agent. Kochava documents `device_ua` as required so it can parse the OS version. Native JSON type: string. Fix: Send the client user agent as `device_ua` or `data.device_ua`. | vendor.kochava.body.device_ua.emptyvendor.kochava.body.device_ua.invalid |
docs |
data.device_ua |
optional | It is the device user agent inside `data`, which is where Kochava's JSON samples put `device_ua`. Native JSON type: string. Fix: Send the client user agent as `data.device_ua` or `device_ua`. | vendor.kochava.body.data.device_ua.emptyvendor.kochava.body.data.device_ua.invalid |
docs |
device_ver |
optional | It is the device version string. Kochava documents the key as required and allows an empty value when `device_ua` is sent instead. Native JSON type: string. Fix: Send `device_ver` or `data.device_ver`. An empty string is valid. | vendor.kochava.body.device_ver.invalid |
docs |
data.device_ver |
optional | It is the device version string inside `data`. Kochava's samples send `device_ver` as an empty string. Native JSON type: string. Fix: Send `data.device_ver` or `device_ver`. An empty string is valid. | vendor.kochava.body.data.device_ver.invalid |
docs |
currency |
optional | It is an ISO 4217 currency code on revenue events. Kochava's samples send `USD`. Fix: Send a three-letter code such as `USD`. | vendor.kochava.body.currency.emptyvendor.kochava.body.currency.invalid |
docs |
data.currency |
optional | It is an ISO 4217 currency code inside `data`. Kochava's samples send `USD`. Fix: Send a three-letter code such as `USD`. | vendor.kochava.body.data.currency.emptyvendor.kochava.body.data.currency.invalid |
docs |
usertime |
optional | It is the time the user completed the event, as Unix seconds. Native JSON type: integer. Fix: Send `usertime` as seconds since epoch. | vendor.kochava.body.usertime.emptyvendor.kochava.body.usertime.invalid |
docs |
data.usertime |
optional | It is the time the user completed the event, as Unix seconds inside `data`. Native JSON type: integer. Fix: Send `data.usertime` as seconds since epoch. | vendor.kochava.body.data.usertime.emptyvendor.kochava.body.data.usertime.invalid |
docs |
data.app_version |
optional | It is the app version string. Kochava documents `app_version` as optional. Native JSON type: string. Fix: Send `data.app_version` as a version string such as `1.0.0`, or drop the pair. | vendor.kochava.body.data.app_version.emptyvendor.kochava.body.data.app_version.invalid |
docs |
data.device_ids.idfa |
optional | It is the iOS advertising ID inside `device_ids`. Kochava requires at least one identifier in that object. Native JSON type: string. Fix: Send `data.device_ids.idfa`, or another documented identifier such as `adid` or `android_id`. | vendor.kochava.body.data.device_ids.idfa.emptyvendor.kochava.body.data.device_ids.idfa.invalid |
docs |
data.device_ids.idfv |
optional | It is the iOS vendor ID inside `device_ids`. Kochava allows more than one identifier. Native JSON type: string. Fix: Send `data.device_ids.idfv` when it is available. | vendor.kochava.body.data.device_ids.idfv.emptyvendor.kochava.body.data.device_ids.idfv.invalid |
docs |
data.device_ids.adid |
optional | It is the Android advertising ID inside `device_ids`. Kochava requires at least one identifier in that object. Native JSON type: string. Fix: Send `data.device_ids.adid`, or another documented identifier such as `idfa` or `android_id`. | vendor.kochava.body.data.device_ids.adid.emptyvendor.kochava.body.data.device_ids.adid.invalid |
docs |
data.device_ids.android_id |
optional | It is the Android ID inside `device_ids`. Kochava requires at least one identifier in that object. Native JSON type: string. Fix: Send `data.device_ids.android_id`, or another documented identifier such as `idfa` or `adid`. | vendor.kochava.body.data.device_ids.android_id.emptyvendor.kochava.body.data.device_ids.android_id.invalid |
docs |
device_ids.idfa |
optional | It is the iOS advertising ID when `device_ids` sits at the root. Kochava's table lists the object alongside other required keys. Native JSON type: string. Fix: Send `device_ids.idfa`, or put the object inside `data`. | vendor.kochava.body.device_ids.idfa.emptyvendor.kochava.body.device_ids.idfa.invalid |
docs |
device_ids.idfv |
optional | It is the iOS vendor ID when `device_ids` sits at the root. Native JSON type: string. Fix: Send `device_ids.idfv` when it is available. | vendor.kochava.body.device_ids.idfv.emptyvendor.kochava.body.device_ids.idfv.invalid |
docs |
device_ids.adid |
optional | It is the Android advertising ID when `device_ids` sits at the root. Native JSON type: string. Fix: Send `device_ids.adid`, or put the object inside `data`. | vendor.kochava.body.device_ids.adid.emptyvendor.kochava.body.device_ids.adid.invalid |
docs |
device_ids.android_id |
optional | It is the Android ID when `device_ids` sits at the root. Native JSON type: string. Fix: Send `device_ids.android_id`, or put the object inside `data`. | vendor.kochava.body.device_ids.android_id.emptyvendor.kochava.body.device_ids.android_id.invalid |
docs |
data.event_data.id |
optional | It is the item id inside `event_data`. Kochava's post-install sample sends it. Native JSON type: string. Fix: Send `data.event_data.id`, or drop the empty pair. | vendor.kochava.body.data.event_data.id.emptyvendor.kochava.body.data.event_data.id.invalid |
docs |
data.event_data.name |
optional | It is the item name inside `event_data`. Kochava's post-install sample sends it. Native JSON type: string. Fix: Send `data.event_data.name`, or drop the empty pair. | vendor.kochava.body.data.event_data.name.emptyvendor.kochava.body.data.event_data.name.invalid |
docs |
data.event_data.sum |
optional | It is the monetary value inside `event_data`. Kochava's post-install sample sends a number such as `150`. Fix: Send `data.event_data.sum` as a number, with no currency symbol. | vendor.kochava.body.data.event_data.sum.emptyvendor.kochava.body.data.event_data.sum.invalid |
docs |
data.att |
optional | It is the iOS App Tracking Transparency result. Kochava documents `true` when tracking is authorized and `false` when it is not, on iOS 14+ events. Native JSON type: boolean. Fix: Send `data.att` as `true` or `false`. | vendor.kochava.body.data.att.emptyvendor.kochava.body.data.att.invalid |
docs |
data.att_detail |
optional | It is the ATTrackingManager.AuthorizationStatus. Kochava documents `authorized`, `denied`, `notDetermined`, and `restricted`. Native JSON type: string. Fix: Send `authorized`, `denied`, `notDetermined`, or `restricted`. | vendor.kochava.body.data.att_detail.emptyvendor.kochava.body.data.att_detail.invalid |
docs |
data.app_tracking_transparency.att |
optional | It is the ATT result inside Kochava's iOS 14+ `app_tracking_transparency` object. Native JSON type: boolean. Fix: Send `data.app_tracking_transparency.att` as `true` or `false`. | vendor.kochava.body.data.app_tracking_transparency.att.emptyvendor.kochava.body.data.app_tracking_transparency.att.invalid |
docs |
data.app_tracking_transparency.att_detail |
optional | It is the ATTrackingManager.AuthorizationStatus inside `app_tracking_transparency`. Native JSON type: string. Fix: Send `authorized`, `denied`, `notDetermined`, or `restricted`. | vendor.kochava.body.data.app_tracking_transparency.att_detail.emptyvendor.kochava.body.data.app_tracking_transparency.att_detail.invalid |
docs |
data.app_tracking_transparency.att_time |
optional | It is the ATT authorization time. Kochava documents `att_time` as optional on iOS 14+ events. Native JSON type: integer. Fix: Send `att_time` as Unix seconds. | vendor.kochava.body.data.app_tracking_transparency.att_time.emptyvendor.kochava.body.data.app_tracking_transparency.att_time.invalid |
docs |
data.app_tracking_transparency.att_duration |
optional | It is how long the user took to answer the ATT prompt, in seconds. Native JSON type: integer. Fix: Send `att_duration` as an integer number of seconds. | vendor.kochava.body.data.app_tracking_transparency.att_duration.emptyvendor.kochava.body.data.app_tracking_transparency.att_duration.invalid |
docs |
root |
optional | Each event is a JSON object, rather than a scalar or list. Native JSON type: object. | vendor.kochava.body.root.invalid |
docs |
device_ids |
optional | The published vendor reference specifies this field. Native JSON type: object. | vendor.kochava.body.device_ids.invalid |
docs |
data.device_ids |
optional | The published vendor reference specifies this field. Native JSON type: object. | vendor.kochava.body.data.device_ids.invalid |
docs |
data.app_tracking_transparency |
optional | The published vendor reference specifies this field. Native JSON type: object. | vendor.kochava.body.data.app_tracking_transparency.invalid |
docs |
device_ids.* |
optional | The published vendor reference specifies this field. Native JSON type: string. | vendor.kochava.body.device_ids.*.emptyvendor.kochava.body.device_ids.*.invalid |
docs |
data.device_ids.* |
optional | The published vendor reference specifies this field. Native JSON type: string. | vendor.kochava.body.data.device_ids.*.emptyvendor.kochava.body.data.device_ids.*.invalid |
docs |
data.ip_alternate |
optional | The alternate device address must be publicly routable IPv4 outside the exact excluded CIDRs published by Kochava. This field is processed when the primary address is IPv6. Applies when {"kind":"any","conditions":[{"kind":"value_pattern","param":"data.origination_ip","pattern":":"},{"kind":"value_pattern","param":"origination_ip","pattern":":"}]}. Native JSON type: string. | vendor.kochava.body.data.ip_alternate.emptyvendor.kochava.body.data.ip_alternate.invalid |
docs |
data.device_limit_tracking |
optional | The published vendor reference specifies this field. Native JSON type: boolean or string. | vendor.kochava.body.data.device_limit_tracking.emptyvendor.kochava.body.data.device_limit_tracking.invalid |
docs |
data.gdpr_privacy_consent |
optional | The published vendor reference specifies this field. Native JSON type: object. | vendor.kochava.body.data.gdpr_privacy_consent.invalid |
docs |
data.gdpr_privacy_consent.gdpr_applies |
optional | The published vendor reference specifies this field. Native JSON type: integer. | vendor.kochava.body.data.gdpr_privacy_consent.gdpr_applies.emptyvendor.kochava.body.data.gdpr_privacy_consent.gdpr_applies.invalid |
docs |
data.gdpr_privacy_consent.ad_user_data |
optional | The published vendor reference specifies this field. Native JSON type: integer. | vendor.kochava.body.data.gdpr_privacy_consent.ad_user_data.emptyvendor.kochava.body.data.gdpr_privacy_consent.ad_user_data.invalid |
docs |
data.gdpr_privacy_consent.ad_personalization |
optional | The published vendor reference specifies this field. Native JSON type: integer. | vendor.kochava.body.data.gdpr_privacy_consent.ad_personalization.emptyvendor.kochava.body.data.gdpr_privacy_consent.ad_personalization.invalid |
docs |
data.gdpr_privacy_consent.tc_string |
optional | The published vendor reference specifies this field. Native JSON type: string. | vendor.kochava.body.data.gdpr_privacy_consent.tc_string.emptyvendor.kochava.body.data.gdpr_privacy_consent.tc_string.invalid |
docs |
body.origination_ip_required |
required | The payload has no device IP. Kochava documents `origination_ip` as required on every post-install event. Fix: Send `origination_ip` at the root or inside `data`. | vendor.kochava.body.origination_ip_required |
docs |
body.device_ua_required |
required | The payload has no device user agent. Kochava documents `device_ua` as required so it can parse the OS version. Fix: Send `device_ua` at the root or inside `data`. | vendor.kochava.body.device_ua_required |
docs |
body.device_ver_required |
required | The payload has no `device_ver` key. Kochava documents the key as required and allows an empty value. Fix: Send `device_ver` at the root or inside `data`. An empty string is valid. | vendor.kochava.body.device_ver_required |
docs |
body.hashed_plaintext_field |
required | This field looks like a SHA-256 digest, but Kochava documents `origination_ip` and `device_ua` as unhashed device values. Fix: Send the raw IP address or user agent. Hashing it makes the event unmatchable. | vendor.kochava.body.hashed_plaintext_field |
docs |
body.device_ids_required |
required | Send a nonempty Kochava device ID or an identifier in device_ids. Custom variants are supported. | vendor.kochava.body.device_ids_required |
docs |
body.consent_signal_alternative |
required | Consent signals require a TCF string or both explicit advertising consent values. | vendor.kochava.body.consent_signal_alternative |
docs |
method |
required | The post-install article sends the payload with POST. Complete HTTP capture contract. Native JSON type: string. | vendor.kochava.http.method.missingvendor.kochava.http.method.emptyvendor.kochava.http.method.invalid |
docs |
path |
required | Use the /track/json endpoint. Complete HTTP capture contract. Native JSON type: string. | vendor.kochava.http.path.missingvendor.kochava.http.path.emptyvendor.kochava.http.path.invalid |
docs |
content_type |
required | The post-install article sends an application/json body. Complete HTTP capture contract. Native JSON type: string. | vendor.kochava.http.content_type.missingvendor.kochava.http.content_type.emptyvendor.kochava.http.content_type.invalid |
docs |
body_encoding |
required | The event request is encoded as JSON. Complete HTTP capture contract. Native JSON type: string. | vendor.kochava.http.body_encoding.missingvendor.kochava.http.body_encoding.emptyvendor.kochava.http.body_encoding.invalid |
docs |
url |
required | The published request endpoint uses HTTPS. Complete HTTP capture contract. Native JSON type: string. | vendor.kochava.http.url.missingvendor.kochava.http.url.emptyvendor.kochava.http.url.invalid |
docs |
Validate a payload
pixellint validate json @payload.json --rulepack vendor/kochava
Try this failing payload in the playground. Kochava event without a device IP.
{"action":"event","kochava_app_id":"kokochava-example","kochava_device_id":"kodevice-example","data":{"event_name":"Purchase","device_ua":"Mozilla/5.0","device_ver":""}}
cargo install pixellint
·
npm install pixellint