В интерфейсе Google Рекламы есть функции для создания отчетов. Чтобы создать отчет, войдите в аккаунт Google Рекламы, в меню навигации слева нажмите Кампании, а затем – Статистика и отчеты. Чтобы создать отчет с нуля, нажмите Редактор отчетов.
В этом руководстве сопоставляются распространенные концепции отчетов и соглашения об именах в интерфейсе Google Рекламы с отчетами, которые можно создавать с помощью языка запросов Google Рекламы (GAQL) и Google Ads API. Вы также можете следовать подсказкам в интерфейсе, чтобы создать отчет, который лучше всего соответствует вашим требованиям.
Инструменты и ресурсы
Дополнительные примеры и автоматизированная справка по сопоставлению экранов интерфейса с API доступны в следующих ресурсах:
- Query Cookbook – набор запросов GAQL, которые позволяют получить данные, представленные на многих распространенных экранах интерфейса Google Рекламы.
- Расширение Google Ads API Reporting. Расширение Chrome, которое помогает находить названия ресурсов и полей API прямо в интерфейсе Google Рекламы.
Общие термины, связанные с интерфейсом
В таблице ниже приведены некоторые распространенные термины, используемые в интерфейсе, и их сопоставления с языком запросов Google Рекламы (GAQL).
| Интерфейс | GAQL |
|---|---|
| Столбцы | Любой ресурс, поле сегмента или показатель в предложении SELECT запроса GAQL. |
| Диапазон дат | Диапазоны дат сопоставляются с предложением WHERE, которое фильтрует данные по полю segments.date. |
| Фильтры | Одно или несколько условий в предложении WHERE. |
| Поля сегментов | Примените сегментацию, включив поля сегментов в запрос GAQL. |
| Разбивка на страницы | Разбивка на страницы позволяет разделить результаты запроса на несколько страниц. |
Столбцы
Столбцы в интерфейсе эквивалентны использованию предложения SELECT для полей ресурсов, полей сегментов или показателей в GAQL.
Подробнее о столбцах в таблице статистики…
Диапазоны дат
В интерфейсе Google Рекламы есть таблица со статистикой аккаунта и раскрывающееся меню, в котором можно выбрать диапазон дат для этой статистики.
В GAQL вы можете сделать то же самое, отфильтровав segments.date в условии WHERE запроса GAQL.
Фильтры
Фильтры в интерфейсе эквивалентны одному или нескольким условиям в предложении WHERE GAQL.
Подробнее о фильтрации данных об эффективности…
Сегментирование
Чтобы получить более подробную статистику, разбейте данные по сегментам. Например, вы хотите посмотреть количество показов в поисковой сети 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'