OneSignal
Why combine OneSignal and Purchasely?
Pre-requisites
The minimal version of the Purchasely SDK supporting this integration is v3.2.0. If the Purchasely SDK integrated in your app is under the minimal version, please update it.
The OneSignal SDK also needs to be integrated inside the app.
Subscription events
General overview
OneSignal is one of the leading customer engagement solutions for Push Notifications, Email, SMS & In-App.
This integration will allow you to get all Purchasely subscription events to OneSignal making you able to trigger automated communication based on those events, messages that could be linked to a Purchasely powered paywall to engage, upsell, retain customers.
Purchasely provides a unified dataset to track the subscription events for all stores. These events are generated by the Purchasely Backend and your OneSignal users' can be updated accordingly.
Subscription events generated by Purchasely will be sent to OneSignal using a server-to-server integration. As a result, you will be able to see all the subscription events in your OneSignal Dashboard and map them with your acquisition campaigns.
Events
The following events are the main ones that will trigger an udpate of your OneSignal users by Purchasely. See the full list here.
Properties
The following properties are the main ones this integration can set and update in your OneSignal users as tags:
The properties' names set in OneSignal can be overriden when setting up the integration.
Integrating Purchasely with OneSignal
The integration requires 2 steps:
Associate the user to events by providing the
OneSignal Player ID
to the Purchasely SDKActivate the OneSignal integration in the Purchasely Console
1. Associating users to events
See the OneSignal Documentation for more information
2. Activating the OneSignal integration
The activation requires 2 steps:
Retrieving your app id and API key in the OneSignal Dashboard
Enabling the OneSignal integration in the Purchasely Console
a. Retrieving your app token and your app's API key in the OneSignal Dashboard
Log into your OneSignal dashboard: https://app.onesignal.com/login
Access your App
3. Got to your App's Settings
4. Access the "Keys" submenu
5. Your app’s app id is beneath the OneSignal App ID
title
6. Your app's API key is beneath the Rest API Key
title
b. Enabling the OneSignal integration in the Purchasely Console
Go in the "External integrations" section, and open the edition form for OneSignal:
2. Enable the integration
3. Set your OneSignal app id
4. Set your OneSignal app API key
5. Enable the properties you want to be set and updated as OneSignal tags
for your users
6. (Optional) Override the property names that will be used when updating your users' OneSignal tags
7. Save
Testing your integration
To test your integration, you can perform a set of in-app purchases in a Sandbox environment (eg: TestFlight for the App Store) and verify your user's tags
are properly updated in the OneSignal dashboard (https://app.onesignal.com/login).
If testing using Automated Messages, bear in mind that OneSignal automated messages are sent roughly every 4-6 hours if you are on a free plan, and within a few minutes if you are on a paid plan.
Last updated