| Id |
string |
The device's OneSignal ID |
[optional] [readonly] |
| InvalidIdentifier |
bool |
If true, this is the equivalent of a user being Unsubscribed |
[optional] [readonly] |
| AppId |
string |
|
[optional] |
| DeviceType |
int |
Required The device's platform: 0 = iOS 1 = Android 2 = Amazon 3 = WindowsPhone (MPNS) 4 = Chrome Apps / Extensions 5 = Chrome Web Push 6 = Windows (WNS) 7 = Safari 8 = Firefox 9 = MacOS 10 = Alexa 11 = Email 13 = For Huawei App Gallery Builds SDK Setup. Not for Huawei Devices using FCM 14 = SMS |
|
| ExternalUserId |
string |
a custom user ID |
[optional] |
| ExternalUserIdAuthHash |
string |
Only required if you have enabled Identity Verification and device_type is NOT 11 email. |
[optional] |
| EmailAuthHash |
string |
Email - Only required if you have enabled Identity Verification and device_type is email (11). |
[optional] |
| Identifier |
string |
Recommended: For Push Notifications, this is the Push Token Identifier from Google or Apple. For Apple Push identifiers, you must strip all non alphanumeric characters. Examples: iOS: 7abcd558f29d0b1f048083e2834ad8ea4b3d87d8ad9c088b33c132706ff445f0 Android: APA91bHbYHk7aq-Uam_2pyJ2qbZvqllyyh2wjfPRaw5gLEX2SUlQBRvOc6sck1sa7H7nGeLNlDco8lXj83HWWwzV... For Email Addresses, set the full email address [email protected] and make sure to set device_type to 11. |
[optional] |
| Language |
string |
Language code. Typically lower case two letters, except for Chinese where it must be one of zh-Hans or zh-Hant. Example: en |
[optional] |
| Timezone |
int? |
Number of seconds away from UTC. Example: -28800 |
[optional] |
| GameVersion |
string |
Version of your app. Example: 1.1 |
[optional] |
| DeviceModel |
string |
Device make and model. Example: iPhone5,1 |
[optional] |
| DeviceOs |
string |
Device operating system version. Example: 7.0.4 |
[optional] |
| AdId |
string |
The ad id for the device's platform: Android = Advertising Id iOS = identifierForVendor WP8.0 = DeviceUniqueId WP8.1 = AdvertisingId |
[optional] |
| Sdk |
string |
Name and version of the sdk/plugin that's calling this API method (if any) |
[optional] |
| SessionCount |
int |
Number of times the user has played the game, defaults to 1 |
[optional] |
| Tags |
Object |
Custom tags for the player. Only support string and integer key value pairs. Does not support arrays or other nested objects. Setting a tag value to null or an empty string will remove the tag. Example: {"foo":"bar","this":"that"} Limitations: - 100 tags per call - Android SDK users: tags cannot be removed or changed via API if set through SDK sendTag methods. Recommended to only tag devices with 1 kilobyte of data Please consider using your own Database to save more than 1 kilobyte of data. See: Internal Database & CRM |
[optional] |
| AmountSpent |
decimal |
Amount the user has spent in USD, up to two decimal places |
[optional] |
| CreatedAt |
long |
Unixtime when the player joined the game |
[optional] |
| Playtime |
long |
Seconds player was running your app. |
[optional] |
| BadgeCount |
int |
Current iOS badge count displayed on the app icon NOTE: Not supported for apps created after June 2018, since badge count for apps created after this date are handled on the client. |
[optional] |
| LastActive |
int |
Unixtime when the player was last active |
[optional] |
| NotificationTypes |
int |
1 = subscribed -2 = unsubscribed iOS - These values are set each time the user opens the app from the SDK. Use the SDK function set Subscription instead. Android - You may set this but you can no longer use the SDK method setSubscription later in your app as it will create synchronization issues. |
[optional] |
| TestType |
int? |
This is used in deciding whether to use your iOS Sandbox or Production push certificate when sending a push when both have been uploaded. Set to the iOS provisioning profile that was used to build your app. 1 = Development 2 = Ad-Hoc Omit this field for App Store builds. |
[optional] |
| Long |
decimal |
Longitude of the device, used for geotagging to segment on. |
[optional] |
| Lat |
decimal |
Latitude of the device, used for geotagging to segment on. |
[optional] |
| Country |
string |
Country code in the ISO 3166-1 Alpha 2 format |
[optional] |