Ce guide met en correspondance les concepts et les conventions de dénomination 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.
Termes courants concernant l'interface utilisateur
Le tableau suivant récapitule certains des termes courants utilisés dans l'interface utilisateur et leur mappage 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 correspondent à 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 | La pagination divise l'ensemble de résultats de la requête en plusieurs pages. |
Colonnes
Les colonnes de l'interface utilisateur sont équivalentes aux champs de ressources, aux champs de segment et aux métriques dans GAQL.
Filtrage
Périodes
L'UI Google Ads comporte un tableau affichant les statistiques du compte et un menu déroulant permettant de contrôler la période de ces statistiques.
Vous disposez de la même commande en GAQL en filtrant sur segments.date dans la clause WHERE d'une requête GAQL.
Filtres
Les filtres de l'interface utilisateur sont équivalents à 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 afficher le nombre d'impressions spécifiques au Réseau de Recherche de Google séparément du Réseau Display de Google. Dans ce cas, vous devez segmenter votre rapport par chaîne. Consultez la section Segmentation pour savoir comment inclure des champs de segment dans la clause SELECT.
Pagination
Dans l'interface utilisateur, vous pouvez parcourir vos rapports à 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 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 de résultats complet sans pagination, utilisez GoogleAdsService.SearchStream.
Classer les résultats
Dans l'interface utilisateur, vous pouvez classer les résultats en sélectionnant une colonne.
En GAQL, vous pouvez utiliser les clauses ORDER BY et LIMIT pour trier 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'est pas compatible directement avec différents formats dans sa sortie. Vous devez donc effectuer un 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
La planification et l'envoi d'un rapport par e-mail sont disponibles dans l'UI, 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 de leur 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, 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 |
| 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 |
Comme indiqué dans le tableau ci-dessus, vous pouvez utiliser la requête GAQL suivante 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'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 reproduire 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"