In-App Event Taxonomy Spec

§1 Naming principles

• snake_case enforced: addToCart (✗) → add_to_cart (✓). No mixing camel/Pascal/kebab case
• Verb+noun or noun+state: prefer product_view over view_product (GA4-standard alignment)
• Avoid reserved event names: session_start, first_open, in_app_purchase and other Adjust/Firebase reserved names can't be self-defined. Send revenue through a purchase event so Adjust's in_app_purchase maps automatically
• Max length 40 chars, parameter keys 25, values 100
• Absolutely no PII: never send email, phone, name, address, or device_token directly. If needed, hash (SHA-256) + salt before sending
• currency is ISO 4217 3-letter (KRW, USD, JPY). Don't normalize revenue to a single currency client-side — always send the currency parameter alongside

§2 Event master list

Click a column header to sort. Tier-1 events are the core signals used for network optimization.

§3 Standard parameter spec

§4 Reference payload

All client SDKs serialize into the JSON structure below and map it onto Adjust's ADJEvent / AdjustEvent. Server-side sends deliver the same payload to the S2S endpoint.

{
  "event_token": "p4q7zx",
  "event_name": "purchase",
  "timestamp_ms": 1779360000000,
  "user": {
    "user_id_hashed": "sha256:8a7d...e1c2",
    "user_grade": "regular",
    "is_logged_in": true
  },
  "params": {
    "transaction_id": "tx_20260525_a91b3",
    "revenue": 29900.00,
    "currency": "KRW",
    "payment_method": "kakaopay",
    "item_count": 2,
    "products": [
      { "product_id": "sku_88421", "category": "outerwear", "price": 14950.00, "quantity": 2 }
    ],
    "screen": "checkout_complete"
  },
  "context": {
    "platform": "android",
    "app_version": "4.12.0",
    "network_type": "wifi",
    "ab_variant": "ckt_v3_B"
  }
}

4.1 Adjust mapping (Kotlin)

fun trackPurchase(tx: Transaction) {
    val event = AdjustEvent("p4q7zx").apply {
        setRevenue(tx.revenue, tx.currency)
        setOrderId(tx.id)                      // dedup key
        addCallbackParameter("payment_method", tx.method)
        addCallbackParameter("item_count", tx.items.size.toString())
        addPartnerParameter("ab_variant", tx.abVariant)
    }
    Adjust.trackEvent(event)
}

§5 Versioning & governance

• v{major}.{minor} format. Adding/removing a Tier-1 event bumps major; adding a parameter bumps minor
• Deprecation policy: keep a 60-day dual-write window, then stop sending the old event. Network optimization models need retraining on the new event
• Change requests go only through the Taxonomy Change Request template in the Notion DB. Requires sign-off from Growth Lead + Data Eng + iOS/Android Leads

§6 Troubleshooting / pitfalls