Documentation / Product / Integrations / OneSignal

OneSignal: Import Users

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 workflow will proceed as follows:

  1. Get the apps as requested.
  2. Filter for valid App IDs.
  3. 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 FieldLytics User FieldDescriptionType
session_countsession_countSession Countint
languageos_languageOneSignal Languagestring
timezoneos_timezoneTimezoneint
game_versionos_app_versionApp versionstring
device_osos_device_osDevice OSstring
device_typeos_device_typeDevice Typeint
device_modelos_device_modelDevice Modelstring
last_activeos_last_active_tsLast Active on OneSignaldate
last_activelast_active_tsLast Active on Any Channeldata
playtimeos_total_time_in_appTotal time in appint
amount_spentos_total_amount_spentTotal Amount Spentfloat
created_atos_created_atCreated Atdata
invalid_identifieros_unsubscribedUnsubscribedboolean
badge_countos_badge_countBadge Countint
latlatLatitudefloat
lonlonLongitudefloat
countrycountryCountrystring

Configuration

Follow these steps to set up and configure an import of OneSignal users in the Lytics platform.

  1. Navigate to the Integrations page and select OneSignal. onesignal 215
  2. Select Workflows from the menu on the left.
  3. Select Import Users from the list of workflows.
  4. Select the Authorization you would like to use.
  5. Select the Apps to import data from. Apps in the right column will be imported. OneSignal Import Config
  6. By default the import will run every 24 hours. To run the import once, unselect Keep Updated.
  7. Click Start Import.