Connect OneSignal push notifications

OneSignal sends your app's mobile push. Its free plan covers up to 1,000 monthly active app users; above that, OneSignal needs a paid plan. Connecting it has two parts: your App ID, which you copy from OneSignal into Vunda, and push credentials you set up inside OneSignal so it can deliver to Apple and Google.

What you will need

• A OneSignal account (the free plan covers up to 1,000 monthly active app users).
• An Apple Developer account (for the iOS APNs key).
• A Firebase project (for the Android FCM credential).

Step 1: enable OneSignal and paste your App ID

In Vunda, open Integrations, choose the OneSignal card, and turn on Enable OneSignal. Paste your public App ID (a UUID like 00000000-0000-0000-0000-000000000000) into the App ID field. The App ID is safe to ship in your app; it is not a secret.

Step 2: set up sending credentials inside OneSignal

This step happens inside OneSignal and Apple/Google, not in Vunda, so the exact screens are owned by those providers. Verify each step against their current guides (linked below) before you rely on it.

• iOS. In your Apple Developer account create an APNs authentication key and download the .p8 file. In OneSignal, go to Settings then Push & In-App, choose Apple iOS (APNs), and upload the .p8 with your Key ID, Team ID, and app Bundle ID. (Source: OneSignal iOS p8 / APNs.)
• Android. In OneSignal, go to Settings then Push & In-App, choose Google Android (FCM), and upload your Firebase service-account JSON. (Source: OneSignal Android Firebase credentials.)

Step 3: report each upload in Vunda

Vunda cannot see inside your OneSignal account, so once each credential is uploaded, tell Vunda. Back in Integrations, open the OneSignal card and find Push credentials. Click I uploaded the APNs key (.p8) to OneSignal after the iOS step and I uploaded the FCM credential to OneSignal after the Android step.

These buttons record your own report; they are not a verification. Before your next build is published, Vunda staff check in OneSignal that both credentials are in place for your app, and the Publish page lists that check as a Vunda step until it is done. Your keys stay in OneSignal: nothing is uploaded to Vunda. If you later switch provider or change your App ID, the reports reset and you will be asked again.

After you connect

Publish a new version of your app from the Publish page. Once that build is live, push works on shoppers' devices. Send campaigns and build journeys, such as abandoned-cart flows using the cart tags the app sets, from your OneSignal dashboard.