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 robuste d’analyse de produits, 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 du flux d’événements (Event Streaming) et de la synchronisation des cohortes (Cohort Sync) d’Amplitude vers Pushwoosh, assurez-vous que les prérequis suivants sont remplis :

• Vous devez avoir un compte Pushwoosh actif.
• Générez un Jeton d’accès à l’API 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 les données d’événements à Pushwoosh. Chaque événement contient un ID utilisateur (external_id), un code d’application (app_id), un horodatage (created_at) et des attributs supplémentaires (attributes).

• Tags : Pushwoosh reçoit des tags qui sont associés aux profils des utilisateurs. Ces tags sont envoyés avec un ID utilisateur (external_id), un code d’application (app_id) et des propriétés de tag (properties).

• Segments : Les segments sont importés de la même manière que Pushwoosh gère les importations CSV. Les utilisateurs sont ajoutés ou retirés des segments via des requêtes.

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 mappages définis 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 des utilisateurs 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, naviguez vers Paramètres > Intégrations.

2. Cliquez sur Ajouter une intégration, puis trouvez et ajoutez Amplitude.

   

3. Copiez la Clé API et le Code d’application de Pushwoosh dans votre presse-papiers.

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 la clé API que vous avez copiée depuis Pushwoosh.

5. Mappez le champ ID utilisateur d’Amplitude avec le champ ID utilisateur de 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.

Flux d’événements

Configuration de Pushwoosh

1. Obtenez votre clé API Pushwoosh

2. Localisez le code d’application dans votre compte Pushwoosh.

Configuration d’Amplitude

1. Dans Amplitude, allez dans Destinations de données et trouvez Pushwoosh - Flux d’événements.

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 à l’API Pushwoosh et votre code d’application.

4. Dans le menu déroulant 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 transmettra 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 Amplitude et Pushwoosh fonctionne correctement, vous pouvez utiliser les méthodes suivantes :

Surveiller le tableau de bord Pushwoosh

• Événements et Tags : Vérifiez 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 l’appartenance 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 toute réponse d’erreur ou tout code de statut autre que 200 OK pour trouver des indices si quelque chose ne fonctionne pas. Les erreurs courantes peuvent inclure 400 Bad Request, 401 Unauthorized ou 500 Internal Server Error.

Journaliser les requêtes et les réponses

• Journaux de requêtes : Conservez 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 place une journalisation des erreurs pour capturer tout problème lors du transfert de données ou des processus 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 d’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 en temps réel en cas de problèmes ou de pannes.
• 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

• Examen de la configuration : Vérifiez à nouveau la configuration de l’intégration dans Amplitude et Pushwoosh pour vous assurer que tous les paramètres et mappages sont correctement appliqués.
• Mises à jour de la documentation : Restez à jour avec toute modification ou mise à jour de 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

• L’événement n’apparaît 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.

• Les tags ne se synchronisent 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

• Le segment n’est pas 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.

• Les utilisateurs ne sont pas 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 : Si vous recevez une réponse 200 OK mais pas de corps de réponse, vérifiez que la requête était correctement formatée et que les données ont été envoyées correctement.

FAQ

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

Examinez la charge utile de la requête pour des erreurs de formatage ou des champs manquants. Assurez-vous que tous les champs requis sont inclus et correctement formatés.

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

Vérifiez le tableau de bord Pushwoosh pour les événements, les tags et les mises à jour de segments entrants. 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 ?

Les données se synchronisent 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 support pour cette intégration ?

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