Passer au contenu principal
Cette page fait partie de Application d’exemple : une intégration OneSignal complète, qui suit une application réelle de bout en bout. L’application s’appelle Clean Beans, un planning de ménage pour les logements partagés, construite avec Expo (React Native) et un backend Supabase. Tout le reste dépend de quatre éléments : le SDK est installé, il démarre en même temps que l’application, chaque appareil est rattaché à un utilisateur et les utilisateurs peuvent contrôler ce qu’ils reçoivent.

Installer avec le plugin Expo \

Le onesignal-expo-plugin configure les projets natifs iOS et Android au moment de la compilation. Il ajoute la capacité push, l’App Group et la Notification Service Extension dont OneSignal a besoin pour les images, les badges et la confirmation de livraison.
app.json

Initialiser une seule fois, à la racine \

Clean Beans initialise OneSignal dans son layout racine, de sorte que l’initialisation s’exécute une fois à chaque lancement, avant l’affichage de tout écran.
app/_layout.tsx
Demander l’autorisation au premier lancement est l’approche la plus simple. Pour expliquer d’abord l’intérêt, affichez un message in-app avant l’invite système. Clean Beans en a un prêt à l’emploi : consultez Pré-invite d’autorisation push.

Rattacher chaque appareil à un utilisateur \

Lorsqu’une personne se connecte, l’application transmet son ID utilisateur Supabase à OneSignal.login(). Cet ID devient l’External ID. Lorsqu’elle se déconnecte, logout() détache l’appareil afin que la personne suivante qui se connecte n’hérite pas de ses messages.
app/_layout.tsx
Attendez que la session enregistrée soit chargée avant d’appeler l’une ou l’autre méthode. Lors d’un démarrage à froid, l’utilisateur connecté est brièvement inconnu. Si l’application appelle logout() à ce moment-là puis login() un instant plus tard, l’abonnement push de l’appareil peut rester rattaché à un utilisateur anonyme, et les push adressés à l’External ID n’atteignent plus le téléphone. N’appelez logout() que lorsqu’une personne se déconnecte réellement.
C’est cet unique appel qui rend possibles tous les envois backend de ce guide. Une fonction qui connaît l’ID d’un utilisateur dans la base de données peut lui envoyer des messages sans rien savoir de ses appareils.

Ajouter le canal e-mail \

L’application connaît déjà l’adresse e-mail de chaque utilisateur depuis son inscription, elle l’enregistre donc comme abonnement e-mail à la connexion. OneSignal ignore les appels répétés avec la même adresse.
src/lib/onesignalSync.ts
Le SMS s’ajoute de la même manière avec addSms(), mais uniquement après la vérification du numéro. Consultez SMS : codes de vérification et invitations.

Laisser les utilisateurs contrôler ce qu’ils reçoivent \

L’écran des paramètres de notification comporte un interrupteur principal et un interrupteur par type de message.
L'écran des paramètres de notification avec un interrupteur principal et des interrupteurs par type

Paramètres de notification : un interrupteur principal, des interrupteurs par type et l'heure du rappel quotidien.

L’interrupteur principal appelle optOut() et optIn() sur l’abonnement push, de sorte que OneSignal interrompt puis reprend la livraison vers cet appareil.
app/notification-settings.tsx
Chaque interrupteur est aussi enregistré dans la ligne du profil de l’utilisateur. Le backend lit ces colonnes avant d’envoyer quoi que ce soit, ce qui permet d’appliquer les préférences par type.
src/lib/database.ts
Stocker les préférences dans votre propre base de données et les vérifier avant chaque envoi permet de garder la logique au même endroit. L’alternative consiste à les stocker sous forme de tags et à filtrer par tag dans OneSignal. Cela fonctionne bien lorsque vous envoyez à des segments. Clean Beans envoie à des utilisateurs précis, il est donc plus simple de vérifier la base de données.

Référence du SDK mobile

Toutes les méthodes client utilisées dans ce guide.

Utilisateurs et External IDs

Comment l’identité relie les abonnements entre canaux et appareils.