Intégration Amplitude

Assistance d'un développeur requise

Vous aurez besoin de l’aide de votre équipe de développement pour configurer l’intégration. Partagez ce guide avec eux.

Amplitude, une plateforme d’analyse de produits robuste, permet aux entreprises de comprendre le comportement des utilisateurs en temps réel, de suivre les interactions au sein du produit et d’obtenir des informations précieuses sur l’engagement, la rétention et les revenus des utilisateurs.

L’intégration d’Amplitude avec Pushwoosh vous permet de personnaliser les campagnes Pushwoosh avec les données d’Amplitude, de déclencher des campagnes automatisées basées sur les actions des utilisateurs, d’analyser les performances pour une amélioration continue et, finalement, d’améliorer l’engagement, de réduire le taux de désabonnement et d’augmenter les revenus.

Aperçu de l’intégration

Type d’intégration

Destination : Les données sont envoyées d’Amplitude à Pushwoosh.

Prérequis

Pour configurer l’intégration Event Streaming et Cohort Sync d’Amplitude à Pushwoosh, assurez-vous que les prérequis suivants sont remplis :

• Vous devez avoir un compte Pushwoosh actif.
• Générez un API Access Token dans Pushwoosh pour envoyer des données.
• Localisez votre code d’application Pushwoosh avant de configurer l’intégration.
• Cette intégration n’est disponible que pour les clients d’Amplitude ayant des forfaits payants.
• Vous devez avoir un forfait Pushwoosh payant pour utiliser cette intégration.

Glossaire (correspondance des noms d’entités s’ils sont différents)

Cohortes dans Amplitude = Segments dans Pushwoosh

Entités synchronisées

• Événements
• Tags
• Segments

Comment fonctionne l’intégration ?

L’intégration d’Amplitude avec Pushwoosh fonctionne en synchronisant les données entre les deux plateformes pour améliorer l’engagement et la segmentation des utilisateurs. Voici une description détaillée de son fonctionnement :

Transmission des données

• Événements : Amplitude envoie des données d’événements à Pushwoosh. Chaque événement contient un ID utilisateur (external_id), un code d’application (app_id), le nom de l’événement (event_name), un horodatage (created_at) et des propriétés d’événement (properties).

  • Pushwoosh récupère la plateforme depuis properties.platform (iOS, Android ou Web). Un événement sans cette propriété est enregistré comme un événement iOS.
  • Pushwoosh récupère l’ID de l’appareil depuis properties.device_id. En son absence, l’ID utilisateur est utilisé comme ID de l’appareil.
  • Les valeurs de propriétés de tout type sont acceptées et enregistrées comme attributs d’événement. Les nombres et les booléens sont conservés sous forme de texte, et les valeurs vides (null) sont ignorées.
  • Un nouvel événement est créé automatiquement dans Pushwoosh à sa première réception. Les types de ses attributs sont déduits des valeurs : date, entier, booléen, prix ou chaîne. Lorsqu’un événement existant reçoit une nouvelle propriété, Pushwoosh l’ajoute automatiquement comme attribut, dans la limite de 100 attributs par événement. Ces attributs sont typés uniquement à partir du texte, en date, version ou chaîne : une propriété numérique ajoutée plus tard devient donc un attribut de type chaîne.

• Tags : Pushwoosh reçoit des propriétés utilisateur et les enregistre comme tags de l’utilisateur. Chaque requête contient un ID utilisateur (external_id, obligatoire), un code d’application (app_id) et des propriétés utilisateur (properties).

  • Les tags manquants sont créés automatiquement, avec un type déduit de la valeur de la même manière que pour les attributs d’événement.
  • Les propriétés portant le nom d’un tag par défaut de Pushwoosh, comme Language, Country ou Timezone, sont ignorées.

• Segments : Pour chaque cohorte synchronisée, Pushwoosh crée un segment portant le nom de la cohorte. L’appartenance à la cohorte est enregistrée comme une valeur du tag de type liste CSV import de l’utilisateur, et les utilisateurs sont mis en correspondance par ID utilisateur. Les utilisateurs sont ajoutés au segment ou retirés de celui-ci au fil des synchronisations de la cohorte par Amplitude.

