Mobile Autocapture Schema

This reference lists Autocapture event types and event property names for native iOS and Android when you use the iOS Swift SDK and Android-Kotlin SDK. Use it when you need a stable contract for pipelines, partners, or validation.

React Native packages

Amplitude doesn't ship a separate React Native Autocapture package. React Native apps that need comparable behavior typically instrument events manually or bridge to native SDKs. This schema applies to native iOS and Android Autocapture only.

For Autocapture setup steps, go to Autocapture. For web Autocapture event properties, go to Autocapture events and properties. For a machine-readable web schema, go to Web Autocapture Schema.

Machine-readable schema

json

{
  "description": "Native mobile Autocapture event types and event property names for Amplitude iOS Swift SDK and Android-Kotlin SDK. React Native is not included.",
  "documentation": "/docs/data/mobile-autocapture-schema",
  "ios": {
    "events": {
      "[Amplitude] Start Session": { "properties": [] },
      "[Amplitude] End Session": { "properties": [] },
      "[Amplitude] Application Installed": {
        "properties": ["[Amplitude] Version", "[Amplitude] Build"]
      },
      "[Amplitude] Application Updated": {
        "properties": [
          "[Amplitude] Version",
          "[Amplitude] Build",
          "[Amplitude] Previous Version",
          "[Amplitude] Previous Build"
        ]
      },
      "[Amplitude] Application Opened": {
        "properties": [
          "[Amplitude] Version",
          "[Amplitude] Build",
          "[Amplitude] From Background"
        ]
      },
      "[Amplitude] Application Backgrounded": { "properties": [] },
      "[Amplitude] Screen Viewed": {
        "properties": ["[Amplitude] Screen Name"]
      },
      "[Amplitude] Deep Link Opened": {
        "properties": ["[Amplitude] Link URL", "[Amplitude] Link Referrer"]
      },
      "[Amplitude] Network Request": {
        "properties": [
          "[Amplitude] URL",
          "[Amplitude] URL Query",
          "[Amplitude] URL Fragment",
          "[Amplitude] Request Method",
          "[Amplitude] Status Code",
          "[Amplitude] Error Code",
          "[Amplitude] Error Message",
          "[Amplitude] Start Time",
          "[Amplitude] Completion Time",
          "[Amplitude] Duration",
          "[Amplitude] Request Body Size",
          "[Amplitude] Response Body Size",
          "[Amplitude] Request Body",
          "[Amplitude] Response Body",
          "[Amplitude] Request Headers",
          "[Amplitude] Response Headers"
        ]
      },
      "[Amplitude] Element Interacted": {
        "properties": [
          "[Amplitude] Action",
          "[Amplitude] Target View Class",
          "[Amplitude] Target Text",
          "[Amplitude] Target Accessibility Label",
          "[Amplitude] Target Accessibility Identifier",
          "[Amplitude] Action Method",
          "[Amplitude] Gesture Recognizer",
          "[Amplitude] Hierarchy",
          "[Amplitude] Screen Name"
        ]
      },
      "[Amplitude] Rage Click": {
        "properties": [
          "[Amplitude] Begin Time",
          "[Amplitude] End Time",
          "[Amplitude] Duration",
          "[Amplitude] Click Count",
          "[Amplitude] Clicks",
          "[Amplitude] Action",
          "[Amplitude] Target View Class",
          "[Amplitude] Target Text"
        ]
      },
      "[Amplitude] Dead Click": {
        "properties": [
          "[Amplitude] Begin Time",
          "[Amplitude] End Time",
          "[Amplitude] Duration",
          "[Amplitude] Action",
          "[Amplitude] Target View Class",
          "[Amplitude] Target Text"
        ]
      }
    }
  },
  "android": {
    "events": {
      "[Amplitude] Start Session": { "properties": [] },
      "[Amplitude] End Session": { "properties": [] },
      "[Amplitude] Application Installed": {
        "properties": ["[Amplitude] Version", "[Amplitude] Build"]
      },
      "[Amplitude] Application Updated": {
        "properties": [
          "[Amplitude] Version",
          "[Amplitude] Build",
          "[Amplitude] Previous Version",
          "[Amplitude] Previous Build"
        ]
      },
      "[Amplitude] Application Opened": {
        "properties": [
          "[Amplitude] Version",
          "[Amplitude] Build",
          "[Amplitude] From Background"
        ]
      },
      "[Amplitude] Application Backgrounded": { "properties": [] },
      "[Amplitude] Screen Viewed": {
        "properties": ["[Amplitude] Screen Name"]
      },
      "[Amplitude] Fragment Viewed": {
        "properties": [
          "[Amplitude] Screen Name",
          "[Amplitude] Fragment Class",
          "[Amplitude] Fragment Identifier",
          "[Amplitude] Fragment Tag"
        ]
      },
      "[Amplitude] Deep Link Opened": {
        "properties": ["[Amplitude] Link URL", "[Amplitude] Link Referrer"]
      },
      "[Amplitude] Network Request": {
        "properties": [
          "[Amplitude] URL",
          "[Amplitude] URL Query",
          "[Amplitude] URL Fragment",
          "[Amplitude] Request Method",
          "[Amplitude] Status Code",
          "[Amplitude] Error Message",
          "[Amplitude] Start Time",
          "[Amplitude] Completion Time",
          "[Amplitude] Duration",
          "[Amplitude] Request Body Size",
          "[Amplitude] Response Body Size"
        ]
      },
      "[Amplitude] Element Interacted": {
        "properties": [
          "[Amplitude] Action",
          "[Amplitude] Target Class",
          "[Amplitude] Target Resource",
          "[Amplitude] Target Tag",
          "[Amplitude] Target Text",
          "[Amplitude] Target Source",
          "[Amplitude] Hierarchy",
          "[Amplitude] Screen Name"
        ]
      },
      "[Amplitude] Rage Click": { "properties": [] },
      "[Amplitude] Dead Click": { "properties": [] }
    }
  }
}

