Metrics
Métriques Google Ads via l'API
Votre client connecte son compte Google Ads et votre produit interroge 94 métriques par le même endpoint que les autres plateformes. Chaque métrique a un identifiant (reference_key) qui figure dans l'appel.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "gads:clicks",
"component": "number_v1",
"metrics": [
"metrics.clicks"
]
}
]
}Plus d'exemples d'appels Google Ads
Le même endpoint pour chaque type de métrique. Les champs metrics et dimensions de chaque élément viennent du catalogue de la plateforme (GET /api/metrics/{integration_slug}).
Graphique
Clics par type d'appareil utilisé
Ce graphique présente le nombre de clics sur vos publicités, organisé par type d'appareil utilisé.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:clicks_per_device",
"component": "chart_v1",
"metrics": [
"metrics.clicks"
],
"dimensions": [
"device"
]
}
]
}Tableau
Résumé des Groupes de publicités
Tous vos groupes de publicité, triés par clics.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:summary_per_adgroups",
"component": "datatable_v1",
"metrics": [
"metrics.clicks",
"metrics.cost_micros",
"metrics.impressions",
"metrics.conversions",
"metrics.absolute_top_impression_percentage",
"metrics.cost_per_conversion"
],
"dimensions": [
"ad_group"
]
}
]
}Chiffre
Les campagnes comptent
Nombre de campagnes ayant bénéficié d'un certain investissement.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "gads:count_campaigns",
"component": "number_v1",
"metrics": [
"metrics.cost_micros"
],
"dimensions": [
"campaign"
]
}
]
}Chiffres
57 métriques
Clics
Nombre de fois que quelqu'un a cliqué sur votre publicité.
gads:clicksLes campagnes comptent
Nombre de campagnes ayant bénéficié d'un certain investissement.
gads:count_campaignsDécompte des publicités
Nombre d'annonces qui ont eu un certain investissement.
gads:count_adsToutes les conversions
Toutes les conversions inclut les données de votre colonne "Conversions" et les actions de conversion que vous avez souhaité ne pas inclure dans la colonne "Conversions". Cela indique également les conversions entre différents appareils, les visites de la boutique, certains appels téléphoniques, et plus.
gads:all_conversionsValeur des conversions
La somme des valeurs de conversion des conversions incluses dans la colonne 'Conversions'. Cette métrique n'est utile que si vous avez saisi une valeur pour vos actions de conversion.
gads:conversions_valueValeur de toutes les conversions
La valeur de toutes les conversions englobe les données de votre colonne "Conversions" et les actions de conversion que vous avez choisi de ne pas inclure dans la colonne "Conversions". Elle montre également des conversions sur des appareils différents, des visites en magasin, certains appels téléphoniques et bien plus encore.
gads:all_conversions_valueConversions
Une action qui est prise en compte lorsque quelqu'un interagit avec votre publicité ou avec la liste gratuite de produits (par exemple, un clic sur le texte d'une publicité ou quelqu'un qui regarde la vidéo d'une publicité) et qui ensuite prend une action que vous définissez comme de valeur (par exemple, un achat en ligne ou un appel vers votre entreprise depuis un smartphone).
gads:conversionsImpressions
Nombre de fois que votre publicité est apparue dans les résultats d'une recherche sur une page ou sur le site de Google. Une publicité peut apparaître plusieurs fois pour le même utilisateur.
gads:impressionsVues Vidéo
Nombre de fois où vos vidéos ont été visionnées. Une vue compte lorsqu'une personne regarde 30 secondes de votre vidéo (ou l'intégralité de la vidéo si elle est plus courte) ou interagit avec celle-ci. Les interactions éligibles varient selon le format d'annonce et incluent les clics ou les pressions sur les CTA, les cartes, les bannières associées, les vignettes ou les logos.
gads:video_viewsTDC
Le taux de clics (TDC) représente le nombre total de clics que votre publicité a reçu, divisé par le nombre de fois où elle a été visionnée (impressions).
gads:ctrCoût
La quantité d'argent investie dans votre campagne de publicité sur la période spécifiée.
gads:cost_microsCoût pour toutes les conversions
Le coût pour toutes les conversions indique combien, en moyenne, chacune des conversions vous coûte. Le résultat est obtenu en divisant le coût total par le nombre de toutes les conversions. Toutes les conversions prend en compte toutes les actions de conversions, mêmes celles que vous avez souhaité ne pas inclure dans les "Conversions". Cela inclut d'autres sources de conversion spéciales.
gads:cost_per_all_conversionsCoût par conversion
Coût total divisé par toutes les conversions.
gads:cost_per_conversionCPM moyen
Le coût par mille (CPM) est le coût moyen de 1000 impressions. Il est calculé en divisant le montant dépensé par le nombre d'impressions x 1000. Le CPM est un indicateur commun, utilisé par l'industrie de la publicité en ligne pour calculer le rapport coût-bénéfice d'une campagne de publicité. Il est souvent utilisé pour comparer la performance entre différents diffuseurs de publicités et de campagnes.
gads:average_cpmCPC moyen
Le coût par clic (CPC) montre combien, en moyenne, chaque clic vers un lien vous coûte. Calculé en divisant le coût par le nombre de clics. Le CPC est un indicateur utilisé dans l'industrie de la publicité en ligne comme un point de référence pour mesurer l'efficacité et la performance de la publicité.
gads:average_cpcCPV moyen
Le coût par vue (CPV) est une méthode d'enchères pour les campagnes vidéo où vous payez pour une vue. Une vue est comptabilisée lorsqu'un internaute regarde 30 secondes de votre annonce vidéo (ou l'intégralité de l'annonce si elle dure moins de 30 secondes) ou interagit avec celle-ci, selon la première éventualité. Les interactions vidéo incluent les clics sur les superpositions d'incitation à l'action (CTA), les cartes et les bannières associées. Vous définissez des enchères au CPV pour indiquer à Google le montant maximum que vous êtes prêt à payer par vue.
gads:average_cpvTaux de Conversion
Le taux de conversion indique la fréquence moyenne à laquelle une interaction avec une annonce entraîne une conversion. Il s'agit du nombre indiqué sous "Conversions" divisé par le nombre d'interactions avec votre annonce. Les interactions avec les publicités incluent les clics sur les publicités textuelles et les vues des publicités vidéo. Cette statistique n'inclut que les interactions susceptibles de générer des conversions.
gads:conversions_from_interactions_rateROAS
Le retour sur les dépenses publicitaires (ROAS) est le profit que vous tirez de vos publicités par rapport à vos investissements publicitaires. Il est calculé en divisant la valeur des conversions par le coût.
gads:roasValeur de toutes les conversions par coût
La valeur de toutes les conversions par coût mesure le retour sur investissement de toutes les conversions. Il s'agit de la valeur de toutes les conversions divisée par le coût de toutes les interactions avec les annonces, telles que les clics sur les annonces textuelles ou les vues des annonces vidéo. Cette statistique n'inclut pas les interactions qui ne génèrent pas de conversions, comme celles qui se produisent lorsque vous n'utilisez pas le suivi des conversions.
gads:all_conversions_value_per_costValeur des conversions par coût
La valeur de conversion coût-coût mesure votre retour sur investissement. Il reflète la valeur de conversion divisée par le coût de toutes les interactions publicitaires. Le coût de cette statistique n'inclut pas les interactions qui ne peuvent pas conduire à des conversions, comme celles qui se produisent lorsque vous n'utilisez pas le suivi des conversions.
gads:conversions_value_per_costAppels Téléphoniques
Nombre de fois que les personnes ont cliqué sur un numéro de téléphone affiché dans une annonce pour appareils mobiles ou ont composé le numéro de renvoi d'appels Google affiché dans une annonce sur n'importe quel appareil.
gads:phone_callsVoir le taux de vidéos
La statistique "Taux de visionnage" vous indique le pourcentage de personnes qui ont regardé vos vidéos après avoir visionné la vidéo ou la miniature pour la première fois. Elle est égale au nombre de vues de votre annonce divisé par le nombre d'impressions, y compris les impressions de miniatures de annonces de découverte vidéo.
gads:video_view_rateConversions vidéo
Nombre de fois où les spectateurs ont effectué l'action souhaitée après avoir regardé l'annonce vidéo au cours de la période analysée.
gads:video_conversionsTaux de conversion vidéo
Le taux de conversion indique la fréquence moyenne à laquelle une interaction avec une annonce entraîne une conversion. Il est égal au nombre indiqué sous "Conversions" divisé par le nombre d'interactions avec votre annonce. Les interactions avec une annonce incluent les clics sur les annonces textuelles et les visionnages des annonces vidéo. La métrique n'inclut que les interactions qui peuvent conduire à des conversions.
gads:video_conversions_rateCTR des vidéos
Le taux de clics (CTR) mesure la fréquence à laquelle les internautes cliquent sur votre annonce après l'avoir visionnée. Cela peut vous aider à comprendre l'efficacité de l'annonce. Pour calculer le CTR, vous devez diviser le nombre de clics reçus par votre annonce par le nombre d'affichages de votre annonce.
gads:video_ctrImpressions vidéo
Nombre de fois que l'annonce vidéo a été diffusée auprès des internautes sur la plate-forme YouTube au cours de la période de référence. Cela signifie qu'à chaque fois qu'un internaute voit l'annonce, une impression est comptabilisée, qu'il ait regardé l'intégralité de la vidéo ou seulement une partie de celle-ci.
gads:video_impressionsClics vidéo
Nombre de fois où l'internaute a cliqué sur la publicité vidéo lors de son affichage au cours de la période analysée.
gads:video_clicksTaux d'interaction
Le "taux d'interaction" correspond au nombre d'interactions divisé par le nombre total d'impressions. Il mesure la fréquence à laquelle les internautes interagissent avec votre annonce après y avoir été exposés. Cela vous aide à évaluer l'efficacité de l'annonce.
gads:interaction_rateInteractions
Une interaction est l'action principale associée à un format d'annonce. Cela peut inclure des clics sur des annonces textuelles et Shopping, des vues sur des annonces vidéo, etc.
gads:interactions% d'impressions (en haut)
Le taux d'impressions de recherche le plus élevé est le pourcentage d'impressions affichées n'importe où au-dessus des résultats de recherche organiques.
gads:top_impression_percentageEngagements
Un engagement se produit lorsqu'un consommateur interagit avec une publicité, par exemple en visionnant au moins 10 secondes ou en cliquant sur une publicité vidéo. Ainsi, cela permet de mesurer les performances de l'annonce. Des publicités hautement ciblées et pertinentes avec un contenu convaincant encouragent les utilisateurs à interagir plus activement avec votre marque.
gads:engagementsTaux d'engagement
Le taux d'engagement est utilisé pour mesurer la fréquence à laquelle les internautes interagissent avec votre annonce après sa diffusion. Utilisez-le pour évaluer l'efficacité de votre annonce. Le taux d'engagement est le nombre d'engagements divisé par le nombre total d'impressions.
gads:engagement_rateCPE moyen
Le coût moyen par engagement (CPE) est le montant moyen facturé pour un engagement publicitaire. Ce montant représente le coût total des engagements publicitaires divisé par le nombre total d'engagements publicitaires.
gads:cpe% d'impressions (1ère position)
Le taux d'impression de première recherche est le pourcentage d'impressions qui apparaissent comme première annonce au-dessus des résultats de recherche organiques.
gads:absolute_top_impression_percentagePart des Impressions de Recherche
La part d'impressions (IS) est le pourcentage d'impressions que vos annonces reçoivent par rapport au nombre total d'impressions qu'elles pourraient recevoir. Les valeurs inférieures à 10 % apparaissent comme 9,99 %, car Google ne fournit pas le nombre exact dans cette plage.
gads:search_impression_shareVues de la page
Le nombre de fois qu'une page a été vue après une interaction avec l'annonce.
gads:conversions_page_viewsAjouts au panier
Nombre de fois que des produits ont été ajoutés au panier par les utilisateurs après avoir interagi avec les annonces.
gads:conversion_add_to_cartCommencer le Paiement
Le nombre de fois qu'une personne a commencé le processus de paiement après une interaction avec l'annonce.
gads:conversion_begin_checkoutAchats
Nombre de transactions complétées via des annonces, indiquant combien d'achats/ventes ont été générés directement par les campagnes Google Ads.
gads:conversion_purchaseDemandes de planification
Le nombre de fois qu'un rendez-vous a été pris après une interaction avec l'annonce.
gads:conversion_book_appointmentContacts
Cette métrique compte le nombre de contacts effectués via des formulaires, des chats ou d'autres formes de communication offertes sur le site, après avoir interagi avec les annonces.
gads:conversion_contactTélécharger
Nombre de téléchargements de fichiers ou d'applications effectués après que les utilisateurs ont cliqué sur les annonces pendant la période analysée.
gads:conversion_downloadLead Converti
Nombre de leads convertis pendant la période analysée. Un lead converti ou "fermé" vous aide à suivre les leads générés par Google qui ont complété une étape choisie dans le processus de conversion des leads, généralement hors ligne (en dehors de Google Ads). Cette étape peut être définie comme la réalisation d'une vente, une transaction conclue hors ligne ou en ligne, ou toute étape que vous déterminez comme "conversion".
gads:conversion_converted_leadConversions (Engagement)
Le nombre de fois qu'une personne a interagi avec votre annonce après une interaction avec l'annonce.
gads:conversion_engagementObtenir des indications
Le nombre de fois qu'une personne a demandé des indications pour se rendre à votre entreprise après une interaction avec l'annonce.
gads:conversion_get_directionsClic Sortant
Le nombre de fois qu'une personne a cliqué sur un lien vers un autre site après une interaction avec l'annonce.
gads:conversion_outbound_clickProspect d'Appel Téléphonique
"Phone Call Lead" indique combien de fois votre annonce a été affichée avec un numéro de transfert d'appel Google, ou combien de fois un numéro de transfert d'appel Google aurait pu être affiché à quelqu'un sur votre site web.
gads:conversion_phone_call_leadLead Qualifié
Nombre de leads qualifiés pendant la période analysée. Un lead qualifié ou "intéressé" vous aide à suivre les leads générés par Google qui ont également été qualifiés hors ligne (en dehors de Google Ads) dans votre système de gestion de la relation client (CRM) ou système interne de génération de leads.
gads:conversion_qualified_leadDemandes de devis
Le nombre de fois qu'une personne a demandé un devis après une interaction avec l'annonce.
gads:conversion_request_quoteAbonnements
Nombre de fois qu'une personne s'est inscrite à une newsletter ou à un essai gratuit, a créé un compte ou s'est préinscrite.
gads:conversion_sign_upVisites en Magasin
Nombre de clients ayant reçu ou cliqué sur vos annonces en ligne puis ayant visité votre magasin physique.
gads:conversion_store_visitVentes en Magasin
Nombre d'achats hors ligne qui ont eu lieu après que les clients ont interagi avec vos annonces Google.
gads:conversion_store_saleSoumettre un Formulaire de Lead
Nombre de formulaires de lead soumis après avoir interagi avec des annonces. Ces formulaires recueillent généralement des informations auprès d'utilisateurs intéressés par des produits ou services, étant essentiels pour générer des leads qualifiés.
gads:conversion_submit_lead_formEnvoyer le formulaire de lead (toutes les conversions)
Nombre total de conversions* de formulaires de lead envoyés après interaction avec des annonces. Ces formulaires collectent généralement des informations sur les utilisateurs intéressés par des produits ou des services, ce qui est essentiel pour générer des leads qualifiés. *Toutes les conversions incluent ce qui est configuré comme "Conversions" et d'autres données, telles que les conversions marquées comme actions secondaires.
gads:conversion_submit_lead_form_all_conversionsAbonnements payants
Cette métrique compte le nombre d'inscriptions ou d'enregistrements effectués par des utilisateurs après avoir cliqué sur une annonce.
gads:conversion_subscribe_paidPTR (Taux de Passage)
Le nombre total d'appels (appels téléphoniques) reçus divisé par le nombre de fois où votre numéro de téléphone a été affiché (impressions de numéro de téléphone).
gads:ptrCoût par Appel Téléphonique
Le coût total de vos annonces divisé par le nombre d'appels téléphoniques reçus.
gads:cost_per_phone_calls
Graphiques
13 métriques
Clics par type d'appareil utilisé
Ce graphique présente le nombre de clics sur vos publicités, organisé par type d'appareil utilisé.
gads:clicks_per_deviceClics et TDC au fil du temps
Ce graphique présente le nombre de clics et le pourcentage de TDC sur la période spécifiée.
gads:clicks_ctr_per_dayConversions par type d'appareil
Ce graphique présente le nombre de conversions générées par vos publicités, organisé par type d'appareil utilisé.
gads:conversions_by_deviceImpressions par Genre
Ce graphique montre le nombre d'impressions générées par vos annonces, regroupées par genre.
gads:impressions_by_genderImpressions par âge
Ce graphique montre le nombre d'impressions générées par vos annonces, regroupées par âge.
gads:impressions_by_ageCoût par type d'appareil
Coût des publicités, organisé par type d'appareil utilisé par le visiteur
gads:cost_per_deviceToutes les conversions et taux de conversions au fil du temps
Ce graphique présente le nombre de conversions et le taux de conversion sur la période spécifiée.
gads:all_conversion_conversion_rate_per_dayConversions et taux de conversion au fil du temps
Ce graphique présente le nombre de conversions et le taux de conversion sur la période spécifiée.
gads:conversion_conversion_rate_per_dayCoût et CPC moyen au fil du temps
Ce graphique présente le coût et CPC moyen sur la période spécifiée.
gads:cost_average_cpc_per_dayImpressions et vues vidéo
Ce graphique représente le nombre de fois où les annonces vidéo ont été affichées (impressions) et combien de fois elles ont été lues (vues) au cours de la période analysée.
gads:video_impressions_by_timeClics vidéo et CTR
Ce graphique vous permet de vérifier le nombre de clics que les publicités vidéo ont reçus (Clicks) et le taux de clics par rapport au nombre de fois que les publicités ont été diffusées (CTR - Click-through Rate) pendant la période analysée.
gads:video_clicks_ctr_by_timeConversion et taux de conversion des vidéos
Este gráfico demonstra o número de ações desejadas (Conversão) que foram realizadas pelo espectador dos anúncios após assisti-los, bem como a taxa de conversão em relação ao número de vezes que os anúncios foram exibidos (Taxa de Conversão) durante o período analisado.
gads:video_conversions_by_timeCoût et CPM moyen des vidéos
Ce graphique montre le coût total des campagnes publicitaires vidéo (coût) et le coût moyen pour livrer 1 000 impressions (CPM - coût pour mille) au cours de la période d'analyse.
gads:video_cost_by_time
Tableaux
24 métriques
Résumé des Groupes de publicités
Tous vos groupes de publicité, triés par clics.
gads:summary_per_adgroupsToutes les campagnes
Toutes vos campagnes de publicités, triées par nombre de clics.
gads:top_campaignsPerformance des Campagnes par ID
Toutes vos campagnes publicitaires avec des IDs de campagne, triées par clics.
gads:campaign_performance_by_idRésumé des mot-clés dans la recherche
Tous les mots-clés que vous payez, triés par clics.
gads:summary_per_keywordsRésumé des termes de recherche de campagnes intelligentes
Résumé des performances de chaque terme de recherche pour les campagnes intelligentes pendant la période analysée. Les termes de recherche sont les mots ou les phrases que les utilisateurs saisissent dans une recherche Google et qui déclenchent l'affichage d'annonces.
gads:summary_per_smart_campaign_search_termPerformance de la URL de destination
Résumé de la performance de chaque URL de destination pendant la période analysée.
gads:destination_url_performanceVidéos en vedette
Ce tableau fournit des informations détaillées sur chaque vidéo publicitaire sur YouTube. Il présente des données telles que le nombre de vues, les clics, le coût, le taux de visionnage et d'autres indicateurs importants afin que vous puissiez évaluer les performances individuelles de chaque vidéo.
gads:featured_videosActions de conversion
Tous les types de conversions personnalisées reçues par la campagne après les interactions avec l'annonce.
gads:custom_conversion_actionsTermes de recherche
Résumé des performances de vos termes de recherche au cours de la période analysée. Les termes de recherche sont les termes utilisés par un nombre important de personnes qui ont entraîné l'affichage de votre annonce au moment de la recherche.
gads:search_termChaînes en vedette
Récapitulatif des performances des emplacements sur lesquels vos annonces ont été diffusées pendant la période d'examen. Les chaînes sont les endroits où vos annonces sont diffusées sur YouTube ou sur le Réseau Display de Google. Un emplacement peut être un site Web ou une page spécifique, une application mobile, un contenu vidéo ou un bloc d'annonces individuel.
gads:detail_group_placementPublicités à la une
Résumé des performances de vos annonces non intelligentes sur la période analysée.
gads:ads_summary_tableAnnonces textuelles en vedette
Synthèse des performances de vos annonces, sur la période analysée.
gads:text_ads_summary_tablePerformance par ville
Ce tableau détaille la performance des annonces ciblées par différentes villes. Il vous permet d'évaluer la performance de vos campagnes dans des villes spécifiques, vous aidant à identifier quelles villes génèrent le plus de clics et de conversions.
gads:performance_by_cityPerformance par état
Ce tableau détaille la performance des annonces ciblées par différents états. Il vous permet d'évaluer la performance de vos campagnes dans des états spécifiques, vous aidant à identifier quels états génèrent le plus de clics et de conversions.
gads:performance_by_statePerformance par région
Ce tableau détaille la performance des annonces ciblées par différents états. Il vous permet d'évaluer la performance de vos campagnes dans des états spécifiques, vous aidant à identifier quels états génèrent le plus de clics et de conversions.
gads:performance_by_regionPerformance par aéroport
Ce tableau détaille la performance des annonces ciblées par différents aéroports. Il vous permet d'évaluer la performance de vos campagnes dans des aéroports spécifiques, vous aidant à identifier quels aéroports génèrent le plus de clics et de conversions.
gads:performance_by_airportPerformance par comté
Ce tableau détaille la performance des annonces ciblées par différents comtés. Il vous permet d'évaluer la performance de vos campagnes dans des comtés spécifiques, vous aidant à identifier quels comtés génèrent le plus de clics et de conversions.
gads:performance_by_countyPerformance par district
Ce tableau détaille la performance des annonces ciblées par différents districts. Il vous permet d'évaluer la performance de vos campagnes dans des districts spécifiques, vous aidant à identifier quels districts génèrent le plus de clics et de conversions.
gads:performance_by_districtPerformance par code postal
Ce tableau détaille la performance des annonces ciblées par différents codes postaux. Il vous permet d'évaluer la performance de vos campagnes dans des codes postaux spécifiques, vous aidant à identifier quels codes postaux génèrent le plus de clics et de conversions.
gads:performance_by_postal_codePerformance par région métropolitaine
Ce tableau détaille la performance des annonces ciblées par différentes régions métropolitaines. Il vous permet d'évaluer la performance de vos campagnes dans des régions métropolitaines spécifiques, vous aidant à identifier quelles régions génèrent le plus de clics et de conversions.
gads:performance_by_metroPerformance par pays
Ce tableau détaille la performance des annonces ciblées par différents pays. Il vous permet d'évaluer la performance de vos campagnes dans des pays spécifiques, vous aidant à identifier quels pays génèrent le plus de clics et de conversions.
gads:performance_by_countryPerformance par Groupe de Composants PMAX
Performance détaillée par Groupe de Composants
gads:pmax_asset_group_performancePerformance par Composant PMAX
Performance de chaque composant créatif
gads:pmax_asset_performancePerformance par Localisation PMAX
Performance par région géographique
gads:pmax_location_performance
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