Flux de données

• Événements et Tags : Les données sont envoyées d’Amplitude à Pushwoosh en fonction des interactions ou des attributs des utilisateurs suivis dans Amplitude. Les événements et les tags sont créés ou mis à jour dans Pushwoosh selon la configuration et les correspondances établies dans Amplitude.

• Segments : Les segments sont créés dans Pushwoosh lorsqu’Amplitude effectue une requête. Pushwoosh génère un identifiant unique pour chaque segment, qu’Amplitude utilise pour manipuler le segment en ajoutant ou en retirant des utilisateurs.

Requêtes

Les requêtes sont envoyées à des points de terminaison spécifiques dans Pushwoosh pour gérer les événements, les attributs utilisateur et les mises à jour de segments. Chaque requête nécessite une authentification et a des en-têtes et des formats de charge utile spécifiques.

Cas d’utilisation

Suivi des événements

Suivez les actions et les interactions des utilisateurs depuis Amplitude et envoyez ces événements à Pushwoosh pour déclencher des notifications ou des mises à jour.

Tagging des utilisateurs

Attribuez des tags aux utilisateurs en fonction de leur comportement ou de leurs attributs dans Amplitude. Ces tags peuvent être utilisés dans Pushwoosh pour des messages ciblés ou une segmentation.

Gestion des segments

Créez et gérez des segments d’utilisateurs dans Pushwoosh en fonction des données et des segments configurés dans Amplitude. Cela aide à cibler des groupes spécifiques d’utilisateurs avec des messages personnalisés.

Gestion automatisée des utilisateurs

Ajoutez ou retirez automatiquement des utilisateurs des segments en fonction de leurs actions ou de leurs attributs dans Amplitude, garantissant une segmentation à jour dans Pushwoosh.

Configuration de l’intégration

Synchronisation des cohortes

Configuration de Pushwoosh

1. Dans Pushwoosh, créez ou copiez un API Access Token dans Settings > API Access.
2. Copiez le code d’application de l’application vers laquelle vous souhaitez synchroniser les cohortes.

Configuration d’Amplitude

Pour configurer Amplitude pour l’intégration, suivez ces étapes :

1. Dans vos Données Amplitude, allez dans le Catalogue et sélectionnez Destinations.
2. Sous la section Cohorte, localisez et cliquez sur Pushwoosh.

3. Cliquez sur Ajouter une autre destination.

4. Fournissez un nom et collez l’API Access Token que vous avez copié depuis Pushwoosh.

5. Faites correspondre le champ ID utilisateur d’Amplitude avec le champ ID utilisateur de Pushwoosh. Pushwoosh met en correspondance les membres de la cohorte par ID utilisateur : le champ Amplitude que vous sélectionnez doit donc contenir la même valeur que celle que votre application définit comme ID utilisateur dans Pushwoosh. La page de configuration d’Amplitude indique que ce champ doit contenir une adresse e-mail. Si votre application définit une autre valeur comme ID utilisateur Pushwoosh, les membres de la cohorte ne sont pas mis en correspondance. Dans ce cas, définissez l’e-mail de l’utilisateur comme ID utilisateur dans le SDK Pushwoosh ou contactez le support Pushwoosh.
6. Enregistrez vos paramètres lorsque vous avez terminé.

Envoi d’une cohorte

Pour synchroniser votre première cohorte, suivez les étapes suivantes :

1. Dans Amplitude, ouvrez la cohorte que vous souhaitez synchroniser, puis cliquez sur Synchroniser.

2. Choisissez Pushwoosh et sélectionnez le compte avec lequel vous souhaitez synchroniser. Ensuite, cliquez sur Suivant.

3. Décidez de la cadence de synchronisation et enregistrez vos configurations.

Diffusion d’événements (Event streaming)

Configuration de Pushwoosh

