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"