Auto-Tracked Events

The SDK automatically tracks the events listed below. You do not need to call track() for any of them. Tracking them manually will result in duplicate data. These events can be used as:

Experiment conversion goals in the Console
Webhook triggers for server-side integrations
In-app message and survey triggers
Analytics filters in dashboards and exports

Core Events

Event	Trigger	Key Properties
`session_start`	New session begins	`session_id`
`session_end`	30 minutes of inactivity or app enters background	—
`app_open`	App enters foreground	—
`app_close`	App enters background	—

A new session starts when the app comes to the foreground after 30 minutes of inactivity. The session_id is included in all events for the duration of the session.

Onboarding Events

Event	Trigger	Key Properties
`onboarding_flow_started`	An onboarding flow begins	`flow_id`
`onboarding_step_viewed`	A step is displayed to the user	`flow_id`, `step_id`, `step_index`
`onboarding_step_completed`	User completes a step (e.g., answers a question)	`flow_id`, `step_id`, `step_index`
`onboarding_step_skipped`	User skips a step	`flow_id`, `step_id`, `step_index`
`onboarding_flow_completed`	User completes the entire flow	`flow_id`, `total_steps`
`onboarding_flow_dismissed`	User dismisses the flow before completing	`flow_id`, `last_step_id`, `last_step_index`

Paywall Events

Event	Trigger	Key Properties
`paywall_view`	A paywall is displayed	`paywall_id`, `placement`
`paywall_close`	Paywall is closed	`paywall_id`, `dismiss_reason`

Billing Events

Event	Trigger	Key Properties
`purchase_started`	A purchase flow begins	`product_id`
`purchase_pending`	A purchase is pending approval (e.g. Ask to Buy / deferred)	`product_id`
`purchase_completed`	A purchase completes successfully	`product_id`, `transaction_id`
`purchase_failed`	A purchase fails with an error	`product_id`, `error`
`purchase_canceled`	User cancels the purchase dialog	`product_id`
`purchase_restored`	A previous purchase is restored	`product_id` (per product), `restored_count` (aggregate)

Push Notification Events

Event	Trigger	Key Properties
`push_token_registered`	Device token is registered with AppDNA	`token_hash`, `platform`
`push_permission_granted`	User grants push notification permission	—
`push_permission_denied`	User denies push notification permission	—
`push_delivered`	A push notification is delivered to the device	`push_id`
`push_tapped`	User taps on a push notification	`push_id`, `action`

Experiment Events

Event	Trigger	Key Properties
`experiment_exposure`	First `getVariant()` call per session per experiment	`experiment_id`, `variant`

Exposure is tracked once per session per experiment. Calling getVariant() multiple times in the same session does not create duplicate exposure events.

In-App Message Events

Event	Trigger	Key Properties
`in_app_message_shown`	An in-app message is displayed	`message_id`, `message_type`
`in_app_message_clicked`	User taps an action in the message	`message_id`, `cta_action`
`in_app_message_dismissed`	Message is closed	`message_id`

Survey Events

Event	Trigger	Key Properties
`survey_shown`	A survey is displayed	`survey_id`, `survey_type`
`survey_completed`	User submits a survey response	`survey_id`, `survey_type`, `answers`
`survey_dismissed`	Survey is closed without completing	`survey_id`

Deep Link Events

Event	Trigger	Key Properties
`deep_link_handled`	A deep link is opened	`url`
`deferred_deep_link_resolved`	A deferred deep link is resolved on first launch	`path`, `params`, `visitor_id`

Server-Driven Screen Events

Event	Trigger	Key Properties
`screen_presented`	A server-driven screen is displayed	`screen_id`, `presentation`
`screen_dismissed`	A server-driven screen is closed	`screen_id`, `screen_name`, `duration_ms`
`screen_action`	User taps a CTA or interactive element in a screen	`screen_id`, `action_type`
`flow_started`	A multi-screen flow begins	`flow_id`, `flow_name`, `start_screen_id`
`flow_completed`	A multi-screen flow finishes	`flow_id`, `flow_name`, `screens_viewed`, `duration_ms`
`flow_abandoned`	A flow is dismissed before completion	`flow_id`, `flow_name`, `screens_viewed`, `duration_ms`
`slot_registered`	A screen slot first renders in the app	`slot_name`
`slot_rendered`	A slot displays content from a screen config	`slot_name`, `screen_id`
`slot_empty`	A slot renders with no assigned content	`slot_name`
`interception_triggered`	A navigation interception fires and injects a screen	`trigger_screen`, `timing`, `screen_id`

Web Entitlement Events

Event	Trigger	Key Properties
`web_entitlement_activated`	Web subscription becomes active	`plan_name`, `status`
`web_entitlement_expired`	Web subscription expires or is canceled	`plan_name`, `reason`

​Auto-Tracked Events

​Core Events

​Onboarding Events

​Paywall Events

​Billing Events

​Push Notification Events

​Experiment Events

​In-App Message Events

​Survey Events

​Deep Link Events

​Server-Driven Screen Events

​Web Entitlement Events

Auto-Tracked Events

Core Events

Onboarding Events

Paywall Events

Billing Events

Push Notification Events

Experiment Events

In-App Message Events

Survey Events

Deep Link Events

Server-Driven Screen Events

Web Entitlement Events