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

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

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

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

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

Столбцы

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

Фильтрация

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

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

Вы получаете тот же контроль в 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 Рекламы.

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

Базовые предопределенные отчеты Имя ресурса GAQL
(Укажите в предложении FROM )
Счет клиент
Кампания,
Подробности кампании
кампания
Группа объявлений,
Детали группы объявлений
группа_объявлений
Объявление,
Конечный URL
ad_group_ad
Ключевое слово поиска ключевое слово_просмотр
Условия поиска search_term_view
Платные и органические платный_organic_search_term_view
Целевая страница Landing_page_view
Расширенная целевая страница расширенная_landing_page_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"