Prise en main et processus d'intégration

Processus d'intégration

Le processus d'intégration se compose de deux étapes simples :

• Mise en place du suivi de lien sur vos URLs en utilisant une méthode propriétaire et simple

• Déléguer l'accès API aux plateformes marketing

Quels paramètres UTM Ad Performance requiert-il ?

Paramètres UTM standard (toujours requis)

Ce sont les UTM de base déjà reconnus par Piano Analytics pour l'attribution des sources marketing :

• utm_source

• utm_medium

• utm_campaign

S'ils sont manquants ou vides, Ad Performance ne peut pas du tout attribuer la visite à une campagne.

Paramètres UTM supplémentaires requis par Ad Performance

En plus des UTM standard, Ad Performance exploite les paramètres suivants pour identifier la campagne spécifique, le groupe d'annonces, l'annonce et la plateforme au sein du compte publicitaire :

Les ID sont généralement renseignés dynamiquement par la syntaxe de modèle propre à la plateforme publicitaire (par exemple, {{campaign.id }} dans Meta Ads ou {campaignid} dans Google Ads).

Exemples

Google Ads — suffixe d'URL finale

&utm_source=google&utm_medium=cpc&utm_campaign={campaign}
&utm_cid={campaignid}&utm_agid={adgroupid}

Meta Ads — paramètres d'URL

&utm_source=meta&utm_medium=cpc&utm_campaign={{campaign.name}}
&utm_cid={{campaign.id}}&utm_agid={{adset.id}}&utm_adid={{ad.id}}
&utm_platform={{site_source_name}}

Pièges courants

• Les raccourcisseurs d'URL (bit.ly , etc.) cassent Ad Performance. Les raccourcisseurs redirigent via leur propre URL, ce qui supprime les paramètres originaux avant le chargement de la page de destination. Utilisez le modèle de tracking propre à la plateforme publicitaire plutôt qu'un raccourcisseur tiers.

• Les propriétés UTM existantes sur les événements sont au scope événement. Les propriétés UTM ne sont renseignées que sur l'événement où l'URL les contenait (généralement le premier page.display). Pour le suivi des conversions, consultez la section sur les propriétés src_… au scope visite dans la FAQ sur les UTM standard.

• utm_cid est distinct de utm_campaign. utm_campaign contient le nom lisible de la campagne ; utm_cid contient l'ID numérique qu'Ad Performance utilise pour effectuer la jointure avec les données de coûts de la plateforme. N'inclure que l'un des deux est insuffisant.

Comment fonctionne la délégation

1. Indiquez à Piano quels comptes vous souhaitez connecter. Fournissez une liste des ID de comptes publicitaires que vous souhaitez inclure, la plateforme pour chacun (Google Ads ou Meta Ads), ainsi que tout contexte de nommage (par exemple, comptes régionaux : « EU », « US », « APAC »). Vous pouvez avoir plusieurs comptes par plateforme — listez chacun séparément.

2. Recevez les liens de délégation. Piano envoie un lien de délégation par compte. Chaque lien est valide pour une durée limitée après sa génération (généralement quelques jours) ; si le lien expire avant que vous ne cliquiez dessus, demandez à Piano de le réémettre.

3. Autorisez depuis un compte disposant des droits administrateur. Cliquez sur le lien de délégation en étant connecté à la plateforme publicitaire concernée avec un compte administrateur sur l'organisation cible (pas un simple compte utilisateur individuel). Les utilisateurs standard ne peuvent pas autoriser la délégation API.

4. Confirmez l'activation. Une fois la délégation accordée, Piano active Ad Performance pour ce compte. Les données commencent à être transmises lors du prochain import quotidien.

Ajouter des comptes ultérieurement

Vous n'avez pas besoin d'énumérer tous les comptes dès le départ. De nouveaux comptes peuvent être ajoutés à tout moment :

