В API Google Ads каждый отчет по критериям представлен отдельным ресурсом. Если не требуется иное, ресурсы *_view содержат только поле resource_name .
Клиенты Google Ads API должны указывать соответствующие поля ad_group_criterion или campaign_criterion если необходимо получить данные, специфичные для каких-либо критериев. Это позволяет клиентам Google Ads API запрашивать поля ad_group_criterion или campaign_criterion и ресурс *_view в одном запросе к методу GoogleAdsService.SearchStream .
Пример запроса
SELECT
ad_group_criterion.keyword.text,
ad_group.name,
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
Для получения данных о производительности (метрик) для определенного типа критериев укажите соответствующий ресурс представления в предложении FROM . Например, используйте keyword_view в предложении FROM и некоторые поля metrics в предложении SELECT для получения метрик по ключевым словам.
В представлении критериев можно выбирать поля из родительских ресурсов вплоть до customer . Например, при выборе FROM keyword_view можно запросить поля из всех следующих ресурсов:
-
ad_group_criterion -
ad_group -
campaign -
customer
Чтобы узнать, какие ресурсы можно запросить таким образом для данного ресурса, проверьте строку « Ресурсы атрибутов» на его справочной странице. Например, для keyword_view вы можете найти его ресурсы на его справочной странице .
Сопоставление с пользовательским интерфейсом
Каждый отчет по критериям соответствует определенному представлению в пользовательском интерфейсе Google Ads. Сопоставление этих данных поможет вам согласовать данные API с тем, что вы видите в интерфейсе. Полный список сопоставлений см. в разделе «Отчеты в пользовательском интерфейсе» .
Ниже приведены некоторые распространенные отчеты, основанные на критериях, и типичное расположение элементов в пользовательском интерфейсе:
- Кампании > Аудитории, ключевые слова и контент > Ключевые слова для поиска : Возвращает данные, эквивалентные
keyword_view. - Кампании > Аудитории, ключевые слова и контент > Аудитории > Демографические данные : Возвращает данные, эквивалентные данным из разделов
age_range_viewиgender_view. - Кампании > Местоположения : Возвращает данные, эквивалентные
location_view.