Rapports

Les rapports fournissent des informations sur toutes les ressources de votre compte. Vous pouvez obtenir des informations sur les campagnes, les groupes d'annonces et leurs statistiques, l'historique des modifications de votre compte, et plus encore. L'infrastructure de reporting est basée 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 ou recherche

Il existe deux mécanismes principaux pour les rapports. Ils acceptent tous deux les mêmes types de requêtes, mais diffèrent principalement dans la façon 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 directement aux champs comme si vous utilisiez un dictionnaire, par exemple row["campaign.id"] et row["metrics.impressions"]. En utilisant ce format, vous pouvez exporter directement les résultats 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, dans certains cas, certains champs peuvent ne pas être 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 accédez donc à row.campaign.id et row.metrics.impressions pour récupérer les données. Cette méthode est généralement plus utile si vous prévoyez de traiter les données par programmation. Certains champs ne sont disponibles au format search que s'ils ne peuvent pas être convertis en représentation plate.

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

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 AdsApp.report documentation pour obtenir des informations complètes 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 Adsapp.search pour connaître tous les paramètres possibles.