Intégration de Piano Analytics

Assistance 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 vous basant sur les 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 toutes les 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 d’événements : mappez les événements Pushwoosh aux événements Piano (par ex., 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. Événements du journal de suivi :
   • Pushwoosh envoie des données de suivi (par ex., Push envoyé, Push livré) à Piano Analytics.
   • Ces données enrichissent Piano Analytics avec des métriques de livraison et d’engagement.
3. Intégration de l’ID visiteur de Piano :
   • En option, intégrez l’ID visiteur de Piano avec Pushwoosh pour des analyses unifiées sur tous 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 Analytics > Data Collection Portal > Dashboard. Trouvez le site web pertinent et copiez son ID.

2. Domaine de collecte

Pour trouver le domaine de collecte, naviguez vers Tagging > Collection Domains. 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. Veuillez vous assurer de sauvegarder les deux clés dans un endroit sûr avant de continuer.

• Dans le champ Clé API de Pushwoosh, saisissez à 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, indiquez le nom et la description de l’événement, par exemple, “pw_siteopened”.

Note

Le nom 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éfinir le 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 des événements et effectuez des analyses. Cela élimine les décalages horaires.

Pour modifier le fuseau horaire dans Piano, allez dans le 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éer une propriété pour identifier les événements envoyés de 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, saisissez pushwooshid.
4. Dans le champ Clé de propriété, saisissez pushwooshid.
5. Définissez le Type sur Chaîne de caractères.
6. Cliquez sur Enregistrer.

Vérifier si les événements Pushwoosh sont envoyés à 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 Explorer > 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 d’occurrences de chaque événement.

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 Explorer > 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 Clé de segment que vous avez créée. Pour trouver la Clé de segment 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, saisissez 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.

Mapper l’ID visiteur de Piano à l’UserID/HWID de Pushwoosh pour des analyses cumulées sur tous les SDK

Si un client souhaite accumuler des analyses à la fois du SDK Pushwoosh et du SDK Piano Analytics, Pushwoosh doit mapper l’ID visiteur de Piano à l’UserID/HWID de Pushwoosh. La solution consiste à envoyer un tag d’ID visiteur 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 tel que décrit.
2. Côté application client, obtenez l’ID visiteur de Piano dans le SDK Piano en utilisant la méthode getVisitorId.
3. Côté application client, utilisez le SDK Pushwoosh pour appeler la requête setTags avec la valeur du tag une fois.

Si la valeur du tag (ID visiteur de Piano) existe pour l’utilisateur/appareil, Pushwoosh l’inclura automatiquement en tant qu’ID client dans les requêtes vers Piano Analytics. Côté 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 couramment 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étecter les événements envoyés à Piano Analytics

Il existe deux moyens faciles 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 bien é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 > Explorer > Audience > Trafic global.
3. Choisissez le site et la plage de dates dans le menu ci-dessous.

Destination : Importer le segment de Piano

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

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

FAQ de dépannage : 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 l’ID visiteur 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 l’ID visiteur, vous pouvez synchroniser les ID utilisateur sur toutes 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 de point 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.