Intégration de Piano Analytics

Aide d'un développeur requise

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

Piano Analytics est un outil qui aide les entreprises à comprendre comment les gens interagissent avec leurs sites web et leurs applications. Il collecte des données sur le comportement des utilisateurs et fournit des informations par le biais de rapports et de visualisations. Ces informations aident les entreprises à prendre de meilleures décisions sur la manière d’améliorer leurs produits numériques et leurs efforts marketing.

L’intégration de Piano Analytics et de Pushwoosh permet d’obtenir des informations détaillées sur le comportement des utilisateurs afin de créer des segments précis et d’envoyer des notifications push, des e-mails et des messages in-app très ciblés aux bons utilisateurs au bon moment.

Aperçu de l’intégration

Type d’intégration

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

Prérequis

Comptes payants à la fois dans Pushwoosh et Piano Analytics

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

Lors de l’intégration de Pushwoosh et de Piano Analytics, certains noms d’entités peuvent varier entre les deux plateformes. Voici les correspondances entre Pushwoosh et Piano Analytics :

Pushwoosh	Piano Analytics
UserID/hwid	visitorID
PostEvent.EventName	PianoEvent.Name
PostEvent.UserID	PianoEvent.PushwooshID
PostEvent.CampaignID	PianoEvent.SrcMedium
PostEvent.PlatformID	PianoEvent.DeviceType

Entités synchronisées

Source

• Événements
• Statistiques Push
• Tags (en tant qu’attributs d’événement)

Destination

• Segments

Cas d’utilisation

Analyses unifiées

Combinez les données d’engagement de Pushwoosh avec Piano Analytics pour obtenir des informations complètes sur les utilisateurs. Cela vous permet d’avoir une vue d’ensemble du comportement et des interactions des utilisateurs sur plusieurs points de contact.

Segmentation

Créez des segments d’utilisateurs ciblés dans Pushwoosh en fonction des données de Piano Analytics. Utilisez cette segmentation améliorée pour diffuser des campagnes marketing personnalisées et efficaces.

Suivi des performances

Suivez l’efficacité des campagnes et l’interaction des utilisateurs sur les différentes plateformes.

Comment fonctionne l’intégration ?

Aperçu du flux

1. Configuration : Configurez les paramètres d’intégration dans les comptes Pushwoosh et Piano Analytics.
2. Mappage des événements : Mappez les événements Pushwoosh aux événements Piano (par exemple, PostEvent.EventName à PianoEvent.Name).
3. Transfert de données : Pushwoosh envoie des événements (Post Events et Tracking Log Events) à Piano Analytics.
4. Importation de segments : Piano Analytics envoie des données de segment à Pushwoosh pour la segmentation de l’audience.

Flux technique

1. Post Events
   • Pushwoosh envoie les données d’événement à Piano Analytics.
   • Les attributs sont mappés comme suit :
     • UserID (Pushwoosh) > PushwooshID (Piano)
     • CampaignID (Pushwoosh) > SrcMedium (Piano)
     • PlatformID (Pushwoosh) > DeviceType (Piano)
2. Tracking Log Events :
   • Pushwoosh envoie des données de suivi (par exemple, Push Sent, Push Delivered) à Piano Analytics.
   • Ces données enrichissent Piano Analytics avec des métriques de livraison et d’engagement.
3. Intégration du VisitorID de Piano :
   • Intégrez éventuellement le VisitorID de Piano avec Pushwoosh pour des analyses unifiées sur les SDK.

Configuration de l’intégration

Pour configurer l’intégration, allez dans Paramètres > Intégrations tierces dans votre compte Pushwoosh et localisez Piano. Cliquez sur Configurer.

Dans la fenêtre qui s’ouvre, fournissez les informations d’identification suivantes :

1. ID du site

Pour trouver votre ID de site, connectez-vous à votre compte Piano et allez dans Analyses > Portail de collecte de données > Tableau de bord. Trouvez le site web pertinent et copiez son ID.

2. Domaine de collecte

Pour trouver le domaine de collecte, naviguez vers Tagging > Domaines de collecte. Copiez l’ID du domaine de collecte. Assurez-vous de saisir le domaine de collecte au format ****.pa-cd.com sans le préfixe https://.

3. Clés d’accès et secrètes de l’API Piano

Pour obtenir les clés :

• Dans votre compte Piano, cliquez sur Voir le profil sous le nom de votre compte.

• Naviguez vers l’onglet Clés API et créez une nouvelle clé avec un nom et une description clairs. Cliquez ensuite sur OK.

• Dans la fenêtre qui s’ouvre, copiez votre Clé d’accès et la Clé secrète.

Attention

Pour des raisons de sécurité, la Clé secrète ne sera affichée qu’une seule fois. Assurez-vous de sauvegarder les deux clés dans un endroit sûr avant de continuer.

• Dans le champ Clé API de Pushwoosh, entrez à la fois la Clé d’accès et la Clé secrète, séparées par un trait de soulignement. Par exemple : accesskey_secretkey.

Création d’événements Piano pour correspondre aux événements Pushwoosh

Pour suivre les événements envoyés depuis Pushwoosh dans Piano, vous devez créer manuellement les événements correspondants dans Piano.

Voici comment procéder dans votre compte Piano :

1. Allez dans Paramètres > Gestion des données > Modèle de données.
2. Sélectionnez Événements et cliquez sur l’icône plus pour créer un nouvel événement.
3. Dans la fenêtre qui s’ouvre, fournissez le nom et la description de l’événement, par exemple, “pw_siteopened”.

Note

La dénomination des événements n’est pas sensible à la casse. Si vous créez un nom en majuscules pour un événement dans Pushwoosh, par exemple, PW_SiteOpened, il correspondra à l’événement pw_siteopened dans Piano.

4. Dans le champ Type, sélectionnez Sur site.
5. Dans le champ Catégories, sélectionnez Événements.
6. Cliquez sur Enregistrer.

Définition du fuseau horaire de votre site web dans Piano

Définir le bon fuseau horaire pour votre site web dans Piano est crucial pour un suivi et une analyse précis des données. La meilleure pratique consiste à faire correspondre le fuseau horaire avec l’endroit où vous envoyez les événements et effectuez l’analyse. Cela élimine les décalages horaires.

Pour modifier le fuseau horaire dans Piano, allez dans Tableau de bord et cliquez sur la ligne contenant les informations de votre site. Dans la fenêtre contextuelle, cliquez sur Modifier et sélectionnez le fuseau horaire souhaité. Cliquez ensuite sur Enregistrer.

Création d’une propriété pour identifier les événements envoyés depuis Pushwoosh dans Piano

Pour faciliter la gestion des données, créez une propriété dans Piano qui peut être associée aux événements Pushwoosh. Cela vous permettra d’identifier facilement les événements envoyés depuis Pushwoosh.

Voici comment créer la propriété :

1. Dans Piano, allez dans Paramètres > Gestion des données > Propriétés.
2. Cliquez sur Créer une propriété.
3. Dans le champ Nom, entrez pushwooshid.
4. Dans le champ Clé de propriété, entrez pushwooshid.
5. Définissez le Type sur Chaîne.
6. Cliquez sur Enregistrer.

Vérification de l’envoi des événements Pushwoosh à Piano

Pour vérifier que les événements configurés dans Pushwoosh sont envoyés avec succès à Piano, suivez ces étapes :

1. Dans votre compte Piano, allez dans Explorateur > Audience > Trafic global.
2. Créez un segment basé sur les événements où la propriété pushwooshid n’est pas vide.

La vue filtrée affichera les informations sur le trafic global, y compris tous les événements associés.

Pour une vue plus détaillée des événements envoyés depuis Pushwoosh, naviguez vers Contenu > Événements. Cette section fournit une ventilation détaillée de tous les événements envoyés depuis Pushwoosh, y compris le nombre de fois que chaque événement s’est produit.

Création de segments dans Piano

Une fois la configuration de l’intégration terminée, vous pouvez commencer à analyser les événements envoyés depuis Pushwoosh dans Piano. Pour accéder à ces événements, naviguez vers Explorateur > Contenu > Événements dans votre compte Piano.

Ensuite, créez des segments en utilisant ces événements. Lors de la création de segments, sélectionnez la propriété pushwooshid que vous avez créée précédemment pour filtrer les événements.

Assurez-vous de donner à votre segment un nom clair et descriptif. La Clé de segment, qui est un identifiant unique pour le segment enregistré, sera nécessaire plus tard pour envoyer des segments à Pushwoosh.

Envoi de segments de Piano à Pushwoosh

Note

Veuillez noter que seuls les propriétaires de compte peuvent importer des segments.

Pour permettre à Pushwoosh de récupérer des segments de Piano, fournissez à Pushwoosh la SegmentKey que vous avez créée. Pour trouver la SegmentKey d’un segment, allez dans Analyse > Bibliothèque > Segments. Cliquez sur le segment dont vous avez besoin et copiez la Clé de segment.

Dans la section Intégrations de Pushwoosh, localisez Piano et cliquez sur Importer un segment. Ensuite, entrez la clé de segment que vous avez copiée.

Si l’importation réussit, vous verrez un message de confirmation.

Vous pouvez accéder à vos segments importés dans Pushwoosh. Une fois l’importation terminée, ils seront répertoriés dans la section Audience > Segments de votre compte Pushwoosh.

Mappage du VisitorID de Piano au UserID/HWID de Pushwoosh pour des analyses cumulées sur les SDK

Si un client souhaite cumuler les analyses du SDK Pushwoosh et du SDK Piano Analytics, Pushwoosh doit mapper le VisitorID de Piano au UserID/HWID de Pushwoosh. La solution consiste à envoyer un tag de VisitorID de Piano à Pushwoosh pour l’utilisateur/appareil.

Pour ce faire, procédez comme suit :

1. Créez un tag nommé ‘Piano Visitor ID’ du côté de Pushwoosh pour l’application. Note : Le nom du tag doit être exactement comme décrit.
2. Du côté de l’application du client, obtenez l’ID visiteur de Piano dans le SDK Piano en utilisant la méthode getVisitorId.
3. Du côté de l’application du client, utilisez le SDK Pushwoosh pour appeler la requête setTags avec la valeur du tag une fois.

Si la valeur du tag (Piano Visitor ID) existe pour l’utilisateur/appareil, Pushwoosh l’inclura automatiquement comme ID client dans les requêtes à Piano Analytics. Du côté de Piano Analytics, elle sera transformée en une valeur d’ID visiteur unique.

Exemples de code

SDK Web Push (JavaScript)

Pushwoosh.push(function(api) {
// Set tags for a user
api.setTags({
'Piano Visitor ID': pa.getVisitorID(),
});

Android (Java)

String value1 = PianoAnalytics.getInstance().visitorId();
TagsBundle pianoTag = new TagsBundle.Builder()
    .putString("Piano Visitor ID", value1)
    .build();
Pushwoosh.getInstance().setTags(pianoTag);

iOS (Swift)

var pianoId: String = pa.getVisitorId(completionHandler: { visitorId in
Pushwoosh.sharedInstance().setTags([
 "Piano Visitor ID": visitorId
 ])
})

iOS (Objective-C)

__block NSString *pianoId;
[pa getVisitorIdWithCompletionHandler:^(NSString *visitorId) {
    Piano Visitor ID = visitorId;
    [[Pushwoosh sharedInstance] setTags:@{@"Piano Visitor ID": visitorId}];
}];

En général, Pushwoosh utilise des tags d’appareil pour fournir des informations sur l’appareil et d’autres informations à Piano Analytics dans chaque requête. Voici une liste des tags courants utilisés :

• Pays
• Modèle d’appareil
• Version de l’OS
• Type de navigateur (dans certains cas)

Comment vérifier que l’intégration fonctionne

Source : Détection des événements envoyés à Piano Analytics

Il existe deux moyens simples de détecter les événements qui ont été envoyés à Piano Analytics :

Inspecteur de flux

1. Allez sur votre compte Piano Analytics.
2. Naviguez vers Paramètres > Portail de collecte de données > Outils > Inspecteur de flux.
3. Choisissez le site connecté que vous souhaitez vérifier.
4. Sélectionnez les événements que vous souhaitez inspecter et démarrez une session.
5. Vérifiez que les événements ont été reçus par Piano Analytics.

Vérifier les événements dans le trafic global

1. Allez sur votre compte Piano Analytics.
2. Naviguez vers Paramètres > Explorateur > Audience > Trafic global.
3. Choisissez le site et la plage de dates dans le menu ci-dessous.

Destination : Importation du segment de Piano

Pour vérifier l’intégration du côté de la destination :

• Importez le segment de Piano.
• Vous devriez voir un nouveau segment (filtre) avec un nom construit comme cle_segment (Piano Autogenerated).
• Recalculez le segment pour obtenir des informations à jour sur le traitement des appareils actuels.

Dépannage FAQ : Problèmes courants

Comment puis-je m’assurer que les événements sont correctement envoyés de Pushwoosh à Piano Analytics ?

Solution : Utilisez l’Inspecteur de flux de Piano ou vérifiez le trafic global dans Piano Analytics pour surveiller les événements entrants de Pushwoosh.

Que dois-je faire si les données de segment ne sont pas importées correctement dans Pushwoosh ?

Solution : Assurez-vous que la clé de segment de Piano correspond à la configuration dans Pushwoosh. Vérifiez s’il y a des erreurs dans les calculs de taille de segment ou dans la récupération des données.

Puis-je intégrer le VisitorID de Piano avec Pushwoosh pour des analyses améliorées ?

Solution : Oui, en configurant un tag spécifique dans Pushwoosh et en utilisant le SDK de Piano pour récupérer le VisitorID, vous pouvez synchroniser les ID utilisateur sur les plateformes.

Que dois-je faire en cas de problèmes avec les configurations de clés API ?

Solution : Examinez les journaux de requêtes API, assurez-vous que les URL des points de terminaison et les jetons d’authentification (clés API) sont corrects, et vérifiez s’il y a des erreurs côté serveur signalées par l’un ou l’autre service.