Passer au contenu principal

Aperçu de l'intégration OneSignal + Amplitude

Intégrez OneSignal avec Amplitude pour envoyer des événements de messages détaillés, des événements personnalisés et importer des cohortes d’utilisateurs comportementales. Cela permet un ciblage en temps réel basé sur le comportement des utilisateurs pour améliorer l’intégration, le réengagement et la conversion.

​
Avantages clés

  • Envoyer des événements de messages à Amplitude : Suivez la livraison, les clics, les échecs et bien plus encore via push, in-app, e-mail et SMS.
  • Envoyer des événements personnalisés à OneSignal : Envoyez vos événements personnalisés d’Amplitude vers OneSignal.
  • Importer des cohortes depuis Amplitude : Synchronisez automatiquement les cohortes basées sur le comportement dans OneSignal en tant que filtres de ciblage.
Il s’agit d’une intégration au niveau de l’application, vous donnant un contrôle granulaire sur les applications et les événements liés.

​
Prérequis

Cette intégration ne crée pas d’utilisateurs. Elle mappe les utilisateurs dans Amplitude avec ceux dans OneSignal.

​
Configuration

​
Ajouter Amplitude à OneSignal

Dans OneSignal, accédez à Données > Intégrations > Amplitude et cliquez sur Activer.

Carte d'intégration Amplitude dans OneSignal

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.

​
Sélectionner les événements de messages

Sélectionnez les événements de messages OneSignal que vous souhaitez envoyer à Amplitude. Une fois terminé, cliquez sur Activer.

Paramètres Amplitude dans OneSignal

​
Ajouter OneSignal à Amplitude

Dans vos Destinations Amplitude, recherchez OneSignal.

Ajouter la destination OneSignal dans Amplitude

Options :
  • 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.
Une fois que vous sélectionnez l’une ou les deux options, vous serez invité à saisir les informations suivantes :
  • Nom : Comment vous identifiez la destination dans Amplitude. Définissez ceci sur quelque chose d’identifiable comme OneSignal - APP_NAME où APP_NAME est le nom de l’application dans OneSignal.
  • ID de l’application : L’ID d’application OneSignal. Disponible dans OneSignal Paramètres > Clés et ID
  • Clé API : La clé API OneSignal. Disponible dans OneSignal Paramètres > Clés et ID

​
Envoyer des événements

Fonctionnalité bêta. Vous devez avoir la fonctionnalité Événements personnalisés activée dans OneSignal pour envoyer des événements personnalisés à OneSignal.
Activez cette option si vous souhaitez envoyer des événements personnalisés d’Amplitude vers OneSignal. Sélectionnez les événements Amplitude que vous souhaitez envoyer à OneSignal.

Événements Amplitude à envoyer à OneSignal

​
Mappage des ID utilisateur

Cette étape est essentielle pour que la synchronisation des cohortes et le suivi des événements fonctionnent correctement.
Pour faire correspondre les utilisateurs entre les deux systèmes :
  • Utilisez un identifiant partagé : L’ID externe dans OneSignal doit correspondre à une propriété d’ID utilisateur Amplitude sélectionnée (comme user_id).
  • Vérifiez que la propriété utilisateur sélectionnée existe dans vos profils utilisateur Amplitude et OneSignal.

​
Propriétés supplémentaires

Vous pouvez envoyer des propriétés supplémentaires à OneSignal qui seront incluses dans les événements personnalisés. Ceci est utile pour traiter les événements dans OneSignal uniquement s’ils contiennent une propriété spécifique.
Cliquez sur Enregistrer lorsque vous avez terminé.Vous devriez maintenant pouvoir exporter des cohortes et des événements personnalisés d’Amplitude vers OneSignal et collecter des événements de messages de OneSignal vers Amplitude.

​
Test des événements personnalisés

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

Amplitude > Destination des événements OneSignal

  1. 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.
  2. Cliquez sur le bouton Envoyer un événement de test
  3. La boîte de réponse devrait rester vide et vous devriez voir un message indiquant "OneSignal has successfully received test event."

Exemple de réponse

Si vous obtenez une erreur, assurez-vous que votre ID d’application OneSignal et votre clé API REST sont ajoutés correctement à Amplitude et que l’application est configurée pour les événements personnalisés.
  1. Dans OneSignal, accédez à Données > Événements personnalisés et vous devriez voir l’événement de test dans la liste.

Événement personnalisé dans OneSignal

Si vous ne voyez pas l’événement, assurez-vous que le "user_id" est défini sur l’ID externe d’un utilisateur existant dans votre application OneSignal.

​
Exporter les cohortes Amplitude vers OneSignal

