Intégration de Piano Analytics

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 via des rapports et des 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.

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

Comptes payants à la fois sur Pushwoosh et Piano Analytics

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

Source

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

Destination

• Segments

Analyses unifiées

Combinez les données d’engagement de Pushwoosh avec Piano Analytics pour obtenir une vision complète des 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 toutes les plateformes.

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 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.

1. Post Events
   • Pushwoosh envoie des données d’événements à 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 ex., 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 :
   • En option, intégrez le VisitorID de Piano à Pushwoosh pour des analyses unifiées sur les SDK.

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 > 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ète 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 jusqu’à 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.

• 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 tiret bas. Par exemple : accesskey_secretkey.

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”.

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

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 à 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é. Ensuite, cliquez sur Enregistrer.

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 String.
6. Cliquez sur Enregistrer.

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 granulaire 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.

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. Le Segment Key, qui est un identifiant unique pour le segment enregistré, sera nécessaire plus tard pour envoyer des segments à Pushwoosh.

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

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.

Si un client souhaite accumuler des analyses à la fois 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/l’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 le Visitor ID 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 une seule fois avec la valeur du tag.

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

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

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

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

__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 de l’appareil
• Version de l’OS
• Type de navigateur (dans certains cas)

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

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.

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.

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.

Solution : Utilisez l’Inspecteur de flux de Piano ou vérifiez le Trafic global dans Piano Analytics pour surveiller les événements entrants depuis 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.

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 deux plateformes.

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.