The Google Ads UI provides reporting capabilities. To create a report, sign in to your Google Ads account, click Campaigns on the left navigation menu, and then click Insights and reports . To create a report from scratch, click Report editor .
This guide maps common reporting concepts and naming conventions in the Google Ads UI to reports that you can generate using Google Ads Query Language (GAQL) and the Google Ads API. You can also follow prompts in the UI to create the report that best suits your requirements.
Инструменты и ресурсы
Более подробные примеры и автоматизированную помощь по сопоставлению экранов пользовательского интерфейса с 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.
Для получения дополнительной информации см. раздел «Фильтрация данных о производительности» .
Сегментация
For more detailed statistics, split the data by segments. For example, suppose you want to see the number of impressions specific to the Google Search Network separately from the Google Display Network. In that case, segment your report by network. See Segmentation to learn how to include segment fields in the SELECT clause.
Пагинация
Navigate through your reports in the UI using the controls available at the bottom of each table of data that let you switch pages and select the number of results to display from a defined set of sizes.
Для постраничной навигации при получении отчетов используйте GoogleAdsService.Search с next_page_token . Для получения всего набора результатов без постраничной навигации используйте GoogleAdsService.SearchStream .
Результаты заказа
В пользовательском интерфейсе вы можете упорядочить результаты, выбрав столбец.
В GAQL вы можете использовать предложения ORDER BY и LIMIT для сортировки и ограничения результатов запроса.
Форматы загрузки
В пользовательском интерфейсе отчеты можно загружать в различных форматах, таких как CSV, TSV или XML.
The API doesn't directly format output into files such as CSV, so your client application must format the response. See the Campaign report to CSV code sample to learn how to implement CSV formatting in a client.
Составление расписания и отправка отчетов по электронной почте
Вы можете запланировать отправку отчета по электронной почте прямо из пользовательского интерфейса, но эти функции не поддерживаются в 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 на уровне клиента.
As an example from the preceding table, you can use the following GAQL query to generate an aggregated Account report over the last 7 days (add segments.date to the SELECT clause if you want metrics broken down by day):
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'