Интерфейс Google Ads предоставляет возможности для создания отчетов. Чтобы создать отчет, войдите в свою учетную запись Google Ads. Нажмите «Кампании» слева, а затем — «Аналитика и отчеты» . Чтобы создать отчет с нуля, нажмите «Редактор отчетов» .
В этом руководстве приведено сопоставление распространенных концепций создания отчетов и соглашений об именовании в пользовательском интерфейсе Google Ads с отчетами, которые можно создавать с помощью языка запросов Google Ads (GAQL) и API Google Ads. Вы также можете следовать подсказкам в пользовательском интерфейсе, чтобы создать отчет, который наилучшим образом соответствует вашим требованиям.
Инструменты и ресурсы
Более подробные примеры и автоматизированную помощь по сопоставлению экранов пользовательского интерфейса с API см. в следующих ресурсах:
- Query Cookbook : Набор GAQL-запросов, воспроизводящих данные, отображаемые на многих распространенных экранах пользовательского интерфейса Google Ads.
- Расширение Google Ads API Reporting : расширение для Chrome, которое помогает определять имена ресурсов и полей API непосредственно в пользовательском интерфейсе Google Ads.
Общие термины пользовательского интерфейса
В приведенной ниже таблице кратко изложены некоторые распространенные термины, используемые в пользовательском интерфейсе, и их соответствие языку запросов Google Ads (GAQL) .
| UI | GAQL |
|---|---|
| Колонки | Любой ресурс, поле сегмента или метрика в предложении SELECT запроса GAQL. |
| Диапазон дат | Диапазоны дат сопоставляются с условием WHERE, фильтрующим по segments.date . |
| Фильтры | Одно или несколько условий в предложении WHERE . |
| Поля сегмента | Для сегментации добавьте поля сегментации в ваш GAQL-запрос. |
| Пагинация | Пагинация разбивает результирующий набор запроса на несколько страниц. |
Колонки
Использование столбцов в пользовательском интерфейсе эквивалентно использованию предложения SELECT для полей ресурсов , полей сегментов или метрик в 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.
Сопоставление элементов пользовательского интерфейса с ресурсами API.
Вот список распространенных элементов пользовательского интерфейса и соответствующие им имена ресурсов GAQL.
| Представления пользовательского интерфейса | Название ресурса GAQL (Укажите в предложении FROM ) |
|---|---|
| Счет | клиент |
| Кампания, Подробности кампании | кампания |
| Рекламная группа, Подробная информация о группе объявлений | ad_group |
| Объявление, Итоговый URL | ad_group_ad |
| Поиск по ключевому слову | ключевое слово_просмотр |
| Поисковые запросы | поиск_термин_просмотр |
| Платные и органические (Шаблон для повышения конкурентной видимости) * | paid_organic_search_term_view |
| Целевая страница | landing_page_view |
| Расширенная целевая страница | расширенный_просмотр_целевой_страницы |
| Контент > Размещение | managed_placement_view |
| Контент > Где показывалась реклама | group_placement_view |
| Контент > Где показывалась реклама > Подробнее | детальное_размещение_вид |
| Аудитория > Демографические данные > Возраст | возрастной_диапазон_просмотр |
| Целевая аудитория > Демографические данные > Гендер | гендерный_просмотр |
| Места расположения | location_view |
| Содержание > Темы | topic_view |
| Местоположение > Географический отчет | географический_вид |
* Для создания отчета по платной и органической рекламе необходимо связать аккаунт Google Search Console с вашим аккаунтом Google Ads на уровне клиента.
В качестве примера из приведенной выше таблицы, для генерации отчета по счетам можно использовать следующий 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'