В этом руководстве сопоставляются концепции и соглашения об именовании отчетов в пользовательском интерфейсе 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 ) |
|---|---|
| Счет | клиент |
| Кампания, Подробности кампании | кампания |
| Группа объявлений, Детали группы объявлений | ad_group |
| Объявление, Конечный URL-адрес | ad_group_ad |
| Поиск по ключевому слову | ключевое слово_просмотр |
| Поисковые термины | поисковый_термин_просмотр |
| Платные и органические | просмотр_платного_органического_поискового_термина |
| Целевая страница | просмотр_страницы_посадки |
| Расширенная целевая страница | расширенный_просмотр_страницы_посадки |
В качестве примера из предыдущей таблицы вы можете использовать следующий 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"