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