1. Créez ou copiez un API Access Token dans Settings > API Access.

2. Copiez le code d’application de votre application.

Configuration d’Amplitude

1. Dans Amplitude, allez dans Destinations de données et trouvez Pushwoosh - Event Stream.

2. Entrez un nom de synchronisation, puis cliquez sur Créer une synchronisation.

3. Changez le statut de Désactivé à Activé et collez votre jeton d’accès API Pushwoosh et votre code d’application.

4. Dans la liste déroulante de gauche, sélectionnez la propriété utilisateur Amplitude qui correspond à votre UserID Pushwoosh.
5. (Facultatif) Activez le bouton Créer et mettre à jour les utilisateurs si vous souhaitez envoyer les utilisateurs et leurs propriétés en temps réel chaque fois qu’Amplitude crée ou met à jour une propriété utilisateur.

6. Activez Envoyer les événements (« Les événements sont envoyés à Pushwoosh ») si vous souhaitez diffuser des événements vers Pushwoosh. Cela transférera automatiquement les événements à Pushwoosh au fur et à mesure de leur ingestion dans Amplitude. Les événements ne sont pas envoyés selon un calendrier ou à la demande avec cette intégration.

8. Ensuite, choisissez les événements que vous souhaitez envoyer dans la section Sélectionner et filtrer les événements. Ne sélectionnez que les événements dont vous avez besoin dans Pushwoosh ; les événements transformés ne sont pas pris en charge.
9. Une fois terminé, activez la destination et cliquez sur Enregistrer.

Comment savoir si l’intégration fonctionne ?

Pour vérifier que l’intégration d’Amplitude et de Pushwoosh fonctionne correctement, vous pouvez utiliser les méthodes suivantes :

Surveiller le tableau de bord Pushwoosh

• Événements et Tags : Consultez le tableau de bord Pushwoosh pour voir si les événements et les tags envoyés depuis Amplitude apparaissent comme prévu. Recherchez les activités récentes ou les mises à jour liées à vos événements et tags.
• Segments : Vérifiez que les segments sont créés, mis à jour ou modifiés en fonction des données d’Amplitude. Assurez-vous que le nombre d’utilisateurs et les appartenances aux segments reflètent les changements attendus.

Vérifier les réponses de l’API

• Réponses réussies : Assurez-vous de recevoir des réponses 200 OK des points de terminaison de l’API Pushwoosh. Bien qu’il n’y ait pas toujours de corps de réponse, le statut 200 OK indique que la requête a été reçue avec succès.
• Réponses d’erreur : Examinez les codes de statut autres que 200 OK pour trouver des indices si quelque chose ne fonctionne pas :
  • 400 Bad Request : le corps de la requête n’est pas un JSON valide, ou l’ID utilisateur est manquant.
  • 401 Unauthorized : le jeton API ou le code d’application est manquant ou invalide, ou le jeton appartient à un autre compte.
  • 503 Service Unavailable : Pushwoosh ne peut temporairement pas traiter l’événement. La requête peut être renvoyée.
  • Autres codes 5xx : une erreur interne lors de la vérification du jeton API, de l’enregistrement des tags, de la création d’un segment ou de la mise à jour de l’appartenance à la cohorte. Renvoyez la requête plus tard.
• Les événements que Pushwoosh rejette en raison de leur contenu reçoivent 200 OK et ne sont pas traités : un 200 OK seul ne confirme donc pas qu’un événement a été enregistré.

Journaliser les requêtes et les réponses

• Journaux de requêtes : Maintenez des journaux des requêtes sortantes d’Amplitude et des réponses entrantes de Pushwoosh. Vérifiez ces journaux pour vous assurer que les requêtes sont correctement formatées et que les réponses sont conformes aux attentes.
• Journalisation des erreurs : Mettez en œuvre une journalisation des erreurs pour capturer tout problème lors des processus de transfert de données ou d’intégration.

Tester avec des données d’échantillon

