Overview

OneSignal is a platform for mobile push notifications, web push, email, and in-app messaging. OneSignal provides a simple interface to push notifications and email, letting content creators focus on quality user engagement instead of complex implementation.

Integrate Lytics and OneSignal to trigger push notifications to users in your rich, cross-channel Lytics audiences. You can import user data from OneSignal such as device details and aggregate activity data for use in your Lytics audiences.

Authorization

If you haven't already done so, you will need to set up a OneSignal account before you begin the process described below. You will need your OneSignal User Auth Key. See OneSignal's Account and Keys documentation for instructions on obtaining your key.

If you are new to creating authorizations in Lytics, see the Authorizations documentation for more information.

  1. Select OneSignal from the list of providers.
  2. Select the OneSignal method for authorization.
  3. Enter a Label to identify your authorization.
  4. (Optional) Enter a Description for further context on your authorization.
  5. Enter your User Auth Key
  6. Click Save Authorization.

onesignal-auth

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 Integration.
  • Implementation Technique: REST API Integration.
  • Frequency: User data is a Batch Integration, 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:

  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 an import users job for OneSignal. If you are new to creating jobs in Lytics, see the Data Sources documentation for more information.

  1. Select OneSignal from the list of providers.
  2. Select the Import Audiences & Activity Data job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the Apps to import data from. Apps in the right column will be imported.
  7. Select Keep Updated to import users continuously. The import will run every 24 hours.
  8. Click Start Import.

OneSignal Import Config

Export Audiences

The OneSignal Export Audiences workflow will send audience membership data to OneSignal as tags, which are used to create segments in OneSignal. For more information about tags see the OneSignal Using Data Tags documentation.

The only identifier accepted by OneSignal for export is the OneSignal ID, which will be selected in the configuration form by default if OneSignal data was already imported.

Integration Details

  • Implementation Type: Server-side Integration
  • Implementation Technique: REST API Integration.
  • Frequency: Real-time Integration.
  • Resulting data: Segments in OneSignal.

This integration utilizes the OneSignal APIs to send user data. Once the user initiates an export, the workflow will:

  1. Take a group of Audiences in Lytics.
  2. Export them to segments in OneSignal.

Fields

By default, Lytics exports the following field to OneSignal.

Lytics User FieldDescriptionOneSignal FieldType
os_idOneSignal Player IDos_idstring

Configuration

Follow these steps to set up an export of audiences job for OneSignal. If you are new to creating jobs in Lytics, see the Destinations documentation for more information.

  1. Select OneSignal from the list of providers.
  2. Select the Export Audiences job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the OneSignal Player ID to configure the field that contains OneSignal Player ID.
  7. Select the Audiences to export.
  8. Select Existing Users to complete the workflow with existing users in the selected Lytics audience(s).
  9. Click Start Export.

OneSignal Export Config