Skip to content

Latest commit

 

History

History
39 lines (31 loc) · 4.74 KB

Player.md

File metadata and controls

39 lines (31 loc) · 4.74 KB

Player

Properties

Name Type Description Notes
id String The device's OneSignal ID [optional] [readonly]
invalidIdentifier Boolean If true, this is the equivalent of a user being Unsubscribed [optional] [readonly]
appId String [optional]
deviceType Integer 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 Integer 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 Integer 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 BigDecimal 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 Integer 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 Integer Unixtime when the player was last active [optional]
notificationTypes Integer 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 Integer 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 BigDecimal Longitude of the device, used for geotagging to segment on. [optional]
lat BigDecimal Latitude of the device, used for geotagging to segment on. [optional]
country String Country code in the ISO 3166-1 Alpha 2 format [optional]