L'interface utilisateur Google Ads propose des fonctionnalités de reporting. Pour créer un rapport, connectez-vous à votre compte Google Ads. Cliquez sur Campagnes à gauche, puis sur Insights et rapports. Pour créer un rapport de A à Z, cliquez sur Éditeur de rapports.
Ce guide met en correspondance les concepts de reporting et les conventions d'attribution de noms courants dans 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 invites de l'interface utilisateur pour créer le rapport qui répond le mieux à vos besoins.
Outils et ressources
Pour obtenir des exemples plus détaillés et une aide automatisée pour mettre en correspondance les écrans de l'interface utilisateur avec l'API, consultez les ressources suivantes :
- Recueil de requêtes : ensemble de requêtes GAQL qui reproduisent les données affichées sur de nombreux écrans courants de l'interface utilisateur 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 Google Ads.
Termes courants de l'interface utilisateur
Le tableau suivant récapitule certains des termes courants utilisés dans l'interface utilisateur et leur correspondance 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. |
| Période | Les périodes 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 équivalent à l'utilisation d'une clause SELECT pour les champs de ressource, les champs de segment, ou les métriques dans GAQL.
Consultez À propos des colonnes dans votre tableau de statistiques.
Périodes
L'interface utilisateur 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 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 dans la clause WHERE de GAQL.
Consultez Filtrer l'affichage des données sur les performances.
Segmentation
Pour obtenir des statistiques plus détaillées, divisez les données par segments. Supposons, par exemple, que vous souhaitiez 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, 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 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 à 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 via
next_page_token. Pour récupérer l'ensemble complet de résultats
sans pagination, utilisez
GoogleAdsService.SearchStream.
Classer les résultats
Dans l'interface utilisateur, vous pouvez classer 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'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 directement compatible avec différents formats dans son résultat. Vous devez donc effectuer un post-traitement. Consultez cet exemple de code qui montre comment implémenter le formatage CSV dans un client.
Planification des rapports et envoi par e-mail
Vous pouvez planifier un rapport et l'envoyer par e-mail depuis l'interface utilisateur, mais ces fonctionnalités ne sont pas compatibles avec l'API.
Mettre en correspondance les vues de l'interface utilisateur avec les ressources de l'API
Voici une liste des vues courantes de l'interface utilisateur et de leur nom de ressource GAQL correspondant.
| Vues de l'interface utilisateur | Nom de ressource GAQL (à spécifier dans la clause FROM) |
|---|---|
| Compte | clientèle |
| Campagne, Informations sur les campagnes |
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 |
| Recherche naturelle et sponsorisée (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 > 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.
Par exemple, à partir du tableau précédent, 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 des rapports de l'interface utilisateur à des rapports de l'API, l'une des différences les plus courantes est que l'interface utilisateur filtre implicitement les entités supprimées, contrairement à l'API.
Pour reproduire une vue par défaut de l'interface utilisateur, vous devez ajouter un filtre, généralement à l'aide d'un champ status, afin d'exclure les lignes supprimées. Exemple :
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'