Отчеты в пользовательском интерфейсе Google Ads

В этом руководстве приведено сопоставление концепций и правил именования отчетов в пользовательском интерфейсе Google Ads с отчетами, которые можно создавать с помощью языка запросов Google Ads (GAQL) и API Google Ads.

Общие термины пользовательского интерфейса

В приведенной ниже таблице кратко изложены некоторые распространенные термины, используемые в пользовательском интерфейсе, и их соответствие языку запросов Google Ads (GAQL) .

UI	GAQL
Колонки	Любой ресурс, поле сегмента или метрика в предложении SELECT запроса GAQL.
Диапазон дат	Диапазоны дат сопоставляются с условием WHERE, фильтрующим по segments.date .
Фильтры	Одно или несколько условий в предложении WHERE .
Поля сегмента	Для сегментации добавьте поля сегментации в ваш GAQL-запрос.
Пагинация	Пагинация разбивает результирующий набор запроса на несколько страниц.

Колонки

В пользовательском интерфейсе столбцы эквивалентны полям ресурсов , полям сегментов и метрикам в GAQL.

Фильтрация

В отчетах вы можете фильтровать и систематизировать данные.

Диапазоны дат

В пользовательском интерфейсе Google Ads есть таблица со статистикой аккаунта и выпадающее меню для управления диапазоном дат, за которые отображается эта статистика.

Аналогичный контроль доступен и в GAQL, где можно использовать фильтр по segments.date в предложении WHERE запроса GAQL.

Фильтры

Фильтры в пользовательском интерфейсе эквивалентны одному или нескольким условиям в предложении WHERE запроса GAQL.

Сегментация

Для получения более подробной статистики разделите данные по сегментам. Например, предположим, вы хотите увидеть количество показов, относящихся к поисковой сети Google, отдельно от контекстно-медийной сети Google. В этом случае сегментируйте отчет по сетям. См. раздел «Сегментация» о том, как включить поля сегментов в предложение SELECT.

Пагинация

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

Постраничная навигация по результатам доступна при получении отчетов с помощью GoogleAdsService.Search через next_page_token . Чтобы получить весь набор результатов без постраничной навигации, используйте GoogleAdsService.SearchStream .

Результаты заказа

В пользовательском интерфейсе вы можете упорядочить результаты, выбрав столбец.

В GAQL для сортировки результатов запроса можно использовать предложения ORDER BY и LIMIT .

Форматы загрузки

В пользовательском интерфейсе отчеты можно загружать в различных форматах, таких как CSV, TSV или XML.

API напрямую не поддерживает различные форматы в выходных данных, поэтому вам потребуется выполнить некоторую постобработку. См. этот пример кода , демонстрирующий реализацию форматирования CSV на стороне клиента.

Составление расписания и отправка отчетов по электронной почте

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

Предварительно настроенные отчеты

В пользовательском интерфейсе Google Ads можно создать список предопределенных отчетов.

Ниже приведён список основных предопределённых отчётов и соответствующих им имён ресурсов GAQL.

Базовые предопределенные отчеты	Название ресурса GAQL (Укажите в предложении FROM )
Счет	клиент
Кампания, Подробности кампании	кампания
Рекламная группа, Подробная информация о группе объявлений	ad_group
Объявление, Итоговый URL	ad_group_ad
Поиск по ключевому слову	ключевое слово_просмотр
Поисковые запросы	поиск_термин_просмотр
Платные и органические	paid_organic_search_term_view
Целевая страница	landing_page_view
Расширенная целевая страница	расширенный_просмотр_целевой_страницы
Контент > Размещение	managed_placement_view
Контент > Где показывалась реклама	group_placement_view
Контент > Где показывалась реклама > Подробнее	детальное_размещение_вид

В качестве примера из приведенной выше таблицы, для генерации отчета по счетам можно использовать следующий GAQL-запрос:

SELECT
  customer.descriptive_name,
  customer.id,
  metrics.clicks,
  metrics.impressions,
  metrics.ctr,
  metrics.average_cpc,
  metrics.cost_micros,
  metrics.absolute_top_impression_percentage,
  metrics.top_impression_percentage,
  metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS

Общие различия

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

Для воспроизведения стандартного интерфейса пользователя необходимо добавить фильтр, обычно использующий поле status , чтобы исключить удаленные строки. Например:

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"