Swrve user properties
User properties specify the current state of the user. You can use both default and custom properties for tracking and targeting of in-app messages, embedded experiences, and push notifications.
Assign user properties to easily segment your user base and send the status of the user. For example, use the swrve.device_region user property to target users in a certain country, or create a custom user property called premium, and then target non-premium users and premium users.
Default user properties
Some user properties are automatically sent to Swrve at initialization. Default Swrve user properties include, but are not limited to:
| Property | Description |
|---|---|
| swrve.os | The operating system of the device. (iPhone OS, Android…) |
| swrve.os_version | The operating system version. (iOS 16.0.3, Android 13.0.0…) |
| swrve.language | The language of the device. |
| swrve.sdk_version | The Swrve SDK being used. |
| swrve.device_dpi | The dots per inch of the device. |
| swrve.device_name | The name of the device. |
| swrve.device_width | The width of the device in pixels. |
| swrve.device_height | The height of the device in pixels. |
| swrve.sim_operator.name | The mobile operator of the registered SIM card. Deprecated in iOS 16+. |
| swrve.sim_operator.iso_country_code | The 2-letter ISO country code of the mobile operator. Deprecated in iOS 16+. |
| swrve.sim_operator.code | The unique number assigned to every mobile operator in all countries of the world. Deprecated in iOS 16+. |
| swrve.device_region | The 2-letter ISO country code of the selected region of the device. |
| swrve.timezone_name | The timezone name for the user taken from the device. |
| swrve.install_date | Integer value generated on device when the app is first run – format yyyymmdd. |
| iOS only | |
| swrve.permission.ios.photos | The user’s photo permission status. Possible string values are unknown, unsupported, denied or authorized. |
| swrve.permission.ios.push_notifications | The user’s push notifications permission status. Possible string values are unknown, unsupported, denied or authorized. |
| Swrve.permission.ios.contacts | The user’s contacts permission status. Possible string values are unknown, unsupported, denied or authorized. |
| Swrve.permission.ios.location.when_in_use | The user’s location (when in use) permission status. Possible string values are unknown, unsupported, denied or authorized. |
| Swrve.permission.ios.location.always | The user’s location (when in use) permission status. Possible string values are unknown, unsupported, denied or authorized. |
| Swrve.permission.ios.camera | The user’s camera permission status. Possible string values are unknown, unsupported, denied or authorized. |
| Android only (Android SDK version 10.4.0, Unity SDK version 9.0.0 or higher) | |
| swrve.permission.android.notification | The user’s notification permission status. Possible string values are denied or granted. User property is only set for devices on Android 13 or higher. |
| swrve.permission.android.notification_show_rationale | Indicates whether the permission dialog was previously shown. Returns true if the permission dialog was shown once and the user denied it (not dismissed). Returns false if permission dialog was never shown, or if it was shown but the user dismissed it without granting or denying it, or was shown/responded to twice, or if permission was already granted.
User property is only set for devices on Android 13 or higher. |
| swrve.permission.android.notification_answered_times | The number of times the user has answered the permission request. A dismissal is not counted—the user must respond by granting or denying permission. Possible integer values are 0, 1, or 2. |
| swrve.os_int_version | The OS API Level installed on the device. Corresponds to swrve.os_version, but an integer. |
| swrve.app_target_version | The app’s target Android API Level. |
For a more extensive list of default user properties sent from your app, see the Swrve User Properties file in your User DB Downloads.
Custom user properties
Create custom user properties to segment your users and learn more about their status in your app. For more information on creating custom user properties, see the relevant SDK integration guide: