Показатели критериев

В Google Ads API каждый отчет о критериях представлен отдельным ресурсом. Если нет других требований, ресурсы *_view содержат только поле resource_name.

Клиенты Google Ads API должны указать соответствующие поля ad_group_criterion или campaign_criterion, если необходимо получить данные, относящиеся к определенным критериям. Каждое представление связано с ресурсом критерия, который соответствует его уровню таргетинга (например, keyword_view связано с ad_group_criterion, а location_view – с 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

Чтобы узнать, какие ресурсы можно запрашивать таким образом, посмотрите строку Attributed resources (Связанные ресурсы) на странице справки. Например, ресурсы для keyword_view можно найти на справочной странице.

Сопоставление с интерфейсом

Каждый отчет о критериях соответствует определенному представлению в интерфейсе Google Рекламы. Сопоставление этих данных поможет вам согласовать данные API с тем, что вы видите в интерфейсе. Более полный список сопоставлений приведен в статье Отчеты в интерфейсе.

Ниже приведены некоторые распространенные отчеты на основе критериев и их типичное расположение в интерфейсе.

• Кампании > Аудитории, ключевые слова и контент > Ключевые слова для поисковой рекламы – возвращает данные, эквивалентные keyword_view.
• Кампании > Аудитории, ключевые слова и контент > Аудитории > Демография: возвращает данные, эквивалентные age_range_view и gender_view.
• Кампании > Местоположения: возвращает данные, эквивалентные location_view.