Тип отчета

В параметре ReportType укажите тип отчета. Тип отчета влияет на набор доступных полей и группировку данных.

Например, если выбран тип отчета SEARCH_QUERY_PERFORMANCE_REPORT, то данные в отчете будут сгруппированы по идентификатору группы AdGroupId и поисковому запросу Query. Обратите внимание, что добавление группировок данных не приводит к автоматическому добавлению соответствующих полей в отчет: отчет содержит только поля, явным образом перечисленные в параметре FieldNames.

Наиболее общий тип отчета — CUSTOM_REPORT. Он не добавляет никаких дополнительных группировок.

Типы отчетов представлены в таблице.

Тип отчета Описание Добавляется группировка данных Не допускаются поля
ACCOUNT_PERFORMANCE_REPORT Статистика по аккаунту рекламодателя См. раздел Допустимые поля
CAMPAIGN_PERFORMANCE_REPORT Статистика по кампаниям CampaignId См. раздел Допустимые поля
ADGROUP_PERFORMANCE_REPORT Статистика по группам объявлений AdGroupId См. раздел Допустимые поля
AD_PERFORMANCE_REPORT Статистика по объявлениям AdId AudienceTargetId, Criteria, CriteriaId, Criterion, CriterionId, DynamicTextAdTargetId, Keyword, Query, RlAdjustmentId, SmartAdTargetId
CRITERIA_PERFORMANCE_REPORT Статистика по условиям показа AdGroupId, CriteriaId, CriteriaType AdFormat, AdId, Placement, Query
CUSTOM_REPORT Статистика с произвольными группировками Query
REACH_AND_FREQUENCY_PERFORMANCE_REPORT

Статистика по медийным кампаниям.

Отчет содержит только данные по кампаниям с типом «Медийная кампания», кампании остальных типов игнорируются

В запросе на формирование отчета необходимо указать в поле FieldNames значение CampaignId См. раздел Допустимые поля
SEARCH_QUERY_PERFORMANCE_REPORT Статистика по поисковым запросам AdGroupId, Query См. раздел Допустимые поля
Тип отчета Описание Добавляется группировка данных Не допускаются поля
ACCOUNT_PERFORMANCE_REPORT Статистика по аккаунту рекламодателя См. раздел Допустимые поля
CAMPAIGN_PERFORMANCE_REPORT Статистика по кампаниям CampaignId См. раздел Допустимые поля
ADGROUP_PERFORMANCE_REPORT Статистика по группам объявлений AdGroupId См. раздел Допустимые поля
AD_PERFORMANCE_REPORT Статистика по объявлениям AdId AudienceTargetId, Criteria, CriteriaId, Criterion, CriterionId, DynamicTextAdTargetId, Keyword, Query, RlAdjustmentId, SmartAdTargetId
CRITERIA_PERFORMANCE_REPORT Статистика по условиям показа AdGroupId, CriteriaId, CriteriaType AdFormat, AdId, Placement, Query
CUSTOM_REPORT Статистика с произвольными группировками Query
REACH_AND_FREQUENCY_PERFORMANCE_REPORT

Статистика по медийным кампаниям.

Отчет содержит только данные по кампаниям с типом «Медийная кампания», кампании остальных типов игнорируются

В запросе на формирование отчета необходимо указать в поле FieldNames значение CampaignId См. раздел Допустимые поля
SEARCH_QUERY_PERFORMANCE_REPORT Статистика по поисковым запросам AdGroupId, Query См. раздел Допустимые поля
Примечание. Во всех типах отчетов применяется единичная атрибуция (single attribution): каждый показ и клик относится только к одному условию показа, региону, возрасту пользователя и т. д.