Users and events

Segments, journeys and conversion scoring are all built from two things your app sends: who the user is, and what they did.

Identify

Call identify right after login with your own user ID. Chumbaq links the device, its push token and every event to that person.

await Chumbaq.instance.identify(
  IdentifyParams.builder().externalUserId('u_42').build(),
);

The same call exists on iOS, Android and the web.

Traits

Traits describe the person: plan, country, signup date. You can set them from the SDK or update them from the dashboard, and segment on any of them.

Events

Events are what people do: added_to_cart, purchase, kyc_started. Send them from the app through the SDK, or from your backend through the HTTP API:

curl -X POST https://your-chumbaq-host/api/events/track \
  -H "x-api-key: $CHUMBAQ_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "projectId": "<project id>",
    "eventName": "purchase",
    "distinctId": "u_42",
    "properties": { "value": 64.0, "currency": "USD" }
  }'

Conversions

Mark the events that mean money, like purchase or subscribed, as conversions. Every campaign then reports the conversions and revenue that followed it, against its control group.

Mixpanel cohorts

Already have cohorts in Mixpanel? Connect Mixpanel and Chumbaq syncs them on a schedule, so you can target them like any other segment.