Vous pouvez synchroniser les utilisateurs de vos cohortes Amplitude avec les utilisateurs dans OneSignal tant qu’ils ont la propriété User ID/External ID correspondante discutée à l’étape précédente. L’exportation des données utilisateur depuis Amplitude ne crée pas l’utilisateur dans OneSignal, l’utilisateur doit déjà exister et avoir l’ID externe correspondant. Pour exporter des utilisateurs d’Amplitude vers 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.

Image montrant comment définir une synchronisation pour vos cohortes avec OneSignal

​
Création de segment OneSignal

  • La cohorte synchronisée apparaît dans OneSignal comme un filtre de segment Amplitude.
  • Un segment pour la cohorte sera automatiquement créé si les conditions suivantes sont remplies :
    • Les utilisateurs de la cohorte Amplitude existent également dans OneSignal avec l’ID externe correspondant.
    • Vous ne devez pas dépasser votre limite de segments dans OneSignal.
Si les deux conditions sont remplies, OneSignal générera automatiquement un segment utilisant le filtre de cohorte Amplitude et le nom de la cohorte.

Comment créer un segment à partir d'une cohorte Amplitude

Questions courantes :

​
Suivre les événements de messages dans Amplitude

Une fois connecté, OneSignal enverra les événements de messages à Amplitude en temps réel.

​
Événements de messages

Voici les types d’événements de messages que OneSignal envoie à Amplitude. Vous pouvez sélectionner lesquels de ces événements vous souhaitez envoyer à votre projet Amplitude dans les paramètres d’intégrations OneSignal.
Type d’événement de message (OneSignal)Nom de l’événement de message (Amplitude)Description de l’événement
Push Sent[OneSignal] Push SentNotification push envoyée avec succès.
Push Received[OneSignal] Push Confirmed deliveryNotification push reçue avec succès
Push Clicked[OneSignal] Push ClickedNotification push touchée sur l’appareil
Push Failed[OneSignal] Push FailedÉchec d’envoi de la notification push. Consultez le rapport de messages échoués dans OneSignal.
Push Unsubscribed[OneSignal] Push UnsubscribedL’Abonnement s’est désabonné des notifications push.
In-App Impression[OneSignal] IAM DisplayedMessage in-app affiché avec succès sur l’appareil
In-App Clicked[OneSignal] IAM ClickedMessage in-app cliqué sur l’appareil
In-App Page Displayed[OneSignal] IAM Page DisplayedPage du message in-app affichée
Email Sent[OneSignal] Email SentE-mail envoyé avec succès
Email Received[OneSignal] Email Confirmed deliveryE-mail reçu par le destinataire
Email Opened[OneSignal] Email OpenedE-mail ouvert par le destinataire
Email Link Clicked[OneSignal] Email ClickedLien de l’e-mail cliqué
Email Unsubscribed[OneSignal] Email UnsubscribedDésabonnement de l’e-mail par le destinataire
Email Reported As Spam[OneSignal] Email Reported As SPAME-mail signalé comme spam par le destinataire
Email Bounced[OneSignal] Email Hard BouncedE-mail retourné à l’expéditeur en raison d’une erreur permanente
Email Failed[OneSignal] Email Failed deliveryImpossible de livrer l’e-mail dans la boîte de réception du destinataire
Email Suppressed[OneSignal] Email Not delivering to suppressed email addressE-mail non livré car le destinataire avait supprimé l’adresse e-mail à laquelle il a été envoyé
SMS Sent[OneSignal] SMS SentSMS envoyé au destinataire
SMS Failed[OneSignal] SMS Failed deliveryÉchec d’envoi du SMS
SMS Delivered[OneSignal] SMS Confirmed deliveerySMS livré avec succès
SMS Undelivered[OneSignal] SMS UndeliveredLe SMS n’a pas pu être envoyé.

​
Propriétés des événements

Voici les propriétés présentes sur tous les événements envoyés de OneSignal vers Amplitude
NOM DE LA PROPRIÉTÉDESCRIPTION
Distinct IDL’external_id associé au message
Message IDL’identifiant du message discret
Message NameLe nom du message
Message TitleLe titre du message
Message ContentsLe contenu du message
message_typeLe type de message envoyé, push, in-app, e-mail, SMS
template_idLe modèle de message utilisé (messages API et Parcours)
subscription_idL’identifiant d’appareil/e-mail/SMS défini par OneSignal
device_typeLe type d’appareil qui a reçu le message
languageLe code de langue à deux caractères de l’appareil
sourceonesignal (est indiqué comme source pour tous les événements)
Voir Pourquoi mes données de livraison ne correspondent-elles pas entre Amplitude et OneSignal ?

​
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 :

​
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.