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"