Integrate Amplitude with OneSignal

OneSignal offers a powerful multi-channel platform that includes mobile and web push notifications, in-app messaging, SMS, and email. When you integrate OneSignal with Amplitude, you can develop sound messaging strategies that drive user engagement and optimize conversions. For example, you can export behavioral cohorts from Amplitude to OneSignal to create dynamically responsive audiences. You can also send OneSignal engagement events back to Amplitude, initiating a cohesive data loop from one platform to the other. 

OneSignal and Amplitude work together to enable you to:

• Sync data in real-time to Amplitude for your OneSignal engagement events
• Sync cohorts from Amplitude to OneSignal to facilitate sending targeted messaging

OneSignal automatically sends events from OneSignal to Amplitude, for mobile push, web push, email, SMS, and in-app message channels. Event options include:

• Sent: The message has been sent to the provider
• Clicked: The user has clicked and interacted with the message
• Viewed: The user has viewed the message
• Confirmed Delivery: The message has been delivered by the provider to the user

NOTE: Any events you send from OneSignal to Amplitude will count towards your Amplitude event volume quota. 

For more information on how to set up and utilize this integration, see OneSignal’s documentation.

Before you begin

• This integration is only available for customers who have paid plans with both OneSignal and Amplitude.
• This integration doesn’t support anonymous users. You’ll have to set a user ID for each user in order to identify them between Amplitude and OneSignal. From OneSignal, you can use the external id to do this. 
• Anonymized UUID as identifiers in both Amplitude and OneSignal will work in this context, so you don't have to send email / PII to Amplitude.
• The Amplitude Integration is available with OneSignal Growth package and higher tiers. Please contact support@onesignal.com with any additional questions.

Set up the integration

To set up the integration and export behavioral cohorts to OneSignal, follow these steps:

1. Sign up for an Amplitude and a OneSignal account. Amplitude's Quick Start Guide will walk you through how to set up your Amplitude organization and create your first project. To create a OneSignal account, visit www.onesignal.com, where you can sign up for free. Then select a Growth plan, as this integration is only available to paid customers. 
2. Retrieve your OneSignal API key by opening OneSignal and navigating to Settings → Keys & IDs. Copy the App ID and the API key.
   
   
   
3. In Amplitude, navigate to Sources & Destinations --> {project name} --> Destinations --> OneSignal. In the modal window, type in the OneSignal data import key and select the relevant endpoint.

NOTE: This integration must be enabled on a per-project basis.

4. Click Save. You should now see the status change to Active.
5. To export users from Amplitude to OneSignal, first create the cohort of users you wish to export. Learn more about cohorts in Amplitude. 
6. Once you have created the cohort, click Sync to... to export these users to OneSignal. You can then go into OneSignal and use their features on these users.
   
   
   
7. Once you have exported the cohort to OneSignal, you can create a segment in OneSignal that includes the cohort. To do this, create a segment and direct Amplitude to select cohorts that have been synced. This will restrict the segment to the users in the cohort.
   
   Select the frequency at which you'd prefer your cohorts to sync with OneSignal. This can be done as a one-time sync, or you can set it up to occur a regularly-scheduled intervals. 
   
   
8. Click Save Segment to complete the process.