L'UI Google Ads fournit des fonctionnalités de reporting. Pour créer un rapport, connectez-vous à votre compte Google Ads, cliquez sur Campagnes dans le menu de navigation de gauche, puis sur Insights et rapports. Pour créer un rapport à partir de zéro, cliquez sur Éditeur de rapports.
Ce guide met en correspondance les concepts de reporting et les conventions d'attribution de noms courants 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. Vous pouvez également suivre les instructions de l'interface utilisateur pour créer le rapport qui correspond le mieux à vos besoins.
Outils et ressources
Pour obtenir des exemples plus détaillés et une aide automatisée pour mapper les écrans de l'interface utilisateur à l'API, consultez les ressources suivantes :
- Livre de recettes de requêtes : collection de requêtes GAQL qui répliquent les données trouvées sur de nombreux écrans courants de l'interface utilisateur de Google Ads.
- Extension de reporting de l'API Google Ads : extension Chrome qui vous aide à identifier les noms des ressources et des champs de l'API directement dans l'interface utilisateur de Google Ads.
Termes courants de l'interface utilisateur
Le tableau suivant récapitule certains des termes courants utilisés dans l'interface utilisateur et leurs correspondances avec le langage de requête Google Ads (GAQL).
| UI | GAQL |
|---|---|
| Colonnes | Toute ressource, tout champ de segment ou toute métrique de 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 | La pagination divise l'ensemble de résultats de la requête en plusieurs pages. |
Colonnes
Les colonnes de l'UI équivalent à l'utilisation d'une clause SELECT pour les champs de ressource, les champs de segment ou les métriques dans GAQL.
Pour en savoir plus, consultez À propos des colonnes dans votre tableau de statistiques.
Périodes
L'interface utilisateur de Google Ads comporte un tableau affichant les statistiques du compte et un menu déroulant permettant de contrôler la plage de dates 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 de la clause WHERE de GAQL.
Pour en savoir plus, consultez Filtrer l'affichage des données de performances.
Segmentation
Pour obtenir des statistiques plus détaillées, divisez les données par segments. Par exemple, supposons que vous souhaitiez voir le nombre d'impressions spécifiques au Réseau de Recherche de Google séparément de celles du Réseau Display de Google. Dans ce cas, segmentez votre rapport par réseau. Consultez Segmentation pour savoir comment inclure des champs de segment dans la clause SELECT.
Pagination
Parcourez 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 parmi un ensemble de tailles définies.
Pour parcourir les résultats lors de la récupération des rapports, utilisez GoogleAdsService.Search avec 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 les clauses ORDER BY et LIMIT pour trier et limiter 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 ne formate pas directement la sortie dans des fichiers tels que CSV. Votre application cliente doit donc formater la réponse. Consultez l'exemple de code de rapport de campagne au format CSV pour savoir comment implémenter la mise en forme CSV dans un client.
Planification des rapports et envoi par e-mail
Vous pouvez planifier et envoyer un rapport par e-mail depuis l'UI, mais ces fonctionnalités ne sont pas disponibles dans l'API.
Mapper les vues de l'UI avec les ressources d'API
Voici une liste des vues d'interface utilisateur courantes et du nom de ressource GAQL correspondant.
| Vues de l'UI | 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 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 |
| Résultats sponsorisés et naturels (modèle de visibilité par rapport aux concurrents)* |
paid_organic_search_term_view |
| Page de destination | landing_page_view |
| URL étendue de la page de destination | expanded_landing_page_view |
| Contenu > Emplacements | managed_placement_view |
| Contenu > Où les annonces ont été diffusées | group_placement_view |
| Contenu > Où les annonces ont été diffusées > Afficher les détails | detail_placement_view |
| Audiences > Données démographiques > Âge | age_range_view |
| Audiences > Données démographiques > Genre | gender_view |
| Zones | location_view |
| Contenu > Thèmes | topic_view |
| Zones géographiques > Rapport géographique | geographic_view |
* Pour générer le rapport Recherche naturelle et sponsorisée, vous devez associer un compte Google Search Console à votre compte Google Ads au niveau du client.
Comme illustré dans le tableau précédent, vous pouvez utiliser la requête GAQL suivante pour générer un rapport agrégé sur le compte pour les sept derniers jours (ajoutez segments.date à la clause SELECT si vous souhaitez obtenir des métriques par jour) :
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 à ceux 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, ajoutez un filtre à l'aide d'un champ status pour exclure les lignes supprimées (ou inclure explicitement les entités ENABLED et PAUSED). Exemple :
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'