Configurer Piano Analytics
Piano Analytics est un partenaire d'analyses intégré dans Adjust. Notre intégration permet à Piano Analytics de recevoir des données mesurées dans Adjust via des callbacks automatisés. Utilisez ces données avec les outils des partenaires concernant les analyses et les insights.
Dans cet article, découvrez comment configurer la mesure avec Piano Analytics pour votre application. Cela inclut l'activation de l'intégration et de choisir les données que Adjust peut partager avec Piano Analytics.
Avant de commencer
Prérequis
- Autorisations Administrateur, Éditeur ou Éditeur personnalisé dans Adjust.
- Adjust SDK v4.0.0+ pour mapper les paramètres du SDK avec les paramètres Piano Analytics. Suivez les guides ci-dessous pour utiliser cette fonctionnalité :
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Identifiants
Collection Domain et Site ID
- Si vous avez besoin d'aide pour trouver vos identifiants, contactez votre représentant Piano Analytics.
Dans votre dashboard Piano Analytics :
Avant d'activer l'intégration Piano Analytics, vous devez créer les événements suivants dans l'interface utilisateur Piano Analytics avec les noms exacts , tels qu'ils apparaissent ci-dessous pour veiller à ce que vos données soient reportés correctement :
- adjust.installs
- adjust.uninstalls
- adjust.reinstalls
- adjust.reattributions
Vous trouverez ici des instructions pour créer ces événements dans Piano Analytics.
Sélectionner Piano Analytics et votre application dans Campaign Lab
- Sous Campaign Lab , sélectionnez Partenaires .
- Sélectionnez Nouveau partenaire > Piano Analytics . Sélectionnez Suivant pour passer à l'écran suivant.
- Dans l'écran Sélection d'app , choisissez l'application pour laquelle vous souhaitez créer le lien, puis activez l'intégration pour partager des données avec Piano Analytics.
- Sélectionnez Suivant .
Activer le partage des données
Activez le partage des données pour activer l'intégration avec Piano Analytics. Pour activer le partage des données :
- Indiquez vos Collection Domain et Site ID.
Lorsque vous avez activé le partage des données avec Piano Analytics, Adjust envoie automatiquement à Piano Analytics les données suivantes par défaut :
- installation
- désinstallation
- réinstallation
- réattribution
Configurez vos options de partage de données
Si vous utilisez une application multiplateforme dont le partage des données est activé pour plusieurs plateformes, vous pouvez :
- Séparer les options de partage des données au niveau de chaque plateforme en sélectionnant Utiliser les paramètres spécifiques à la plateforme .
- Définir les mêmes paramètres de partage des données pour plusieurs plateformes en sélectionnant Utiliser les paramètres globaux .
Maintenant, sous Quelles sont les données partagées par défaut ? , vérifiez les activités partagées par défaut par Adjust avec Piano Analytics :
- installation
- désinstallation
- réinstallation
- réattribution
Envoyer des données supplémentaires
Choisissez la quantité et le type de données que vous souhaitez partager avec Piano Analytics à travers les callbacks. Piano Analytics peut utiliser ces informations afin d'optimiser les performances.
Pour envoyer des données supplémentaires, vous pouvez vérifier et personnaliser ce qui suit :
Désinstallations et réinstallations
Le partage des désinstallations ou des réinstallations permet à Piano Analytics de recevoir les données de désinstallation et/ou de réinstallation de votre application mesurées par Adjust.
Pour les applications iOS, vous obtiendrez certainement une faible valeur de désinstallations et/ou de réinstallations. Pour plus d'informations, consultez Mesure des désinstallations et des réinstallations.
Mapper les paramètres
Vous devez généralement mapper les paramètres pour partager des données personnalisées avec Piano Analytics.
Les paramètres de partenaire (disponibles à partir de la version 4.0 du SDK Adjust) permettent à Adjust de collecter des points de données personnalisés à partir de votre application et de les transmettre directement à Piano Analytics. Piano Analytics reçoit alors le détail des événements personnalisés pour chacun de vos événements liés.
Avant d'ajouter de nouveaux paramètres de partenaire au SDK Adjust, assurez-vous qu'aucun autre paramètre de partenaire prédéfini ne satisfait déjà vos exigences.
Pour partager les paramètres de partenaire avec Piano Analytics, procédez comme suit :
Configurez les paramètres partenaires dans le SDK Adjust.
- Effectuez la vérification avant de commencer pour tous les liens de la plateforme de développement du SDK.
Sous Définir vos options de partage des données , sélectionnez Paramètres .
Sous Mapper les paramètres , vous pouvez spécifiez la façon dont vous souhaitez envoyer les paramètres partenaires définis dans le SDK au réseau :
- Sélectionnez Mapper le paramètre .
- Dans le champ Paramètre du SDK , saisissez le nom du paramètre SDK que vous souhaitez partager avec le réseau.
- Dans le champ Paramètre partenaire , saisissez le paramètre réseau correspondant au paramètre du SDK.
Si vous configurez les paramètres partenaires dans le SDK Adjust sans configurer le partage des paramètres dans le dashboard, Adjust transfère les paramètres tels qu'ils sont nommés dans le SDK Adjust.
Activer Piano Analytics pour votre application
Dans l'écran Vérification de la configuration , vérifiez vos choix. Vous pouvez revenir en arrière et modifier les éléments suivants :
- L'application sélectionnée.
- Options de partage des données
Sélectionnez Activer le partenaire pour activer Piano Analytics pour votre application. Les partenaires d'analyses ne fonctionnent pas avec les liens pour les campagnes. Après activation, notre intégration envoie les données d'attribution et d'événements in-app à travers des callbacks automatisés.
Instructions de configuration spécifiques aux partenaires
Piano Analytics requiert son Visitor ID pour lier l'installation initiale aux événements in-app suivants. Pour cela, vous devez envoyer le Visitor ID de Piano Analytics sous la forme d'une paramètre partenaire global du SDK, avec le nom exact PAVisitorId . Pour plus d'informations sur l'association de paramètres partenaires globaux, consultez la documentation appropriée :
Voici un exemple du code à implémenter pour Android :
const PAVisitorId = pa.getVisitorId();
Adjust.addGlobalPartnerParameter("PAVisitorId", PAVisitorId);
Liste de tous les paramètres transférés à Piano Analytics
Piano Analytics demande à Adjust d'envoyer les paramètres suivants (points de données) avec vos callbacks :
Espace réservé | Informations |
{session_count} | Nombre de sessions enregistrées par le SDK Adjust actuel |
{adgroup_name} | Nom de l'adgroup, tel que pris à partir du tracker |
{campaign_name} | Nom de la campagne, tel que pris à partir du tracker |
{created_at} | Horodatage de l’activité |
{creative_name} | Nom du créatif, tel que pris à partir du tracker |
{device_manufacturer} | Nom du fabricant de l'appareil |
{installed_at} | Horodatage de l’installation (c.-à-d. première ouverture de l’app) |
{network_name} | Nom du réseau, tel que pris à partir du tracker |