Rapports

Les rapports fournissent des informations sur toutes 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 reporting est basée sur l'API Google Ads et utilise le GAQL pour spécifier les champs, les métriques et les conditions que vous souhaitez définir.

Il existe deux principaux mécanismes de signalement. Ils acceptent tous deux les mêmes types de requêtes et diffèrent principalement par 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()
Cette opération renvoie une représentation plate de vos résultats de recherche, semblable à un dictionnaire. Vous pouvez accéder aux champs comme si vous utilisiez un dictionnaire, par exemple row["campaign.id"] et row["metrics.impressions"] directement. Ce format vous permet d'exporter les résultats directement vers une feuille de calcul à l'aide de la méthode exportToSheet(). Il ne s'agit pas du format par défaut dans lequel les résultats sont renvoyés par l'API Google Ads. Par conséquent, il est possible que certains champs ne soient pas disponibles dans ce format. Si tel est le cas, vous devez utiliser search à la place.
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 et row.metrics.impressions pour récupérer les données. Cette option est généralement plus utile si vous prévoyez de traiter les données de manière programmatique. Certains champs ne sont disponibles qu'au format search s'ils ne peuvent pas être convertis en 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"];
}

Pour en savoir plus sur l'utilisation de cette vue, consultez la documentation sur AdsApp.report.

Exemple pour le Réseau 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 sur Adsapp.search pour connaître tous les paramètres possibles.