OneSignal
Overview #
Satori messages supports integration with OneSignal, an engagement platform that enables you to send messages to users across multiple platforms, including iOS, Android, and the web.
Satori’s powerful message templates and schedules, combined with OneSignal’s omni-channel capabilities, allow you to send:
- Repeatable or one-time messages to all players
- Targeted messages to specific audiences
- Messages to players in a specific live event
- Messages over multiple channels (push or email)
To use the OneSignal adaptor, you must have:
- An account with OneSignal. If you do not have an account, you can sign up for one at OneSignal.
- Integrated the OneSignal SDK into your application. For more information, see the OneSignal documentation.
Use Cases #
OneSignal, unlike other integration points, supports multiple communication channels. Satori supports both push notifications and email for OneSignal integration. During a message schedule, when you select OneSignal for integration, you will be asked to select either Push Notifications or Email for OneSignal integration setup.
Push Notifications
Push notifications are a fast way to re-engage players at timely moments, such as:
- Start or progress of a tournament
- Update on the availability of a shop item or promotion
- A reward that they can claim
Using OneSignal push notifications, you can reach your players on any device (including iOS, Android, and web) with a single integration.
Emails
As an omnichannel solution, OneSignal also provides email integration. If you collect player emails, you can reach them via Satori’s OneSignal integration too. With Satori’s HTML templates, you can send visually appealing emails that promote your content in a customizable format. Some use cases for Satori’s OneSignal integration can be:
- Inform players about a major update to your game
- Reach players who have not logged in for some time. It is more likely that you will have a better reach to those players via email instead of push notifications
- Promote another one of your games
Configuration #
Enable the integration in “Settings > Integrations” in Satori. You’ll need:
- App ID: The OneSignal App ID
- API Key: The private key to use the OneSignal APIs
You can find both in your OneSignal dashboard under “Settings > Keys & IDs”. See OneSignal documentation for details.
Match Identities between OneSignal and Satori #
To send a message via OneSignal, your game client must obtain the OneSignal ID and write it to the Satori identity property PushTokenOneSignalPlayerID. This will ensure that Satori can accurately target and deliver messages to the correct players.
You can set default properties either when authenticating a user or by updating identity properties.
