Отчеты в интерфейсе Google Рекламы

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

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

Инструменты и ресурсы

Дополнительные примеры и автоматизированная справка по сопоставлению экранов интерфейса с API приведены в следующих ресурсах:

• Книга рецептов запросов. Набор запросов GAQL, которые позволяют получить данные, представленные на многих распространенных экранах интерфейса Google Рекламы.
• Расширение для отчетов Google Ads API. Расширение Chrome, которое помогает находить названия ресурсов и полей API прямо в интерфейсе Google Рекламы.

Стандартные термины интерфейса

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

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

Столбцы

Столбцы в интерфейсе эквивалентны использованию предложения SELECT для полей ресурсов, полей сегментов или показателей в 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, поэтому ваше клиентское приложение должно форматировать ответ. Чтобы узнать, как реализовать форматирование CSV в клиенте, ознакомьтесь с примером кода для экспорта отчета о кампании в CSV-файл.

Планирование отчетов и их отправка по электронной почте

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

Сопоставление представлений интерфейса с ресурсами API

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

Объекты View в интерфейсах	Название ресурса GAQL (указывается в предложении FROM)
Аккаунт	клиент
Кампания, Информация о кампании	кампания
Группа объявлений Информация о группе объявлений	ad_group
Объявление, конечный URL	ad_group_ad
Ключевые слова для поисковой рекламы	keyword_view
Поисковые запросы	search_term_view
Платные и бесплатные (шаблон "Сравнительная видимость")^*	paid_organic_search_term_view
Целевая страница	landing_page_view
Развернутая целевая страница	expanded_landing_page_view
Контент > Места размещения	managed_placement_view
Контент > Где показывается ваша реклама	group_placement_view
Контент > Где показывается ваша реклама > Посмотреть подробности	detail_placement_view
Аудитории > Демография > Возраст	age_range_view
Аудитории > Демография > Пол	gender_view
Местоположения	location_view
Контент > Темы	topic_view
Местоположения > Географический отчет	geographic_view

^* Чтобы создать отчет Платный и обычный поиск, необходимо связать аккаунт Google Search Console с аккаунтом Google Рекламы на уровне клиента.

Например, чтобы создать агрегированный отчет об аккаунте за последние семь дней, можно использовать следующий запрос GAQL (если вы хотите разбить показатели по дням, добавьте segments.date в предложение SELECT):

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, чтобы исключить удаленные строки (или явно включить объекты ENABLED и PAUSED). Пример:

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