Intégration de Segment

Segment est une plateforme de données client qui simplifie la collecte des données utilisateur et vous aide à les exploiter efficacement. Si vous stockez vos données client dans Segment, vous pouvez configurer une intégration avec Pushwoosh en quelques clics seulement.

Une fois l’intégration configurée, Segment enverra les données suivantes à Pushwoosh :

• Attributs utilisateur : nom, appareil, préférences, localisation, comportement, etc. Pushwoosh enregistrera ces données sous forme de Tags et de leurs valeurs pour chaque utilisateur.
• Événements : chaque événement Segment sera transféré à Pushwoosh et enregistré comme un événement Pushwoosh portant le même nom. Pushwoosh obtiendra également des informations sur les événements que chaque utilisateur a déclenchés.

En utilisant les données de Segment, vous pouvez suivre votre audience avec des communications fluides dans Pushwoosh. Voici deux exemples illustrant comment tirer parti de la puissance des deux plateformes :

1. Créez des campagnes ciblées basées sur les données de comportement des utilisateurs. Utilisez les données des événements de Segment pour créer des segments d’utilisateurs précis dans Pushwoosh en fonction du comportement spécifique des utilisateurs.

Par exemple, Segment envoie à Pushwoosh des données sur l’événement SubscribedToOffers. Vous pouvez créer un segment d’utilisateurs dans Pushwoosh composé d’utilisateurs qui se sont abonnés à des offres spéciales :

Ensuite, vous pouvez créer des parcours client engageants avec des messages promotionnels et des réductions pour les utilisateurs qui se sont abonnés à vos offres :

2. Personnalisez les messages en fonction des attributs des utilisateurs provenant de Segment. Vous pouvez exploiter les attributs des utilisateurs obtenus de Segment pour modifier le contenu de vos notifications push, de vos messages in-app et de vos e-mails. Cela vous permettra de mettre en place des communications pertinentes et à fort taux de conversion.

Par exemple, Segment envoie les valeurs de l’attribut searched_product à Pushwoosh. Vous pouvez créer un préréglage de push offrant une réduction sur les produits d’une catégorie qu’un utilisateur a précédemment consultée :

Chaque utilisateur recevra un push offrant une réduction sur la catégorie de produits exacte qu’il a consultée précédemment. Par exemple, ceux qui ont recherché des chaussures de sport verront ce message :

• Destination : Les données sont envoyées de Segment à Pushwoosh.
• Source : Les données sont envoyées de Pushwoosh à Segment.

Comptes payants à la fois pour Pushwoosh et Segment

Source

• Statistiques Push

Destination

• Appareils
• Tags

Suivi des notifications

Envoyez des notifications push et suivez leur état, y compris si elles ont été envoyées et livrées avec succès.

Analyse d’événements

Analysez les événements déclenchés par les utilisateurs, tels que les notifications push ou les livraisons d’e-mails, et assurez-vous que ces événements sont correctement enregistrés dans Segment.

Gestion des utilisateurs

Enregistrez et gérez les informations des utilisateurs, y compris l’ajout de tags aux utilisateurs avec des attributs pertinents ou la suppression d’utilisateurs si nécessaire.

1. Dans l’interface de Segment, naviguez vers Connections → Destinations et cliquez sur Add Destination.

2. Recherchez Pushwoosh et sélectionnez-le.

3. Choisissez les Sources que vous souhaitez connecter à la Destination.

4. Allez dans les paramètres de la Destination :

5. Saisissez la clé API Pushwoosh et le code d’application. Assurez-vous que le commutateur Enable Destination est activé. Ensuite, cliquez sur Save Changes.

Où puis-je trouver la clé API et le code d’application ?

Vous pouvez trouver la clé API dans la section Settings → API Access :

Le code d’application se trouve dans le coin supérieur gauche de l’interface de Pushwoosh, juste en dessous du nom du projet :

6. Allez dans l’onglet Mappings et assurez-vous que les options Create or Update User Profile et Track Events sont activées :

Il est important de vérifier le mappage des champs d’événements de votre source vers Pushwoosh en tant que destination pour garantir que vos événements sont traités correctement.

Si un événement ne contient pas le champ device_platform ou si ce champ est incorrect, votre événement sera ignoré. De plus, si un événement ne contient ni userId ni deviceId, il sera également ignoré.

Pour vous assurer que votre mappage est correctement configuré, allez dans Pushwoosh as Destination > Settings.

Ensuite, sélectionnez l’onglet Mapping et cliquez sur Edit Mapping pour la méthode Track Events.

Assurez-vous ensuite que le mappage de vos événements vers les événements envoyés à Pushwoosh est correct, et que les champs Device Platform et External User ID (ou Device ID) sont correctement associés.

Votre événement peut différer de l’exemple fourni ci-dessus. Cependant, l’essentiel est de faire correspondre le transfert de données pour la plateforme et l’appareil pour l’événement envoyé à Pushwoosh.

Si l’intégration est correctement configurée, Pushwoosh commencera à recevoir des événements et des attributs utilisateur de Segment. Sur la base de ces données, vous pouvez créer des parcours client hautement ciblés et personnaliser vos notifications push, messages in-app et e-mails.

1. Depuis la page du catalogue des Sources de votre espace de travail, cliquez sur Add Source.
2. Recherchez « Pushwoosh » dans le catalogue des Sources, sélectionnez Pushwoosh, puis cliquez sur Add Source.
3. Sur l’écran suivant, donnez un nom à la Source et configurez tout autre paramètre.

