We’ve migrated our documentation to a new site, which means some URLs have changed.
Analytics

Comment intégrer Google Ad Manager (ou une autre plateforme publicitaire) à Piano Analytics ?

Si vous utilisez Google Ad Manager (GAM) — ou une plateforme publicitaire côté éditeur similaire — et que vous souhaitez que les données de revenus, d'impressions et de clics collectées par ces plateformes soient disponibles aux côtés de vos données de trafic Piano Analytics, vous disposez de trois options. Cet article les présente et vous aide à choisir celle qui convient à votre situation.

Option 1 : activer Ad Revenue Insights (recommandé)

Ad Revenue Insights (ARI) est le module Piano Analytics conçu spécifiquement pour ce cas d'usage. Lorsqu'ARI est activé pour votre compte, Piano capture les données de revenus publicitaires via des événements standard (Ad.impression, Widget.impression) associés à vos données de trafic existantes, et les expose à travers des boards Workspaces préconfigurés.

Ce qu'ARI vous apporte :

  • Un suivi automatisé des revenus, des impressions et du CPM, associé à vos données de trafic Piano Analytics — sans ETL personnalisé.

  • Deux boards prêts à l'emploi couvrant une vue ad-ops et une vue exécutive.

  • L'accès à l'ensemble du data model ARI (ad_revenue, type de line item, plateforme publicitaire, annonceur, section de contenu, etc.) pour créer vos propres rapports dans Data Query.

  • Une compatibilité native avec Subscription Insights et le reste du data model Piano Analytics — vous pouvez analyser les revenus publicitaires au regard des revenus d'abonnement, des performances de contenu et des segments d'audience, sans travail d'intégration supplémentaire.

Comment l'activer :

  • Contactez votre account manager Piano Analytics pour confirmer qu'ARI peut être ajouté à votre contrat. ARI est une option payante, et sa tarification dépend de votre périmètre ; votre account manager vous accompagnera dans l'évaluation de vos besoins.

  • Une fois l'option activée, suivez la documentation Introduction à Ad Revenue Insights pour mettre en place les boards prêts à l'emploi et prendre connaissance du data model.

C'est la seule voie qui ne nécessite aucun développement personnalisé de votre côté : c'est donc l'option recommandée si votre contrat le permet.

Option 2 : marquage d'événements personnalisés côté site/application

Si l'activation d'ARI n'est pas envisageable (par exemple, si votre contrat ne la couvre pas actuellement, ou si vous n'avez besoin que d'une partie des cas d'usage liés aux revenus publicitaires), vous pouvez mettre en place des événements personnalisés côté site ou application qui transmettent l'activité publicitaire directement à Piano Analytics via le SDK Piano Analytics.

Fonctionnement :

  • Pour chaque impression ou clic publicitaire que vous souhaitez suivre, déclenchez un événement personnalisé à l'aide du SDK JavaScript (ou de l'équivalent d'un SDK mobile) au moment où l'impression ou le clic se produit dans votre code de diffusion publicitaire.

  • Incluez dans l'événement les propriétés de contexte publicitaire dont vous avez besoin — généralement l'identifiant de l'ad unit, le line item, l'annonceur et le montant du revenu (s'il est connu au moment de l'impression).

  • Ces événements personnalisés sont stockés dans Piano Analytics et peuvent être analysés dans Data Query comme n'importe quel autre événement.

Avantages et inconvénients :

  • Aucun coût Piano supplémentaire — cette approche s'appuie sur votre marquage Piano Analytics existant.

  • Nécessite un effort de développement côté site/application pour intégrer les événements à votre code de diffusion publicitaire, ainsi qu'une maintenance continue à mesure que celui-ci évolue.

  • Aucun board prêt à l'emploi. Vous construisez vos propres analyses dans Data Query à partir des événements personnalisés.

  • La précision des revenus dépend de ce qui est disponible au moment de l'impression. Si vos montants de revenus ne sont finalisés que plus tard (par exemple, après l'enchère ou après réconciliation dans GAM), l'événement côté site ne contiendra pas une valeur de revenu exacte et vous devrez procéder à une réconciliation séparée.

Option 3 : importer des métriques agrégées via les Measurements