Shared conventions

Event type values match what Amplitude stores as event_type (for example, [Amplitude] Screen Viewed).
Property names use the [Amplitude] ... prefix in the product and in this doc.
Session events typically carry only standard user and session context unless you add more in code.

iOS (Swift SDK)

Enable options through AutocaptureOptions. Go to Autocapture (iOS) for configuration options.

Event type	When it fires	Typical event properties
`[Amplitude] Start Session`	Session starts	User properties (when you enable user property collection).
`[Amplitude] End Session`	Session ends	User properties (when you enable user property collection).
`[Amplitude] Application Installed`	First open after install	`[Amplitude] Version`, `[Amplitude] Build`.
`[Amplitude] Application Updated`	First open after update	`[Amplitude] Version`, `[Amplitude] Build`, `[Amplitude] Previous Version`, `[Amplitude] Previous Build`.
`[Amplitude] Application Opened`	Launch or foreground after first open	`[Amplitude] Version`, `[Amplitude] Build`, `[Amplitude] From Background` (when applicable).
`[Amplitude] Application Backgrounded`	App enters background	None.
`[Amplitude] Screen Viewed`	UIKit screen appears	`[Amplitude] Screen Name`.
`[Amplitude] Deep Link Opened`	Deep link opens	`[Amplitude] Link URL`, `[Amplitude] Link Referrer`.
`[Amplitude] Network Request`	SDK captures HTTP traffic (per SDK rules)	`[Amplitude] URL`, `[Amplitude] URL Query`, `[Amplitude] URL Fragment`, `[Amplitude] Request Method`, `[Amplitude] Status Code`, `[Amplitude] Error Code`, `[Amplitude] Error Message`, `[Amplitude] Start Time`, `[Amplitude] Completion Time`, `[Amplitude] Duration`, `[Amplitude] Request Body Size`, `[Amplitude] Response Body Size`, plus optional experimental body and header properties when you enable them.
`[Amplitude] Element Interacted`	`UIControl` / gesture interaction	`[Amplitude] Action`, `[Amplitude] Target View Class`, `[Amplitude] Target Text`, `[Amplitude] Target Accessibility Label`, `[Amplitude] Target Accessibility Identifier`, `[Amplitude] Action Method`, `[Amplitude] Gesture Recognizer`, `[Amplitude] Hierarchy`, `[Amplitude] Screen Name`.
`[Amplitude] Rage Click`	Frustration (rage click)	Go to Track frustration interactions for more information.
`[Amplitude] Dead Click`	Frustration (dead click)	Same as Rage Click.

Android (Kotlin SDK)

Enable options through AutocaptureOption. Go to Autocapture (Android) for configuration options.

Event type	When it fires	Typical event properties
`[Amplitude] Start Session`	Session starts	User properties (when you enable user property collection).
`[Amplitude] End Session`	Session ends	User properties (when you enable user property collection).
`[Amplitude] Application Installed`	First open after install	`[Amplitude] Version`, `[Amplitude] Build`.
`[Amplitude] Application Updated`	First open after update	`[Amplitude] Version`, `[Amplitude] Build`, `[Amplitude] Previous Version`, `[Amplitude] Previous Build`.
`[Amplitude] Application Opened`	Launch or foreground after first open	`[Amplitude] Version`, `[Amplitude] Build`, `[Amplitude] From Background` (when applicable).
`[Amplitude] Application Backgrounded`	App backgrounds	None.
`[Amplitude] Screen Viewed`	Activity appears	`[Amplitude] Screen Name`.
`[Amplitude] Fragment Viewed`	Fragment appears	`[Amplitude] Screen Name`, `[Amplitude] Fragment Class`, `[Amplitude] Fragment Identifier`, `[Amplitude] Fragment Tag`.
`[Amplitude] Deep Link Opened`	Deep link opens	`[Amplitude] Link URL`, `[Amplitude] Link Referrer`.
`[Amplitude] Network Request`	SDK captures HTTP traffic (plugin)	`[Amplitude] URL`, `[Amplitude] URL Query`, `[Amplitude] URL Fragment`, `[Amplitude] Request Method`, `[Amplitude] Status Code`, `[Amplitude] Error Message`, `[Amplitude] Start Time`, `[Amplitude] Completion Time`, `[Amplitude] Duration`, `[Amplitude] Request Body Size`, `[Amplitude] Response Body Size`.
`[Amplitude] Element Interacted`	Clickable view or Compose	`[Amplitude] Action`, `[Amplitude] Target Class`, `[Amplitude] Target Resource`, `[Amplitude] Target Tag`, `[Amplitude] Target Text`, `[Amplitude] Target Source`, `[Amplitude] Hierarchy`, `[Amplitude] Screen Name`.
`[Amplitude] Rage Click`	Frustration (optional)	Go to Track frustration interactions for more information.
`[Amplitude] Dead Click`	Frustration (optional)	Same as Rage Click.

Was this helpful?