Отчеты

Отчетность – это мощная функция, с помощью которой можно получить доступ ко всем отчетам по AdWords API. Запросы по отчетам создаются с помощью языка запросов AdWords. Возвращаемые значения представляют собой простые объекты JSON. Пример:

var report = AdWordsApp.report(
    "SELECT AdGroupId, Query, Ctr, Cost, Impressions " +
    "FROM   SEARCH_QUERY_PERFORMANCE_REPORT " +
    "WHERE  Impressions < 10 " +
    "DURING LAST_30_DAYS");

var rows = report.rows();
while (rows.hasNext()) {
    var row = rows.next();
    var query = row["Query"];
    var impressions = row["Impressions"];
}

Обратите внимание, что в отчетах не поддерживаются операторы ORDER BY и LIMIT. Результаты будут возвращены в произвольном порядке.

Подробнее об API читайте здесь. Пример использования скриптов для отчетов AdWords можно найти здесь.

Основные преимущества отчетов:

  • Статистика по многим параметрам, которые недоступны для обычных объектов AdWords (включая сегменты).
  • Возможность работать с большими объемами данных. Для отчетов нет ограничений – можно извлечь таблицу даже на миллион строк.
  • Эффективность. На скачивание отчета может потребоваться время, но поиск по нему выполняется мгновенно.

Версии API

Время от времени старые версии AdWords API прекращают работу и заменяются новыми. При этом могут исчезать отдельные поля или даже целые отчеты. В таких случаях в коде могут возникать неполадки. Чтобы избежать этого, указывайте, с какой версией API совместим код.

var report = AdWordsApp.report(query, {
    apiVersion: 'v201605'
});

Так можно избежать сбоев в работе кода после выпуска следующей версии.

Обратите внимание, что со временем поддержка версии v201605 будет прекращена. После этого скрипты, в которых указана эта версия, перестанут работать. Поэтому не рекомендуется злоупотреблять элементом apiVersion.

Оставить отзыв о...

Текущей странице
Скрипты AdWords
Скрипты AdWords