Amplitude

Intégrez OneSignal avec Amplitude pour activer un ciblage en temps réel basé sur le comportement via push, in-app, e-mail et SMS. Cette intégration au niveau de l’application prend en charge trois flux de données :

• Événements de messages → Amplitude : Suivez la livraison, les clics, les échecs et plus encore pour tous les canaux.
• Événements personnalisés → OneSignal : Envoyez des événements Amplitude vers OneSignal pour déclencher des Parcours ou des Segments.
• Cohortes → OneSignal : Synchronisez les cohortes Amplitude basées sur le comportement comme filtres de ciblage dans OneSignal.

---

​

Prérequis

• Compte Amplitude
• Forfait payant OneSignal
• Application OneSignal avec Utilisateurs et ID externe défini.

---

​

Configuration

​

Ajouter Amplitude à OneSignal (Sortie)

Envoie les événements de messages OneSignal vers votre projet Amplitude.

1. Dans OneSignal, naviguez vers Données > Intégrations > Catalogue et sélectionnez Amplitude.
2. Cliquez sur Paramètres, puis ouvrez l’onglet Sortie.
3. Entrez votre jeton API Amplitude, sélectionnez les événements de messages que vous souhaitez envoyer, puis cliquez sur Enregistrer.

​

Dans Amplitude

1. Trouvez votre clé API de projet puis copiez-la dans OneSignal.
2. Si vous utilisez les serveurs EU d’Amplitude, cochez Envoyer des événements exclusivement vers le point de terminaison de résidence EU d’Amplitude. Vous pouvez vérifier cela via votre URL Amplitude. Si vous voyez eu.amplitude.com, vous utilisez les serveurs EU d’Amplitude.

​

Ajouter OneSignal à Amplitude (Entrée)

Dans vos Destinations Amplitude, recherchez OneSignal. Amplitude fournit deux types de destinations OneSignal dans le catalogue :

• Cohortes : Synchroniser les cohortes d’Amplitude vers OneSignal.
• Propriétés utilisateur des événements : Envoyer des événements personnalisés d’Amplitude vers OneSignal.

​

Mappage des ID utilisateur

L’ID externe dans OneSignal doit correspondre à la propriété utilisateur Amplitude que vous sélectionnez (par exemple, user_id). Vérifiez que cette propriété est renseignée dans les deux systèmes — la synchronisation des cohortes et le suivi des événements dépendent d’une correspondance exacte.

​

Propriétés supplémentaires

Vous pouvez inclure des propriétés supplémentaires qui seront attachées aux événements personnalisés dans OneSignal. Ceci est utile pour le traitement conditionnel des événements.

---

​

Test des événements personnalisés

1. Dans Amplitude > Destination des événements OneSignal, cliquez sur le bouton Tester la connexion.

2. Assurez-vous que le "user_id" dans la charge utile est défini sur l’ID externe d’un utilisateur existant dans votre application OneSignal.
3. Cliquez sur le bouton Envoyer un événement de test.
4. La boîte de réponse devrait rester vide et vous devriez voir "OneSignal has successfully received test event."

5. Dans OneSignal, accédez à Données > Événements personnalisés et vérifiez que l’événement de test apparaît dans la liste.

​

Exporter les cohortes Amplitude vers OneSignal

Synchronisez les cohortes Amplitude vers OneSignal en utilisant l’ID externe correspondant configuré ci-dessus. L’exportation ne crée pas d’utilisateurs — chaque utilisateur doit déjà exister dans OneSignal.

1. Dans Amplitude, créez une cohorte. Voir la documentation d’Amplitude sur les cohortes.
2. Cliquez sur Synchroniser et choisissez OneSignal comme destination.
3. Choisissez la fréquence de synchronisation.

​

Création de segment OneSignal

La cohorte synchronisée apparaît dans OneSignal comme un filtre de segment Amplitude. OneSignal crée automatiquement un segment pour la cohorte si :

• Les utilisateurs de la cohorte Amplitude existent également dans OneSignal avec un ID externe correspondant.
• Vous n’avez pas dépassé votre limite de segments dans OneSignal.

---

​

Suivre les événements de messages dans Amplitude

OneSignal envoie les événements de messages suivants à Amplitude en temps réel. Sélectionnez les événements à envoyer dans Données > Intégrations > Amplitude > Sortie.

​

Propriétés des événements

Chaque événement envoyé de OneSignal vers Amplitude inclut ces propriétés :

---

​

FAQ

​

Pourquoi les comptes de ma cohorte et de mon segment ne correspondent-ils pas ?

1. ID externes manquants ou non correspondants Seuls les utilisateurs avec un ID externe OneSignal et un ID utilisateur Amplitude correspondants sont inclus. Cette intégration ne crée pas d’utilisateurs ou d’abonnements.
2. Utilisateurs désabonnés Les segments OneSignal affichent uniquement le compte pour les Abonnements abonnés. Les abonnements désabonnés sont disponibles pour les parcours ou les messages in-app.

Par exemple, si une cohorte Amplitude contient 10 utilisateurs mais que le segment OneSignal affiche 8 abonnements, les 2 utilisateurs manquants peuvent :

• Ne pas exister dans OneSignal ou avoir un ID externe incorrect.
• Avoir des abonnements désabonnés.

Pour vérifier, consultez l’onglet Audience > Utilisateurs dans OneSignal pour voir si les utilisateurs existent et ont des abonnements actifs.

​

Les utilisateurs désabonnés se synchronisent-ils depuis Amplitude ?

Oui, mais ils sont exclus des comptes de segments OneSignal pour le moment. Vous pouvez toujours leur envoyer des messages via les parcours ou les messages in-app s’ils ont d’autres Abonnements ou si leur type d’abonnement le prend en charge.

​

Pourquoi les données de livraison ne correspondent-elles pas ?

Un seul utilisateur peut avoir plusieurs Abonnements (appareils push, adresses e-mail, numéros de téléphone). Chaque abonnement génère son propre événement de livraison. Par exemple :

• 1 utilisateur = 2 Android + 1 iOS + 2 Web = 5 abonnements push
• 1 message push = jusqu’à 5 événements envoyé/reçu/cliqué

Utilisez le subscription_id dans les propriétés d’événement pour tracer la source exacte. Pour résoudre les problèmes d’événements manquants :

• Assurez-vous que OneSignal.login est appelé chaque fois qu’un utilisateur est identifié pour définir l’ID externe.
• Vérifiez que OneSignal.logout ne supprime pas l’ID externe.
• Vérifiez les requêtes API ou les téléchargements CSV qui peuvent modifier l’ID externe.

​

Comment pouvons-nous envoyer des événements utilisateur/abonnement ?

Les événements au niveau utilisateur et abonnement (par exemple, autorisation accordée, connexion/déconnexion utilisateur) ne sont pas envoyés automatiquement. Le SDK OneSignal dispose d’écouteurs d’événements qui peuvent être utilisés pour suivre ces événements afin que vous les envoyiez à Amplitude :

• Observateur d’état utilisateur : SDK Mobile, SDK Web
• Observateur d’autorisation : SDK Mobile, SDK Web

​

Pourquoi l’ID d’abonnement OneSignal est-il ajouté à Amplitude en tant que device_id ?

Amplitude attend un device_id pour la déduplication. OneSignal utilise subscription_id pour cela, qui se mappe automatiquement dans device_id. Consultez la documentation d’Amplitude pour plus d’informations.

---

​

Pages connexes

---