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 de votre compte, etc. L'infrastructure de reporting repose l'API Google Ads et utilise GAQL pour spécifier les champs, métriques et conditions à définir.

Rapport ou recherche

Il existe deux principaux mécanismes de signalement. Ils acceptent les mêmes types de requêtes, et diffèrent principalement par la façon dont elles 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 votre recherche, semblable à un dictionnaire résultats. Vous pouvez accéder aux champs comme à l'aide d'un dictionnaire, row["campaign.id"] et row["metrics.impressions"] directement. En utilisant cette vous pouvez exporter les résultats directement dans une feuille de calcul à l'aide du exportToSheet(). Il ne s'agit pas du format natif utilisé par les résultats renvoyées par l'API Google Ads. Par conséquent, il peut arriver que certains champs ne soient pas disponibles dans ce format. Dans ce cas, utilisez plutôt search.

AdsApp.search()

Une liste d'objets GoogleAdsRow contenant différents champs s'affiche. chacun d'entre eux pouvant avoir des sous-champs. Vous accédez donc à row.campaign.id et row.metrics.impressions pour récupérer les données. Ceci est généralement plus utile si vous prévoyez de traiter les données par programmation, et il est possible que certains champs ne soient disponibles au format search s'ils ne peuvent pas être convertis en représentation.

Remarque :Lorsque vous utilisez AdsApp.search, les champs renvoyés sont lowerCamelCase même s'ils sont spécifiés dans underscore_case dans le requête. Par exemple, si le champ de la requête est campaign.start_date, alors Pour récupérer le résultat de la ligne, utilisez campaign.startDate.

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 le 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 l'intégralité Adsapp.search pour tous les paramètres possibles.