Intégration Amplitude
Amplitude, une plateforme d’analyse produit 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 vos 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, au final, de générer un engagement accru, de réduire le taux de désabonnement et d’augmenter les revenus.
Aperçu de l’intégration
Anchor link toType d’intégration
Anchor link toDestination : Les données sont envoyées d’Amplitude vers Pushwoosh.
Prérequis
Anchor link toPour configurer l’intégration du Streaming d’Événements et de la Synchronisation de Cohortes 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 disposant d’un plan payant.
- Vous devez avoir un plan Pushwoosh payant pour utiliser cette intégration.
Glossaire (correspondance des noms d’entités s’ils sont différents)
Anchor link toCohortes dans Amplitude = Segments dans Pushwoosh
Entités synchronisées
Anchor link to- Événements
- Tags
- Segments
Comment fonctionne l’intégration ?
Anchor link toL’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
Anchor link toÉ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
), un horodatage (created_at
) et des attributs supplémentaires (attributes
).Tags : Pushwoosh reçoit des tags 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
Anchor link toÉvénements et Tags : Les données sont envoyées d’Amplitude à Pushwoosh en fonction des interactions des utilisateurs ou des attributs suivis dans Amplitude. Les événements et les tags sont créés ou mis à jour dans Pushwoosh selon la configuration et les correspondances définies 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
Anchor link toLes 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 possède des en-têtes et des formats de charge utile spécifiques.
Cas d’utilisation
Anchor link toSuivi d’événements
Anchor link toSuivez 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 d’utilisateurs
Anchor link toAssignez 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 pour la segmentation.
Gestion des segments
Anchor link toCré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
Anchor link toAjoutez ou supprimez automatiquement des utilisateurs des segments en fonction de leurs actions ou de leurs attributs dans Amplitude, garantissant ainsi une segmentation à jour dans Pushwoosh.
Configuration de l’intégration
Anchor link toSynchronisation de cohortes
Anchor link toConfiguration de Pushwoosh
Anchor link toDans Pushwoosh, naviguez vers Paramètres > Intégrations.
Cliquez sur Ajouter une intégration, puis trouvez et ajoutez Amplitude.
Copiez la Clé API et le Code d’Application de Pushwoosh dans votre presse-papiers.
Configuration d’Amplitude
Anchor link toPour configurer Amplitude pour l’intégration, suivez ces étapes :
- Dans vos Données Amplitude, allez dans le Catalogue et sélectionnez Destinations.
- Sous la section Cohorte, localisez et cliquez sur Pushwoosh.

- Cliquez sur Ajouter une autre destination.

- Fournissez un nom et collez la clé API que vous avez copiée depuis Pushwoosh.

- Faites correspondre le champ ID Utilisateur d’Amplitude avec le champ ID Utilisateur de Pushwoosh.
- Enregistrez vos paramètres lorsque vous avez terminé.
Envoi d’une cohorte
Anchor link toPour synchroniser votre première cohorte, suivez les étapes suivantes :
- Dans Amplitude, ouvrez la cohorte que vous souhaitez synchroniser, puis cliquez sur Synchroniser.

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

- Décidez de la fréquence de synchronisation et enregistrez vos configurations.

Streaming d’événements
Anchor link toConfiguration de Pushwoosh
Anchor link toObtenez votre Clé API Pushwoosh.
Localisez le Code d’Application dans votre compte Pushwoosh.
Configuration d’Amplitude
Anchor link to- Dans Amplitude, allez dans Data Destinations et trouvez Pushwoosh - Event Stream.

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

- Changez le statut de Désactivé à Activé et collez votre Jeton d’accès à l’API Pushwoosh et votre Code d’Application.

- Dans la liste déroulante de gauche, sélectionnez la propriété utilisateur Amplitude qui correspond à votre UserID Pushwoosh.
- (Facultatif) Activez le commutateur Créer & 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.

- Activez Envoyer les événements (“Les événements sont envoyés à Pushwoosh”) si vous voulez streamer 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.

- Ensuite, choisissez les événements que vous souhaitez envoyer dans la section Sélectionner et filtrer les événements. Sélectionnez uniquement les événements dont vous avez besoin dans Pushwoosh ; les événements transformés не sont pas pris en charge.
- Une fois terminé, activez la destination et cliquez sur Enregistrer.
Comment savoir si l’intégration fonctionne ?
Anchor link toPour vérifier que l’intégration Amplitude et Pushwoosh fonctionne correctement, vous pouvez utiliser les méthodes suivantes :
Surveiller le tableau de bord Pushwoosh
Anchor link to- É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 les décomptes d’utilisateurs et les appartenances aux segments reflètent les changements attendus.
Vérifier les réponses de l’API
Anchor link to- 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 statut200 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 inclure400 Bad Request
,401 Unauthorized
, ou500 Internal Server Error
.
Journaliser les requêtes et les réponses
Anchor link to- 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’exemple
Anchor link to- Envoyer des Événements/Tags de test : Créez et envoyez des événements et des tags de test depuis Amplitude vers 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
Anchor link to- Surveillance de l’intégration : Utilisez des outils ou des services de surveillance qui peuvent suivre l’état 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
Anchor link to- 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 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
Anchor link toSi 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 tous les journaux d’erreurs pour une résolution plus rapide.
Dépannage
Anchor link toProblèmes d’intégration
Anchor link toL’é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 Pushwoosh et le jeton d’API sont correctement configurés.
Les tags ne se synchronisent pas : Confirmez que les tags sont correctement formatés et que toutes les informations d’authentification nécessaires sont incluses dans la requête.
Problèmes de segment
Anchor link toLe segment n’est pas créé : Vérifiez que la requête de création du segment est correctement formatée et que le jeton d’API 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
Anchor link to- 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.
Que dois-je faire si je reçois une erreur 400 Bad Request
?
Anchor link toVérifiez 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 ?
Anchor link toConsultez 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 ?
Anchor link toOui, 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 ?
Anchor link toLes 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 l’aide pour cette intégration ?
Anchor link toRéférez-vous à la documentation officielle d’Amplitude et de Pushwoosh. Pour une assistance supplémentaire, contactez les équipes de support respectives.