Rapports dans l'interface utilisateur

Ce guide met en correspondance les concepts et les conventions de dénomination des rapports de l'interface utilisateur 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.

Termes courants dans l'interface utilisateur

Le tableau suivant récapitule certains des termes courants utilisés dans l'interface utilisateur, ainsi que leurs mappages avec le langage de requête Google Ads (GAQL).

UI	GAQL
Colonnes	Toute ressource, tout champ de segment ou toute métrique dans la clause SELECT d'une requête GAQL.
Plage de dates	Les plages de dates sont mappées à une clause WHERE filtrant 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	Paging divise l'ensemble de résultats de la requête en plusieurs pages.

Colonne

Les colonnes de l'interface utilisateur correspondent aux champs de ressource, aux champs de segment et aux métriques dans GAQL.

Filtrage

Plages de dates

L'interface utilisateur de Google Ads contient un tableau affichant les statistiques du compte, ainsi qu'un menu déroulant permettant de contrôler leur période.

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'interface utilisateur correspondent à une ou plusieurs conditions de la clause WHERE de GAQL.

Segmentation

Pour obtenir des statistiques plus détaillées, vous pouvez répartir les données par segments. Par exemple, vous souhaitez peut-être consulter séparément le nombre d'impressions spécifiques au Réseau de Recherche de Google et au Réseau Display de Google. Dans ce cas, vous pouvez segmenter votre rapport par réseau. Consultez la section Segmentation pour découvrir comment inclure des champs de segment dans la clause SELECT.

Pagination

Pour parcourir vos rapports dans l'interface utilisateur, utilisez les commandes disponibles au bas de chaque table de données qui vous permettent de changer de page et de sélectionner le nombre de résultats à afficher à partir d'un ensemble de tailles défini.

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

Classer les résultats

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

Dans GAQL, vous pouvez utiliser les clauses ORDER BY et LIMIT pour classer 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 n'accepte pas directement différents formats de sortie. Vous devez donc effectuer un post-traitement. Consultez un exemple de code montrant comment mettre en œuvre 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 dans l'interface utilisateur, mais pas dans l'API.

Rapports prédéfinis

Vous pouvez créer une liste de rapports prédéfinis dans l'interface utilisateur Google Ads.

Voici une liste des rapports prédéfinis de base et du nom de ressource GAQL correspondant.

Rapports prédéfinis de base	Nom de la ressource GAQL (à spécifier dans la clause FROM)
Compte	clientèle
Campagne, Détails de 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
Liens commerciaux et résultats naturels	paid_organic_search_term_view
Page de destination	landing_page_view
URL étendue de la page de destination	expanded_landing_page_view

Dans le tableau ci-dessus, 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 aux rapports 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 répliquer une vue d'interface utilisateur par défaut, vous devez ajouter un filtre, généralement à l'aide d'un champ status, afin d'exclure les lignes supprimées, par exemple:

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"