Standard events

Audience: Engineers, technical integrators

Standard events (the general.core preset) are auto-enabled for every product — no subscription needed. They cover user lifecycle, verification & consent, and app lifecycle. For gaming-specific events see iGaming events.

Every event also carries the base properties (event, timestamp, identity.client_user_id, context.ip_address). The tables below list only the fields specific to each event.

Interactive explorer

Pick an event to see its fields and a ready-to-send envelope. Toggle "Required only", then copy as JSON or cURL.

User Lifecycle

Verification & Consent

App Lifecycle

POST/v3/s2s/eventregister Required only

Field	Type	Key	Description
event	String	Required	Fixed `register`. Must be a registered event name.
timestamp	Number	Required	UTC epoch milliseconds (13 digits).
identity.client_user_id	String	Required	Unique user ID in your system. Identity needs at least one of client_user_id / anonymous_id.
identity.click_id	String	Suggested	Ad click ID for attribution.
identity.anonymous_id	String	Optional	Pre-registration anonymous ID; used for app-lifecycle stitching before client_user_id exists.
context.ip_address	String	Required	End-user IP (IPv4 or IPv6).
context.user_agent	String	Suggested	Browser / device user-agent string.
context.privacy.email_hash	String	Suggested	SHA-256 of email (lowercased & trimmed). Never plaintext. SHA-256
context.privacy.phone_hash	String	Suggested	SHA-256 of E.164-normalized phone. Never plaintext. SHA-256
context.privacy.marketing_consent	Boolean	Suggested	Whether the user consents to marketing.
context.attribution.install_source	String	Suggested	Install / acquisition source.
context.phone_country_code	String	Suggested	E.164 country calling code (e.g. +55).
context.consent_timestamp	Number	Suggested	Last consent change, UTC ms.
context.attribution.utm_source	String	Suggested	UTM source.
context.attribution.utm_medium	String	Suggested	UTM medium.
context.attribution.utm_campaign	String	Suggested	UTM campaign.
context.attribution.utm_content	String	Suggested	UTM content.
context.attribution.utm_term	String	Suggested	UTM term.

Request envelope

{
  "event": "register",
  "timestamp": 1718280000000,
  "identity": {
    "client_user_id": "user_001",
    "click_id": "RS_clk_998877",
    "anonymous_id": "anon_7f3a"
  },
  "context": {
    "ip_address": "203.0.113.1",
    "user_agent": "Mozilla/5.0 (...)",
    "privacy": {
      "email_hash": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
      "phone_hash": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
      "marketing_consent": true
    },
    "attribution": {
      "install_source": "google_ads",
      "utm_source": "google",
      "utm_medium": "cpc",
      "utm_campaign": "summer_promo",
      "utm_content": "banner_a",
      "utm_term": "slots"
    },
    "phone_country_code": "+55",
    "consent_timestamp": 1718280000000
  }
}

User Lifecycle

register

A new user account is created.

Field	Type	Requirement	Description
context.user_agent	String	Suggested	Browser / device user-agent string.
context.privacy.email_hash	String	Suggested	SHA-256 of email (lowercased & trimmed). Never plaintext.
context.privacy.phone_hash	String	Suggested	SHA-256 of E.164-normalized phone. Never plaintext.
context.privacy.marketing_consent	Boolean	Suggested	Whether the user consents to marketing.
context.attribution.install_source	String	Suggested	Install / acquisition source.
context.phone_country_code	String	Suggested	E.164 country calling code (e.g. +55).
context.consent_timestamp	Number	Suggested	Last consent change, UTC ms.
context.attribution.utm_source	String	Suggested	UTM source.
context.attribution.utm_medium	String	Suggested	UTM medium.
context.attribution.utm_campaign	String	Suggested	UTM campaign.
context.attribution.utm_content	String	Suggested	UTM content.
context.attribution.utm_term	String	Suggested	UTM term.

referral_register

A registration attributed to a referral — carries the referrer's user id.

Field	Type	Requirement	Description
context.referral_client_user_id	String	Suggested	The referrer's client_user_id (the user who referred this registration).

login

A user authenticates into your platform.

Field	Type	Requirement	Description
context.user_agent	String	Suggested	Browser / device user-agent string.

Verification & Consent

email_verified

Field	Type	Requirement	Description
context.email_hash	String	Suggested	SHA-256 of email. Never plaintext.
context.verification_method	String	Suggested	One of link · otp · magic_link.

phone_verified

Field	Type	Requirement	Description
context.phone_hash	String	Suggested	SHA-256 of phone. Never plaintext.
context.phone_country_code	String	Suggested	E.164 country calling code (e.g. +91).
context.verification_method	String	Suggested	Prefer sms_otp · voice_call · whatsapp_otp. (call · whatsapp still accepted but deprecated.)

marketing_consent_updated

Send the full state of all four channels each time (including the default consent at signup).

Field	Type	Requirement	Description
context.allow_email	Boolean	Required	Consent to email.
context.allow_sms	Boolean	Required	Consent to SMS.
context.allow_push	Boolean	Required	Consent to push.
context.allow_whatsapp	Boolean	Required	Consent to WhatsApp.
context.update_source	String	Suggested	One of signup · settings_page · unsubscribe_link · support · admin.

App Lifecycle

NOTE

App lifecycle events apply to native App / APK advertisers and usually originate from the mobile SDK / MMP. For these events client_user_id (and ip_address on app_install) is downgraded to Suggested, since the user may be anonymous before registering — use identity.anonymous_id instead.

app_install

Fired once when the app is first installed & opened.

Field	Type	Requirement	Description
context.platform	String	Required	One of ios · android · web.
context.app_version	String	Suggested	App version on install.
context.attribution.install_source	String	Suggested	Media source / channel (from MMP).
context.device_id	String	Suggested	Device identifier.
context.store	String	Suggested	Install store: app_store · play_store · apk_direct.
context.campaign_id	String	Suggested	Campaign ID (from MMP).
context.is_reattribution	Boolean	Suggested	true if reinstall / reattribution.

app_open

Fired on app launch / foreground.

Field	Type	Requirement	Description
context.platform	String	Required	One of ios · android · web.
context.app_version	String	Suggested	App version.
context.session_id	String	Suggested	Session identifier.
context.is_first_open	Boolean	Suggested	true for first open after install.

app_uninstall

A strong churn signal (MMP detects via push-token expiry).

Field	Type	Requirement	Description
context.platform	String	Required	One of ios · android · web.
context.app_version	String	Suggested	Last installed version.
context.days_since_install	Number	Suggested	Days from install to uninstall.

push_permission_updated

Push reachability / opt-in signal.

Field	Type	Requirement	Description
context.platform	String	Required	One of ios · android · web.
context.permission_status	String	Required	One of granted · denied · provisional · revoked.
context.push_enabled	Boolean	Suggested	true if push permission granted.
context.update_source	String	Suggested	What triggered the change: system_prompt · settings · onboarding.