pixellint

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

Hosts
control.kochava.com
Paths
…/track/json…
Vendor docs
support.kochava.com/articles/server-to-server-integration/185-post-install-event-setup/

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.missing
vendor.kochava.body.kochava_app_id.empty
vendor.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.missing
vendor.kochava.body.action.empty
vendor.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.missing
vendor.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.missing
vendor.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.missing
vendor.kochava.body.data.event_name.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.*.empty
vendor.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.*.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.empty
vendor.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.missing
vendor.kochava.http.method.empty
vendor.kochava.http.method.invalid
docs
path required Use the /track/json endpoint. Complete HTTP capture contract. Native JSON type: string. vendor.kochava.http.path.missing
vendor.kochava.http.path.empty
vendor.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.missing
vendor.kochava.http.content_type.empty
vendor.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.missing
vendor.kochava.http.body_encoding.empty
vendor.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.missing
vendor.kochava.http.url.empty
vendor.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