OneSignal: Import Audiences & Activity Data
Import user data from your Apps in OneSignal such as device details and aggregate activity data for use in your Lytics audiences.
Integration Details
- Implementation Type: Server-side.
- Implementation Technique: REST API .
- Frequency: User data is batch imported, with option of daily continuous updates. By default the import will run every 24 hours.
- Resulting data: Users from your Apps on OneSignal.
This integration utilizes the OneSignal API to receive user data. Each run of the job will proceed as follows:
- Get the apps as requested.
- Filter for valid App IDs.
- Get information on users for all apps and place in the Lytics data stream
onesignal_users.
Fields
The following fields are included in the default mapping of the onesignal_users stream:
| Source Field | Lytics User Field | Description | Type |
|---|---|---|---|
| session_count | session_count | Session Count | int |
| language | os_language | OneSignal Language | string |
| timezone | os_timezone | Timezone | int |
| game_version | os_app_version | App version | string |
| device_os | os_device_os | Device OS | string |
| device_type | os_device_type | Device Type | int |
| device_model | os_device_model | Device Model | string |
| last_active | os_last_active_ts | Last Active on OneSignal | date |
| last_active | last_active_ts | Last Active on Any Channel | data |
| playtime | os_total_time_in_app | Total time in app | int |
| amount_spent | os_total_amount_spent | Total Amount Spent | float |
| created_at | os_created_at | Created At | data |
| invalid_identifier | os_unsubscribed | Unsubscribed | boolean |
| badge_count | os_badge_count | Badge Count | int |
| lat | lat | Latitude | float |
| lon | lon | Longitude | float |
| country | country | Country | string |
Configuration
Follow these steps to set up an import users job for OneSignal. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.
- Select OneSignal from the list of providers.
- Select the Import Audiences & Activity Data job type from the list.
- Select the Authorization you would like to use or create a new one.
- Enter a Label to identify this job you are creating in Lytics.
- (Optional) Enter a Description for further context on your job.
- Select the Apps to import data from. Apps in the right column will be imported.
- Select Keep Updated to import users continuously. The import will run every 24 hours.
- Click Start Import.
