Event Tracking

Overview

Event tracking lets you measure what users do after installing your app. By tracking key actions (purchases, signups, subscriptions), you can tie conversions back to the campaign that drove the install.

Tracking events

Android

TraceAndroid.trackEvent(
    name = "purchase_completed",
    properties = mapOf(
        "value" to "49.99",
        "currency" to "USD",
        "product_id" to "SKU_123"
    )
)

iOS

TraceClient.shared.trackEvent(
    name: "purchase_completed",
    properties: [
        "value": "49.99",
        "currency": "USD",
        "product_id": "SKU_123"
    ]
)

Event naming

Use snake_case for event names. Keep them specific and consistent:

Good	Avoid
purchase_completed	Purchase
signup_email	user signed up
tutorial_step_3	step3
subscription_started	sub

Properties

Properties are key-value pairs of strings. Use them to add context to events:

TraceAndroid.trackEvent(
    name = "subscription_started",
    properties = mapOf(
        "plan" to "pro",
        "billing" to "annual",
        "trial" to "true"
    )
)

Note

Both keys and values are strings. Convert numbers and booleans to strings (e.g. "49.99", "true").

Recommended events

These events help you measure campaign ROI:

Event	When to track	Key properties
signup_completed	User creates an account	method (email, google, apple)
onboarding_completed	User finishes onboarding	steps_completed
purchase_completed	Successful purchase	value, currency, product_id
subscription_started	Subscription begins	plan, billing, trial
invite_sent	User invites someone	channel (sms, email, link)

How it works

1. Your app calls trackEvent()
2. The SDK sends the event to Trace with the install ID
3. Trace associates the event with the original install and its attribution
4. You can now answer: “How many purchases came from my summer campaign?”

Events are linked to installs via the install ID that was assigned during attribution. This happens automatically — you don’t need to pass any attribution data when tracking events.