Rapports dans l'UI Google Ads

L'UI Google Ads fournit des fonctionnalités de reporting. Pour créer un rapport, connectez-vous à votre compte Google Ads. Cliquez sur Campagnes à gauche, puis sur Insights et rapports. Pour créer un rapport à partir de zéro, cliquez sur Éditeur de rapports.

Ce guide met en correspondance les concepts et les conventions de dénomination courants des rapports dans l'UI Google Ads avec les rapports que vous pouvez générer à l'aide du langage de requête Google Ads (GAQL) et de l'API Google Ads. Vous pouvez également suivre les invites de l'UI pour créer le rapport qui répond le mieux à vos besoins.

Outils et ressources

Pour obtenir des exemples plus détaillés et une aide automatisée pour mapper les écrans de l'UI à l'API, consultez les ressources suivantes :

Termes courants de l'UI

Le tableau suivant récapitule certains des termes courants utilisés dans l'UI et leur correspondance avec le Google Ads Query Language (GAQL).

UI GAQL
Colonnes Toute ressource, tout champ de segment ou toute métrique dans la clause SELECT d'une requête GAQL.
Période Les plages de dates correspondent à une clause WHERE qui filtre les données sur segments.date.
Filtres Une ou plusieurs conditions dans la clause WHERE.
Champs de segment Appliquez la segmentation en incluant des champs de segment dans votre requête GAQL.
Pagination La pagination divise l'ensemble de résultats de la requête en plusieurs pages.

Colonnes

Les colonnes de l'UI sont équivalentes à l'utilisation d'une clause SELECT pour les champs de ressource, les champs de segment ou les métriques dans GAQL.

Consultez À propos des colonnes dans votre tableau de statistiques.

Périodes

L'UI Google Ads comporte un tableau affichant les statistiques du compte et un menu déroulant permettant de contrôler la plage de dates de ces statistiques.

Vous disposez du même contrôle dans GAQL en filtrant sur segments.date dans la clause WHERE d'une requête GAQL.

Filtres

Les filtres de l'UI sont équivalents à une ou plusieurs conditions dans la clause WHERE de GAQL.

Consultez Filtrer l'affichage des données sur les performances.

Segmentation

Pour obtenir des statistiques plus détaillées, segmentez les données. Par exemple, supposons que vous souhaitiez afficher le nombre d'impressions spécifiques au Réseau de Recherche de Google séparément de celles du Réseau Display de Google. Dans ce cas, segmentez votre rapport par réseau. Pour savoir comment inclure des champs de segment dans la clause SELECT, consultez Segmentation.

Pagination

Parcourez vos rapports dans l'UI à l'aide des commandes disponibles en bas de chaque tableau de données. Elles vous permettent de changer de page et de sélectionner le nombre de résultats à afficher parmi un ensemble de tailles définies.

La pagination des résultats est disponible lorsque vous récupérez des rapports avec GoogleAdsService.Search via next_page_token. Pour récupérer l'ensemble des résultats sans pagination, utilisez GoogleAdsService.SearchStream.

Classer les résultats

Dans l'UI, vous pouvez trier les résultats en sélectionnant une colonne.

Dans GAQL, vous pouvez utiliser la clause ORDER BY et la clause LIMIT pour trier les résultats de votre requête.

Formats de téléchargement

Dans l'UI, les rapports peuvent être téléchargés dans différents formats, tels que CSV, TSV ou XML.

L'API ne prend pas directement en charge différents formats dans sa sortie. Vous devez donc effectuer un post-traitement. Consultez cet exemple de code qui montre comment implémenter la mise en forme CSV dans un client.

Planification des rapports et envoi par e-mail

Vous pouvez planifier un rapport et l'envoyer par e-mail depuis l'UI, mais ces fonctionnalités ne sont pas compatibles avec l'API.

Associer les vues de l'UI Maps aux ressources d'API

Voici une liste des vues d'interface utilisateur courantes et du nom de ressource GAQL correspondant.

Vues de l'UI Nom de ressource GAQL
(à spécifier dans la clause FROM)
Compte clientèle
Campagne,
Informations sur la campagne		 campaign
Groupe d'annonces,
Informations sur le groupe d'annonces		 ad_group
Annonce,
URL finale		 ad_group_ad
Mot clé pour le Réseau de Recherche keyword_view
Termes de recherche search_term_view
Payant et naturel
(modèle "Visibilité par rapport aux concurrents")*		 paid_organic_search_term_view
Page de destination landing_page_view
URL étendue de la page de destination expanded_landing_page_view
Contenu > Emplacements managed_placement_view
Contenu > Où les annonces ont été diffusées group_placement_view
Contenu > Où les annonces ont été diffusées > Afficher les détails detail_placement_view
Audiences > Données démographiques > Âge age_range_view
Audiences > Données démographiques > Genre gender_view
Zones location_view
Contenu > Thèmes topic_view
Zones géographiques > Rapport géographique geographic_view

* Pour générer le rapport Recherche sponsorisée et naturelle, vous devez associer un compte Google Search Console à votre compte Google Ads au niveau client.

Par exemple, vous pouvez utiliser le GAQL suivant pour générer le rapport sur le compte :

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

Différences courantes

Lorsque vous comparez les rapports de l'UI à ceux de l'API, l'une des différences les plus courantes est que l'UI filtre implicitement les entités supprimées, contrairement à l'API.

Pour reproduire une vue d'UI par défaut, vous devez ajouter un filtre, généralement à l'aide d'un champ status, pour exclure les lignes supprimées. Exemple :

SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'
Précédent
Pagination
Suivant
Mettre en correspondance les paramètres ValueTrack avec les champs de rapport