Критерии Метрики

В 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 .