• Envoyer des événements/tags de test : Créez et envoyez des événements et des tags de test d’Amplitude à Pushwoosh. Vérifiez que ces entrées de test apparaissent correctement dans Pushwoosh et déclenchent les comportements attendus.
• Simuler des actions utilisateur : Effectuez des actions dans Amplitude qui devraient déclencher des événements ou des mises à jour spécifiques dans Pushwoosh. Vérifiez si ces actions entraînent les changements attendus dans Pushwoosh.

Utiliser des outils de surveillance

• Surveillance de l’intégration : Utilisez des outils ou des services de surveillance qui peuvent suivre la santé et les performances de l’intégration. Ces outils peuvent vous alerter des problèmes ou des pannes en temps réel.
• Analyses et rapports : Utilisez les fonctionnalités d’analyse dans Amplitude et Pushwoosh pour examiner le flux de données et les performances de l’intégration.

Consulter la documentation de l’intégration

• Vérification de la configuration : Revérifiez la configuration de l’intégration dans Amplitude et Pushwoosh pour vous assurer que tous les paramètres et correspondances sont correctement appliqués.
• Mises à jour de la documentation : Restez informé de tout changement ou mise à jour dans la documentation de l’intégration qui pourrait affecter la fonctionnalité.

Contacter le support

Si vous rencontrez des problèmes persistants ou des incohérences, contactez les équipes de support d’Amplitude ou de Pushwoosh pour obtenir de l’aide. Fournissez-leur les détails de la configuration de l’intégration et tout journal d’erreurs pour une résolution plus rapide.

Dépannage

Problèmes d’intégration

• Événement n’apparaissant pas dans Pushwoosh : Assurez-vous que l’événement est correctement mappé et vérifiez que le code d’application et le jeton API de Pushwoosh sont correctement configurés.

• Tags ne se synchronisant pas : Confirmez que les tags sont formatés correctement et que tous les détails d’authentification nécessaires sont inclus dans la requête.

Problèmes de segment

• Segment non créé : Vérifiez que la requête de création du segment est correctement formatée et que le jeton API de Pushwoosh est valide.

• Utilisateurs non ajoutés/retirés : Vérifiez que les ID utilisateur sont correctement spécifiés et que l’ID de segment est valide. Assurez-vous que la charge utile de la requête est correctement formatée.

Problèmes de réponse

• Pas de corps de réponse : Une réponse 200 OK n’a pas de corps. Elle ne confirme pas qu’un événement a été enregistré, car les événements rejetés en raison de leur contenu reçoivent aussi 200 OK (voir Vérifier les réponses de l’API). Vérifiez l’événement dans Pushwoosh comme décrit dans Surveiller le tableau de bord Pushwoosh.

FAQ

Que dois-je faire si je reçois une erreur 400 Bad Request ?

Pushwoosh renvoie 400 lorsque le corps de la requête n’est pas un JSON valide ou que l’ID utilisateur (external_id) est manquant. Vérifiez que le mappage de l’ID utilisateur dans Amplitude pointe vers une propriété renseignée pour chaque utilisateur.

Comment puis-je vérifier si l’intégration fonctionne ?

Consultez le tableau de bord Pushwoosh pour les événements entrants, les tags et les mises à jour de segments. Vous pouvez également surveiller les journaux ou les réponses des points de terminaison de l’API pour des transferts de données réussis.

Puis-je personnaliser les événements ou les tags envoyés à Pushwoosh ?

Oui, vous pouvez personnaliser les événements et les tags dans la configuration d’Amplitude. Assurez-vous que les données respectent le format attendu par Pushwoosh.

À quelle fréquence les données sont-elles synchronisées entre Amplitude et Pushwoosh ?

La synchronisation des données se fait en temps réel ou quasi réel en fonction des requêtes effectuées depuis Amplitude. Assurez-vous que votre configuration prend en charge la fréquence de mise à jour souhaitée.

Où puis-je trouver plus d’informations ou de l’aide pour cette intégration ?

Consultez la documentation officielle d’Amplitude et de Pushwoosh. Pour une assistance supplémentaire, contactez les équipes de support respectives.