Les rapports fournissent des informations sur les différentes ressources de votre compte. Vous pouvez récupérer des informations sur les campagnes, les groupes d'annonces et leurs statistiques, l'historique des modifications de votre compte, etc. L'infrastructure de création de rapports repose sur l'API Google Ads et utilise GAQL pour spécifier les champs, les métriques et les conditions que vous souhaitez définir.
Rapport et recherche
Il existe deux principaux mécanismes de signalement. Ils acceptent tous deux les mêmes types de requêtes et diffèrent principalement dans la manière dont ils renvoient les résultats.
Dans les deux cas, nous utiliserons la requête suivante:
SELECT
campaign.id,
campaign.status,
metrics.clicks,
metrics.impressions,
customer.id
FROM campaign
WHERE
metrics.impressions > 0
AdsApp.report()
- Cela renverra une représentation plate, de type dictionnaire, de vos résultats de recherche. Vous pouvez accéder directement aux champs comme si vous utilisiez un dictionnaire, tels que
row["campaign.id"]
etrow["metrics.impressions"]
. Avec ce format, vous pouvez exporter les résultats directement dans une feuille de calcul à l'aide de la méthodeexportToSheet()
. Il ne s'agit pas du format natif dans lequel les résultats sont renvoyés par l'API Google Ads. Il peut donc arriver que certains champs ne soient pas disponibles dans ce format. Dans ce cas, utilisez plutôtsearch
. AdsApp.search()
- Cette opération renvoie une liste d'objets
GoogleAdsRow
, qui comportent différents champs, chacun pouvant avoir des sous-champs. Vous devez donc accéder àrow.campaign.id
etrow.metrics.impressions
pour récupérer les données. Cela est généralement plus utile si vous prévoyez de traiter les données de manière programmatique. Il est possible que certains champs ne soient disponibles au formatsearch
que s'ils ne peuvent pas être convertis en une représentation plate.
Exemple de rapport
let report = AdsApp.report(
"SELECT " +
" ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
"FROM search_term_view " +
"WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");
let rows = report.rows();
while (rows.hasNext()) {
let row = rows.next();
let query = row["search_term_view.search_term"];
let impressions = row["metrics.impressions"];
}
Consultez la documentation de AdsApp.report
pour en savoir plus sur l'utilisation de cette vue.
Exemple de recherche
let search = AdsApp.search(
"SELECT " +
" ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
"FROM search_term_view " +
"WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");
while (search.hasNext()) {
let row = search.next();
let query = row.searchTermView.searchTerm;
let impressions = row.metrics.impressions;
}
Consultez la documentation complète de Adsapp.search
pour connaître tous les paramètres possibles.