Une troisième voie consiste à exporter des rapports publicitaires agrégés depuis GAM (ou une plateforme similaire) et à les importer dans Piano Analytics à l'aide de la fonctionnalité Measurements. Measurements est le mécanisme conçu par Piano Analytics pour importer des données numériques agrégées et rattachées à une date — exactement la forme d'un rapport quotidien de revenus ou d'impressions GAM.

Fonctionnement :

  • Configurez votre plateforme publicitaire (GAM, par exemple) pour qu'elle fournisse des exports quotidiens — généralement des téléchargements CSV ou des exports BigQuery — des métriques que vous souhaitez suivre (revenus, impressions, clics, CPM, taux de remplissage, etc.) à la granularité dont vous avez besoin (par jour, par ad unit, par line item, par annonceur).

  • Transmettez les valeurs agrégées à Piano Analytics sous forme de métriques Measurement, qualifiées par des propriétés qui servent de clés de réconciliation. Les propriétés Piano Analytics standard (comme le pays ou la région) peuvent être réutilisées ; les dimensions spécifiques à la publicité (ad unit, line item, annonceur) doivent être déclarées comme des propriétés personnalisées sur le Measurement.

  • Une fois importées, les données sont disponibles aux côtés des données analytiques dans Explorer, Data Query et Workspaces. Vous pouvez ainsi, par exemple, représenter les revenus GAM par jour à côté du volume de visites de votre site sur un même graphique, ou ventiler les revenus selon une propriété d'ad unit associée à vos sections de contenu.

Avantages et inconvénients :

  • Aucun coût de licence Piano supplémentaire au-delà de votre contrat Piano Analytics existant.

  • Un certain effort d'ingénierie — vous développez un petit ETL qui lit le rapport quotidien, transforme chaque ligne en payload Measurement et l'envoie à l'endpoint Measurements. Le processus est officiellement pris en charge et documenté (contrairement à l'approche Data-In ad hoc), il est donc plus léger qu'un développement en partant de zéro.

  • Des données agrégées, et non au niveau de l'événement. Measurements importe des valeurs agrégées (par exemple, « revenu par ad unit et par jour »), et non des impressions individuelles. Vous ne pouvez pas passer d'une valeur Measurement à une session utilisateur précise — une analyse granulaire nécessite toujours l'option 1 (ARI) ou l'option 2 (marquage d'événements).

  • Des données quotidiennes, et non en temps réel. Les données arrivent dans Piano Analytics le lendemain de la période couverte par le rapport GAM.

  • Non disponibles dans Data Flow ni Data Sharing. Les données Measurement sont exposées dans l'interface, Explorer, Data Query et Workspaces — mais elles n'alimentent pas les exports Data Flow ni Data Sharing.

  • Aucun board prêt à l'emploi. Vous construisez les visualisations dont vous avez besoin dans Workspaces / Data Query à partir des métriques et propriétés Measurement importées.

Quelle option choisir ?

Si vous souhaitez…

Choisissez

La voie la plus rapide vers une analyse complète des revenus publicitaires, associée aux données du site, avec des boards prêts à l'emploi

Ad Revenue Insights (option 1)

Un suivi léger des événements publicitaires directement dans votre contrat PA existant, et vous disposez de ressources de développement côté site/application

Marquage d'événements personnalisés (option 2)

Des données publicitaires agrégées quotidiennes associées à PA, sans coût Piano supplémentaire, et vous disposez de ressources d'ingénierie pour un ETL léger

Import via Measurements (option 3)

Une analyse côte à côte uniquement (sans association nécessaire)

Aucune — analysez dans l'interface de reporting propre à chaque outil

Qu'en est-il de Google Ads, Meta Ads ou Search Ads 360 ?

Ad Revenue Insights se concentre sur les revenus publicitaires côté éditeur — l'argent que votre site génère en diffusant des publicités. Cela le distingue d'Ad Performance Insights, qui se concentre sur les coûts publicitaires sortants — ce que vous dépensez sur Google Ads ou Meta Ads pour acquérir des visiteurs.

Si votre question d'intégration porte sur les campagnes sortantes (Google Ads, Meta Ads), consultez plutôt la documentation Ad Performance. ARI ne propose pas actuellement de connecteurs natifs pour Google Ads, Meta Ads ou Search Ads 360, car il s'agit de plateformes d'acquisition, et non de monétisation.

Last updated: