В интерфейсе Google Рекламы есть функции для создания отчетов. Чтобы создать отчет, войдите в аккаунт Google Рекламы, в меню навигации слева нажмите Кампании, а затем – Статистика и отчеты. Чтобы создать отчет с нуля, нажмите Редактор отчетов.
В этом руководстве сопоставляются распространенные концепции отчетов и соглашения об именах в интерфейсе Google Рекламы с отчетами, которые можно создавать с помощью языка запросов Google Рекламы (GAQL) и Google Ads API. Вы также можете следовать подсказкам в интерфейсе, чтобы создать отчет, который наилучшим образом соответствует вашим требованиям.
Инструменты и ресурсы
Подробные примеры и автоматизированная справка по сопоставлению экранов интерфейса с API приведены в следующих ресурсах:
- Книга рецептов запросов. Набор запросов 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 запроса.
Фильтры
Фильтры в интерфейсе эквивалентны одному или нескольким условиям в предложении 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.
| Представления интерфейса | Название ресурса GAQL (указывается в предложении FROM) |
|---|---|
| Аккаунт | customer |
| Кампания, сведения о кампании |
кампания |
| Группа объявлений, Информация о группе объявлений |
ad_group |
| Группы объектов | asset_group |
|
Объявление, конечный URL |
ad_group_ad |
| Товары | shopping_performance_view, shopping_product |
| Ключевые слова для поисковой рекламы | keyword_view |
| Поисковые запросы | search_term_view, campaign_search_term_view |
| Платные и бесплатные (шаблон "Сравнительная видимость")* |
paid_organic_search_term_view |
| Целевая страница | landing_page_view |
| Развернутая целевая страница | expanded_landing_page_view |
| Контент > Места размещения | managed_placement_view |
| Контент > Где показывается ваша реклама | group_placement_view |
| Контент > Где показывалась реклама > Подробности | detail_placement_view |
| Кампании с максимальной эффективностью: места размещения | performance_max_placement_view |
| Контент > Темы | topic_view |
| Аудитории | ad_group_audience_view, campaign_audience_view |
| Аудитории > Демография > Возраст | age_range_view |
| Аудитории > Демография > Пол | gender_view |
| Местоположения | location_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'