Rapports dans l'interface utilisateur

Ce guide présente les concepts et les conventions d'attribution de noms pour les rapports dans l'interface utilisateur Google Ads. aux rapports que vous pouvez générer à l'aide du langage de requête Google Ads (GAQL) et 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, ainsi que leurs avec le langage GAQL (Google Ads Query Language).

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 avec la clause WHERE filtre sur segments.date.
Filtres	Une ou plusieurs conditions dans la clause WHERE.
Champs de segment	Appliquer la segmentation en incluant des champs de segment dans votre requête GAQL.
Pagination	Paging divise l'ensemble de résultats des la requête en plusieurs pages.

Colonnes

Les colonnes de l'interface utilisateur correspondent à la fonction Ressource champs, Segment Métriques dans GAQL.

Filtrage

Périodes

L'interface utilisateur Google Ads contient un tableau affichant les statistiques du compte et un menu déroulant pour 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 requête.

Filtres

Les filtres de l'interface utilisateur correspondent à 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 souhaitez peut-être connaître le nombre d'impressions Le Réseau de Recherche de Google séparément du Réseau Display de Google Dans ce cas, vous devez segmenter votre rapport par réseau. Voir Segmentation indiquant comment inclure les champs de segment dans la clause SELECT.

Pagination

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

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 des résultats 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 la clause ORDER BY et LIMIT pour classer les résultats de votre requête.

Formats de téléchargement

Dans l'interface utilisateur, vous pouvez télécharger les rapports dans différents formats, tels que CSV, TSV ou XML.

L'API n'étant pas directement compatible avec différents formats en sortie, vous devez sans aucun post-traitement. Consultez un exemple de code montrant 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 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 des ressources GAQL correspondantes Nom.

Rapports prédéfinis de base	Nom de la ressource GAQL (Spécifiez dans la clause FROM.)
Compte	clientèle
Campagne, Détails de la campagne	campaign
Groupe d'annonces, Informations sur les groupes 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 "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'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, pour exclure les lignes supprimées, par exemple:

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