1. Ouvrez un ticket au Support (ou contactez votre account manager) avec les nouveaux ID de comptes et la plateforme.

2. Recevez un lien de délégation pour chaque nouveau compte.

3. Autorisez comme ci-dessus. Les nouveaux comptes commencent à transmettre des données lors du prochain import quotidien après la fin de la délégation.

L'ajout de comptes au-delà de votre limite contractuelle entraîne des frais supplémentaires par compte — consultez l'article Informations clés pour la tarification en vigueur.

Comptes régionaux et configurations multi-comptes

Pour les organisations disposant de comptes publicitaires régionaux ou par ligne de produits (par exemple, des comptes Google Ads distincts pour l'EU, les US et l'APAC), chaque compte est connecté individuellement via son propre lien de délégation. Une fois connectés, tous les comptes alimentent le même Data Model Ad Performance dans votre organisation Piano Analytics, de sorte qu'une analyse inter-comptes (par ex. dépenses totales sur toutes les régions) est possible directement depuis le board Workspaces Ad Performance.

Essai

Si vous n'êtes pas sûr, Piano Analytics propose un essai de 30 jours de la fonctionnalité Ad Performance afin que vous puissiez l'évaluer sur des données de campagne réelles avant de vous engager sur un abonnement.

Ce que l'essai inclut

• Durée : 30 jours à partir de l'activation.

• Périmètre : Un seul compte publicitaire — soit un seul compte Google Ads, soit un seul compte Facebook/Meta Ads, pas les deux.

• Fonctionnalités : Comportement complet d'Ad Performance pour le compte en essai — import quotidien automatisé des données, le Data Model dédié Ad Performance (propriétés AP), et accès au board Workspaces standard pour Ad Performance.

Vous pouvez utiliser l'essai pour valider la valeur de la fonctionnalité sur des données réelles, former votre équipe sur les boards, et confirmer que votre configuration des paramètres UTM répond aux exigences d'Ad Performance avant un déploiement plus large.

Prérequis

Avant de demander un essai, assurez-vous que :

• Votre marquage est sur le SDK Piano Analytics 6.0+ (ou, pour les sites encore sur le marquage legacy, SmartTag 5.29.4+).

• Le compte publicitaire que vous souhaitez tester est sur une plateforme prise en charge : Google Ads ou Facebook/Meta Ads. (Search Ads 360 n'est pas pris en charge par Ad Performance, que ce soit en essai ou autrement.)

• Les URL que vous utilisez dans les campagnes de ce compte publicitaire incluent les paramètres UTM supplémentaires requis par Ad Performance. Consultez l'article dédié aux paramètres UTM pour la liste exacte.

• Les URL ne sont pas raccourcies par un raccourcisseur d'URL tiers — Ad Performance ne peut pas lire les paramètres UTM nécessaires à partir d'URL raccourcies.

Comment demander l'essai

1. Contactez votre account manager Piano Analytics (ou support@piano.io si vous n'en avez pas encore d'attribué) et demandez un essai Ad Performance.

2. Fournissez l'ID du compte publicitaire que vous souhaitez tester et la plateforme (Google Ads ou Meta).

3. Piano vous enverra un lien de délégation pour la plateforme. Cliquez sur le lien et accordez à Piano Analytics l'accès API nécessaire au compte.

4. Une fois la délégation confirmée, Piano active Ad Performance sur le compte en essai. Les données commencent à être transmises lors du prochain cycle d'import quotidien.

Après l'essai

À la fin de la période de 30 jours :

• Si vous décidez de souscrire, votre account manager convertira l'essai en abonnement Ad Performance payant. La continuité des données est préservée — aucun ré-onboarding nécessaire.

• Si vous ne souscrivez pas, le compte en essai est déconnecté et Ad Performance cesse d'importer des données depuis celui-ci. Les données historiques collectées pendant l'essai restent visibles dans votre compte Piano Analytics pour la durée de rétention des données standard.

Last updated: May 28, 2026