- Premiers pas : trouvez votre App ID et vos clés API
- Installer le SDK : installez le SDK mobile ou web
- Utilisateurs et identité : identifiez les Utilisateurs, gérez les Abonnements et sécurisez l’accès
- Tester votre intégration : vérifiez la livraison avant le lancement
- Dépannage : déboguez les problèmes de livraison
Premiers pas
Si votre équipe dispose déjà d’un compte OneSignal, demandez à un administrateur de vous inviter dans l’Organisation. Sinon, créez un compte pour commencer. Votre App OneSignal contient les données des utilisateurs et des messages, y compris l’App ID et les clés API dont vous avez besoin pour la configuration du SDK. Découvrez comment les Apps, Organisations et comptes sont liés si vous gérez plusieurs projets ou environnements.Clés et ID
Trouvez votre App ID, clé API REST et Organization ID pour l’authentification.
Installer le SDK
Installez le SDK OneSignal pour votre plateforme.Configuration du SDK mobile
Configuration du SDK pour iOS, Android, Huawei et Amazon. Active les notifications push, les messages in-app et les Live Activities.
Configuration du SDK web
Installation du Web SDK et configuration des notifications push du navigateur.
- Windows
- macOS (les applications Mac Catalyst sont prises en charge via notre SDK iOS)
- watchOS et Wear OS
Utilisateurs et identité
OneSignal attribue à chaque personne un OneSignal ID et suit ses appareils, adresses email et numéros de téléphone en tant qu’Abonnements. Les Utilisateurs sont anonymes jusqu’à ce que vous appeliezlogin avec un External ID pour les identifier. L’identification des Utilisateurs unifie leurs Abonnements sur tous les canaux et appareils.
Utilisateurs
Modèle d’Utilisateur, External ID, Utilisateurs anonymes vs. identifiés, et login/logout.
Abonnements
Appareils, adresses email et numéros de téléphone qui reçoivent vos messages.
Tags
Ajoutez des propriétés personnalisées aux utilisateurs pour la personnalisation et la segmentation.
Événements personnalisés
Suivez les actions des Utilisateurs pour déclencher des Journeys ou alimenter les analyses.
Tester votre intégration
Vérifiez la livraison, le rendu et les deep links avec des Utilisateurs de test avant d’envoyer à toute votre audience.Utilisateurs de test
Trouvez et configurez des utilisateurs de test pour push, email et SMS.
Dépannage
Commencez par un journal de débogage, puis utilisez le guide de plateforme correspondant à votre intégration.Dépannage mobile
Résolvez les problèmes courants de livraison push, d’APNs et de messagerie in-app.
Dépannage du SDK web
Corrigez les erreurs de service worker, les incohérences d’origine et les notifications qui ne s’affichent pas.
Journaux de débogage
Activez la journalisation détaillée, reproduisez le problème et partagez les journaux avec le support.
Réinitialiser les permissions push web
Effacez le cache du navigateur, les service workers et les permissions de notification pour un test propre.
Après la configuration
Explorez les cas d’utilisation courants et consultez les méthodes SDK ou les endpoints de l’API REST au fil de votre développement.Tutoriels et cas d'utilisation
Parcourez les guides d’implémentation pour les paniers abandonnés, les flux d’intégration, les campagnes de réengagement et plus encore.
Tags
Ajoutez des propriétés personnalisées aux utilisateurs pour la personnalisation et la segmentation.
Événements personnalisés
Suivez les actions des Utilisateurs pour déclencher des Journeys ou alimenter les analyses.
Référence SDK mobile
Méthodes, classes et hooks d’événements pour les SDK iOS, Android et multiplateformes.
Référence SDK web
Initialisation, gestion des Utilisateurs, méthodes d’Abonnement et déclencheurs personnalisés.
Référence SDK serveur
Installez et configurez les SDK serveurs pour Node.js, Python, Java, Go, PHP, Ruby, C# et Rust.
Présentation de l'API REST
Endpoints, authentification, limites de débit et formats de requête/réponse.
FAQ
Comment identifier les Utilisateurs sur plusieurs appareils ?
AppelezOneSignal.login("your_external_id") sur chaque appareil après la connexion de l’utilisateur. OneSignal fusionne tous les Abonnements avec le même External ID sous un seul Utilisateur. Consultez Utilisateurs pour les détails d’implémentation.
Dois-je configurer la vérification d’identité ?
La vérification d’identité est optionnelle mais fortement recommandée pour les applications en production. Sans elle, n’importe quel client peut appelerlogin avec un External ID arbitraire. L’activation de la vérification d’identité nécessite de mettre à jour le SDK OneSignal pour utiliser un JWT généré par le serveur, empêchant ainsi l’usurpation d’identité.