OneSignal New Destination

1. Log in to the OneSignal dashboard.
2. Navigate to Segment App > Settings > Analytics > Segment.com and click Activate.
3. The Segment App opens in a new window. Log in to authenticate the connection from OneSignal.
4. Select the workspace and source to connect with OneSignal.

OneSignal supports the following methods, as specified in the Segment Spec.

Send Identify calls to update users. For example:

1
analytics.identify('userId123', {
2
  firstName: 'John',
3
  lastName: 'Doe',
4
     country: 'USA'
5
});

Segment sends Identify traits as Player Data Tags in OneSignal.

Expand image

Send Track calls to update Data Tags. For example:

1
analytics.track('Add to Cart', {
2
    product_name: 'Sunglasses',
3
    brand: 'Rayban'
4
})

OneSignal stores Track properties as Data Tags but drops the event name. In the example, Add to Cart is dropped.

To keep the event names on OneSignal Data Tags, append the event name to the properties. For example, Add_to_Cart_brand instead of brand.

Expand image

You can send Computed Traits and Audiences generated using Engage to OneSignal.

Engage audiences appear as a segment in OneSignal.

Track calls from Audiences create a OneSignal segment with the audience name.

Identify calls from Audiences create a OneSignal segment with the audience name and add Data Tags on all the matching user records.

Expand image

Audiences sends Identify and Track calls to OneSignal when a user enters or exits the Audience.

OneSignal stores Track and Identify calls from Engage Computed Traits as Data Tags for the OneSignal User/Player's records.

• Segment sends user traits to OneSignal as Data Tags. The number of data tags OneSignal allows depends on your OneSignal pricing plan. OneSignal drops the data tags that go over your set number.
• OneSignal always updates the firstName and the lastName properties for matching users. All other traits are added or updated on a first-come basis. firstName and lastName tags are stored as first_name and last_name.
• Send User properties to OneSignal with blank or null values to remove the corresponding Data Tag from the OneSignal user record.
• OneSignal doesn't store email and phone properties. To update email and phone properties in OneSignal, create a player record with the email address and/or a phone number and map those records with the External_User_ID. Additional properties from Segment map across all your matching records, including email and phone number records.

Segment lets you change these destination settings from the Segment app without having to touch any code.