4. Cliquez sur Add Source pour enregistrer vos paramètres.
5. Copiez la clé d’écriture depuis l’interface utilisateur de Segment.
6. Connectez-vous à votre compte Pushwoosh, et sélectionnez l’Application que vous souhaitez connecter.
7. Naviguez vers Settings > 3rd party integration > Segment, cliquez sur le bouton Configure, et saisissez votre clé d’écriture de votre espace de travail Segment.
8. Listez les événements que vous souhaitez exporter en utilisant une virgule (,) comme délimiteur dans le champ Events, ou laissez-le vide si vous souhaitez exporter tous les événements, puis cliquez sur Apply.

Pushwoosh utilise le composant Source de flux de Segment pour envoyer les données d’événement à Segment. Il utilise une méthode track côté serveur pour envoyer des données à Segment. Ces événements sont ensuite disponibles dans toute destination qui accepte les événements côté serveur, et sont disponibles dans un schéma de votre entrepôt de données.

Par défaut, Pushwoosh transmet l’ID utilisateur de Pushwoosh comme propriété userId de Segment. S’il n’y a pas d’ID utilisateur associé, Pushwoosh transmettra le HWID comme anonymousId de Segment.

Le tableau ci-dessous liste les événements que Pushwoosh envoie à Segment. Ces événements apparaissent comme des tables dans votre entrepôt de données, et comme des événements réguliers dans d’autres Destinations.

Le tableau ci-dessous liste les propriétés incluses dans les événements listés ci-dessus.

Maintenant que votre Source est configurée, vous pouvez la connecter à des Destinations.

Connectez-vous à vos outils en aval et vérifiez que vos événements apparaissent comme prévu et qu’ils contiennent toutes les propriétés attendues. Si vos événements et propriétés n’apparaissent pas, vérifiez la livraison des événements et consultez la documentation de la Destination pour chaque outil pour le dépannage.

S’il y a des problèmes avec la façon dont les événements arrivent à Segment, contactez notre équipe de support.

1. Initiation de la notification push : Un client lance le processus en initiant une notification push via l’interface Pushwoosh.
2. Production d’événement : Le backend de Pushwoosh traite la demande de notification push et génère un événement. Cet événement est ensuite envoyé à un topic Kafka nommé channels-tracking-log géré par Pushwoosh.
3. Consommation d’événement : Le service d’intégration de Segment écoute en continu le topic Kafka channels-tracking-log et consomme les événements à leur arrivée.
4. Traitement d’événement : Les événements consommés sont traités par le service d’intégration de Segment, qui les transforme en événements Track de Segment.
5. Transmission d’événement : Les événements Track de Segment traités sont ensuite envoyés au backend de Segment pour un traitement et une analyse plus approfondis.

Allez dans votre compte Pushwoosh > Votre Application connectée > Audience > User Explorer. Trouvez votre utilisateur/appareil et vérifiez les tags que Segment a envoyés.

Allez dans votre compte Pushwoosh > Votre Application connectée > Audience > Events. Sélectionnez l’événement, cliquez sur le menu à trois points, et choisissez Event Statistics. Assurez-vous que l’événement est comptabilisé.

Allez dans votre compte PW > Votre Application connectée > Audience > User Explorer. Assurez-vous que l’utilisateur/l’appareil n’existe pas.

Utilisez le débogueur de Source pour détecter les événements qui ont été envoyés de Pushwoosh à Segment.

Pour dépanner les problèmes avec l’intégration Pushwoosh, commencez par vérifier les points suivants :

Destination

• Track-User : Vérifiez les informations de l’utilisateur/appareil et les tags dans Pushwoosh sous Audience > User Explorer.
• Post-Event : Assurez-vous que l’événement est comptabilisé dans Pushwoosh en vérifiant les statistiques de l’événement.
• Delete-User : Confirmez que l’utilisateur/l’appareil n’existe plus dans Pushwoosh.

Source

Utilisez le débogueur de source sur Segment Debugger pour vérifier si les événements de Pushwoosh sont correctement envoyés à Segment.

Si les événements n’apparaissent pas correctement dans Segment, assurez-vous que les événements Pushwoosh sont correctement mappés aux événements Track de Segment conformément aux règles de mappage fournies.

Vérifiez que les jetons d’authentification ou les clés API corrects sont utilisés dans les requêtes vers Pushwoosh et Segment.

Confirmez que le flux de données entre Pushwoosh et Segment est ininterrompu et que les topics Kafka sont correctement surveillés.

Les événements réservés tels que Push Sent, Email Sent, SMS Sent, Push Delivered, Email Delivered, SMS Delivered, et Email Bounced sont envoyés à Segment.

Utilisez le débogueur de source de Segment pour vérifier les événements envoyés depuis Pushwoosh, et examinez les statistiques des événements dans votre compte Pushwoosh pour vous assurer qu’ils sont correctement comptabilisés.

Vérifiez l’état de l’intégration en vérifiant les informations de l’utilisateur/appareil, le décompte des événements, et les suppressions d’utilisateurs dans Pushwoosh. De plus, assurez-vous que les jetons d’authentification corrects sont utilisés et que le flux de données est ininterrompu.

Les informations sur l’utilisateur et l’appareil, y compris les attributs et les tags, sont enregistrées ou mises à jour dans Pushwoosh en fonction des requêtes de Segment. Notez que les Tags par défaut ne sont pas créés automatiquement dans Pushwoosh.

Une documentation détaillée est disponible dans les manuels d’intégration de Segment et Pushwoosh, ainsi que dans leurs documentations API respectives.