Rapports dans l'interface utilisateur

Ce guide associe les concepts et les conventions de dénomination des rapports de l'interface utilisateur Google Ads aux 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 couramment utilisés dans l'interface utilisateur et leur mise en correspondance avec le langage de requête Google Ads (GAQL).

UI	GAQL
Colonnes	Toute ressource, tout champ de segment ou toute métrique figurant dans la clause SELECT d'une requête GAQL.
Plage de dates	Les plages de dates correspondent à une clause WHERE qui filtre 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 Google Ads contient un tableau affichant les statistiques du compte et un menu déroulant permettant de contrôler la période 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'interface utilisateur équivalent à une ou plusieurs conditions dans 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 pouvez souhaiter connaître le nombre d'impressions spécifiques au Réseau de Recherche de Google indépendamment de celui du Réseau Display de Google. Dans ce cas, vous devez segmenter votre rapport par réseau. Consultez la section Segmentation pour découvrir comment inclure des champs de segment dans la clause SELECT.

Pagination

Vous pouvez parcourir vos rapports dans l'interface utilisateur à l'aide des commandes disponibles au bas de chaque tableau de données. Elles vous permettent de changer de page et de sélectionner le nombre de résultats à afficher à partir d'un ensemble défini de tailles.

La pagination des résultats est disponible lors de la récupération de 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'interface utilisateur, les rapports peuvent être téléchargés dans différents formats, tels que CSV, TSV ou XML.

L'API n'accepte pas directement les différents formats dans sa sortie. Vous devez donc effectuer un post-traitement. Consultez un exemple de code montrant comment implémenter une mise en forme CSV dans un client.

Planification des rapports et envoi par e-mail

La planification et l'envoi par e-mail d'un rapport sont disponibles 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 la liste des rapports prédéfinis de base et du nom de ressource GAQL correspondant.

Rapports prédéfinis de base	Nom de ressource GAQL (à spécifier dans la clause FROM)
Compte	clientèle
Campagne, Détails de la campagne	campaign
Groupe d'annonces, Détails du 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

À titre d'exemple du 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'interface utilisateur aux rapports de l'API, l'une des différences les plus courantes est que l'interface utilisateur 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"