Passer au contenu principal

​
Vue d’ensemble

Les guides suivants vous aideront à configurer le SDK OneSignal dans vos applications mobiles. Pour les sites web, consultez Configuration web. Pour chaque plateforme que votre application mobile prend en charge, vous devrez établir une connexion avec FCM (Android), APNS (iOS), HMS (Huawei) et/ou ADM (Amazon). Utilisez les options ci-dessous pour configurer votre application et plateforme OneSignal.

​
Configurer votre application OneSignal et votre plateforme

Configuration requise pour les notifications push Pour commencer à envoyer des notifications push avec OneSignal, vous devez d’abord configurer votre application OneSignal avec toutes les plateformes que vous prenez en charge—Apple (APNs), Google (FCM), Huawei (HMS), et/ou Amazon (ADM).
Si votre organisation possède déjà un compte OneSignal, demandez à être invité avec un rôle administrateur pour configurer l’application. Sinon, inscrivez-vous pour un compte gratuit pour commencer.
Vous pouvez gérer plusieurs plateformes (iOS, Android, Huawei, Amazon, Web) sous une seule application OneSignal.
1

Créer ou sélectionner votre application

  • Pour ajouter des plateformes à une application existante, allez dans Settings > Push & In-App dans le tableau de bord OneSignal.
  • Pour repartir de zéro, cliquez sur New App/Website et suivez les instructions.

L'exemple montre la création d'une nouvelle application.

2

Configurer et activer une plateforme

  • Choisissez un nom clair et reconnaissable pour votre application et votre organisation.
  • Sélectionnez la ou les plateformes que vous souhaitez configurer (iOS, Android, etc.).
  • Cliquez sur Next: Configure Your Platform.

Exemple de configuration de votre première application, organisation et canal OneSignal.

3

Configurer les identifiants de plateforme

Suivez les instructions en fonction de vos plateformes :Cliquez sur Save & Continue après avoir saisi vos identifiants.
4

Choisir le SDK cible

Sélectionnez le SDK qui correspond à votre plateforme de développement (par exemple, iOS, Android, React Native, Unity), puis cliquez sur Save & Continue.

Sélectionnez le SDK que vous utilisez pour accéder à la documentation.

5

Installer le SDK et enregistrer votre App ID

Une fois votre plateforme configurée, votre OneSignal App ID sera affiché. Copiez et enregistrez cet ID—vous en aurez besoin lors de l’installation et de l’initialisation du SDK.Si vous collaborez avec d’autres personnes, utilisez le bouton Invite pour ajouter des développeurs ou des membres de l’équipe, puis cliquez sur Done pour terminer la configuration.

Enregistrez votre App ID et invitez des membres d'équipe supplémentaires.

Une fois terminé, suivez le guide d’installation du SDK pour votre plateforme sélectionnée afin de terminer l’intégration de OneSignal.

​
Guides de configuration du SDK

Google Android natif
Guide d’intégration de OneSignal dans les applications Android natives utilisant FCM.

iOS natif
Configuration du SDK iOS natif utilisant le service APNS d’Apple.

Huawei Android natif
Configuration du SDK pour les appareils Huawei utilisant les services push HMS.

Unity
Guide SDK multiplateforme pour les applications mobiles basées sur Unity.

React Native & Expo
Instructions de configuration pour les environnements React Native et Expo.

Cordova
Guide SDK hérité pour les applications Cordova utilisant des frameworks plus anciens.

Ionic & Ionic Capacitor
Configuration pour les applications mobiles hybrides Ionic et Capacitor.

Flutter
Guide SDK pour les applications Flutter utilisant Dart.

.NET MAUI
Guide d’intégration avec les applications .NET MAUI.

​
Intégrations

​
FAQ

​
Les SDK sont-ils requis ?

Non, mais ils sont fortement recommandés — et open source sur GitHub. Vous pouvez intégrer OneSignal en utilisant uniquement nos API côté serveur, mais l’utilisation de nos SDK simplifie et rationalise le processus, en particulier pour la gestion des notifications push sur plusieurs plateformes.

​
Ce que vous pouvez faire sans le SDK :

Vous pouvez utiliser les API suivantes directement :
Si vous prévoyez d’utiliser les messages in-app, notre SDK est requis.

​
Pourquoi nous recommandons l’utilisation des SDK :

Les notifications push ont des exigences spécifiques à la plateforme que nos SDK gèrent pour vous, notamment :
  • Obtention des tokens push sur Android, iOS, Huawei et Web
  • Gestion du statut d’abonnement et des invites utilisateur pour l’opt-in
  • Affichage et traitement des notifications push sur le client
Les APNS d’Apple et le FCM de Google utilisent des formats de charge utile différents. Les notifications OneSignal incluent une charge utile personnalisée que notre SDK analyse pour afficher et suivre les messages avec précision. La gestion manuelle de cela ajoute de la complexité. En savoir plus : Build vs. Buy: What Goes Into Building a Push Notification Platform

​
Les appareils en Chine peuvent-ils recevoir des notifications push ?

Si l’appareil dispose de Google Play Services/Store, il recevra des notifications push via FCM (Firebase Cloud Messaging). Si l’application a été téléchargée depuis le Huawei AppGallery, elle recevra des notifications push via HMS (Huawei Messaging Service). Vous devrez configurer notre SDK Huawei. OneSignal utilise FCM par défaut pour les appareils qui prennent en charge à la fois HMS et FCM. Vous pouvez configurer le SDK Huawei pour préférer HMS à FCM.

​
Les appareils Huawei non-HarmonyOS exécutant Android peuvent-ils recevoir des pushs de OneSignal ?

Oui, les appareils Huawei non-HarmonyOS exécutant Android peuvent toujours utiliser notre SDK Huawei.