В этом руководстве концепции и соглашения об именах отчетов в пользовательском интерфейсе Google Рекламы сопоставляются с отчетами, которые вы можете создавать с помощью языка запросов Google Рекламы (GAQL) и API Google Рекламы.
Общие термины пользовательского интерфейса
В следующей таблице приведены некоторые общие термины, используемые в пользовательском интерфейсе, и их сопоставление с языком запросов Google Рекламы (GAQL) .
| пользовательский интерфейс | GAQL |
|---|---|
| Столбцы | Любой ресурс, поле сегмента или показатель в предложении SELECT запроса GAQL. |
| Диапазон дат | Диапазоны дат сопоставляются с фильтрацией предложения WHERE по segments.date . |
| Фильтры | Одно или несколько условий в предложении WHERE . |
| Сегментировать поля | Примените сегментацию , включив поля сегментов в запрос GAQL. |
| Пагинация | Пейджинг разбивает набор результатов запроса на несколько страниц. |
Столбцы
Столбцы в пользовательском интерфейсе эквивалентны полям ресурсов , полям сегментов и показателям в 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 в клиенте .
Планирование и отправка отчетов по электронной почте
Планирование и отправка отчета по электронной почте доступно в пользовательском интерфейсе, но не поддерживается в API.
Предопределенные отчеты
Вы можете создать список предопределенных отчетов в пользовательском интерфейсе Google Рекламы.
Ниже приведен список основных предопределенных отчетов и соответствующих им названий ресурсов GAQL.
| Базовые предопределенные отчеты | Имя ресурса GAQL (Укажите в предложении FROM ) |
|---|---|
| Счет | клиент |
| Кампания, Подробности кампании | кампания |
| Группа объявлений, Детали группы объявлений | группа_объявлений |
| Объявление, Конечный URL | ad_group_ad |
| Ключевое слово поиска | ключевое слово_просмотр |
| Условия поиска | search_term_view |
| Платные и органические | платный_organic_search_term_view |
| Целевая страница | Landing_page_view |
| Расширенная целевая страница | расширенная_landing_page_view |
В качестве примера из таблицы выше вы можете использовать следующий 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"