--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/type.md - https://yandex.com/dev/direct/doc/ru/type.md - href: ru/type.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt sourcePath: ru/reports/type.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt # Тип отчета В параметре [ReportType](*ReportType) укажите тип отчета. Тип отчета влияет на набор доступных полей и группировку данных. Например, если выбран тип отчета SEARCH_QUERY_PERFORMANCE_REPORT, то данные в отчете будут сгруппированы по идентификатору группы `AdGroupId` и поисковому запросу `Query`. Обратите внимание, что добавление группировок данных не приводит к автоматическому добавлению соответствующих полей в отчет: отчет содержит только поля, явным образом перечисленные в параметре [FieldNames](*FieldNames). Наиболее общий тип отчета — CUSTOM_REPORT. Он не добавляет никаких дополнительных группировок. Типы отчетов представлены в таблице. #| || **Тип отчета** | **Описание** | **Добавляется группировка данных** | **Не допускаются поля** || || ACCOUNT_PERFORMANCE_REPORT | Статистика по аккаунту пользователя | – | См. раздел [Допустимые поля](https://yandex.com/dev/direct/doc/ru/fields-list.md) || || CAMPAIGN_PERFORMANCE_REPORT | Статистика по кампаниям | [CampaignId](*CampaignId) | См. раздел [Допустимые поля](https://yandex.com/dev/direct/doc/ru/fields-list.md) || || ADGROUP_PERFORMANCE_REPORT | Статистика по группам объявлений | [AdGroupId](*AdGroupId) | См. раздел [Допустимые поля](https://yandex.com/dev/direct/doc/ru/fields-list.md) || || AD_PERFORMANCE_REPORT | Статистика по объявлениям | [AdId](*AdId) | [AudienceTargetId](*AudienceTargetId), [Criteria](*Criteria), [CriteriaId](*CriteriaId), [Criterion](*Criterion), [CriterionId](*CriterionId), [DynamicTextAdTargetId](*DynamicTextAdTargetId), [Keyword](*Keyword), [Query](*Query), [RlAdjustmentId](*RlAdjustmentId), [SmartAdTargetId](*SmartAdTargetId) || || CRITERIA_PERFORMANCE_REPORT | Статистика по условиям показа | [AdGroupId](*AdGroupId), [CriteriaId](*CriteriaId), [CriteriaType](*CriteriaType) | [AdFormat](*AdFormat), [AdId](*AdId), [Query](*Query) || || CUSTOM_REPORT | Статистика с произвольными группировками | – | [Query](*Query) || || REACH_AND_FREQUENCY_PERFORMANCE_REPORT | Статистика по медийным кампаниям. Отчет содержит только данные по кампаниям с типом «Медийная кампания», кампании остальных типов игнорируются | В запросе на формирование отчета необходимо указать в поле [FieldNames](*FieldNames) значение `CampaignId` | См. раздел [Допустимые поля](https://yandex.com/dev/direct/doc/ru/fields-list.md) || || SEARCH_QUERY_PERFORMANCE_REPORT | Статистика по поисковым запросам | [AdGroupId](*AdGroupId), [Query](*Query) | См. раздел [Допустимые поля](https://yandex.com/dev/direct/doc/ru/fields-list.md) || |# {% note info %} Во всех типах отчетов применяется единичная атрибуция (single attribution): каждый показ и клик относится только к одному условию показа, региону, возрасту пользователя и т. д. {% endnote %} [*ReportType]: Тип отчета.
**Обязательный** Да [*FieldNames]: Имена полей (столбцов), которые будут присутствовать в отчете. Какие поля можно указывать, см. в разделах [Допустимые поля](https://yandex.com/dev/direct/doc/ru/fields-list.md), [Несовместимые поля и зависимости](https://yandex.com/dev/direct/doc/ru/compatibility.md). Для типа отчета REACH_AND_FREQUENCY_PERFORMANCE_REPORT поле CampaignId обязательно.
**Обязательный** Да [*CampaignId]: Идентификатор кампании [*AdGroupId]: Идентификатор группы объявлений. Не отображается в отчете по кампаниям, созданным в Мастере кампаний. [*AdId]: Идентификатор объявления. Не отображается в отчете по кампаниям, созданным в Мастере кампаний. [*AudienceTargetId]: Идентификатор условия нацеливания на аудиторию. См. раздел [Условие нацеливания на аудиторию (AudienceTarget)](https://yandex.ru/dev/direct/doc/dg/objects/audience-target.html). [*Criteria]: Название или текст условия показа: - Для показа по ключевой фразе или синониму — фраза с идентификатором. - Для показа по автотаргетингу — значение «---autotargeting». - Для показа по дополнительной релевантной фразе: - пустое значение, если тип отчета — CUSTOM_REPORT; - текст дополнительной релевантной фразы, если тип отчета — SEARCH_QUERY_PERFORMANCE_REPORT. - Для показа по условию нацеливания на аудиторию — название условия ретаргетинга и подбора аудитории или название интереса к категории мобильных приложений. - Для показа динамического объявления — название условия нацеливания для динамических объявлений или название фильтра. - Для показа смарт-баннера — название фильтра.
Неявно происходит группировка по `CriteriaId`. [*CriteriaId]: Идентификатор условия показа: - Для показа по ключевой фразе или синониму — идентификатор фразы. - Для показа по автотаргетингу — идентификатор автотаргетинга. - Для показа по дополнительной релевантной фразе — прочерк. - Для показа по условию нацеливания на аудиторию — идентификатор условия нацеливания на аудиторию. - Для показа динамического объявления — идентификатор условия нацеливания для динамических объявлений или идентификатор фильтра. - Для показа смарт-баннера — идентификатор фильтра.
Не отображается в отчете по кампаниям, созданным в Мастере кампаний. [*Criterion]: Название или текст условия показа, заданного пользователем: - Для показа по ключевой фразе или синониму — фраза с идентификатором. - Для показа по [дополнительной релевантной фразе](https://yandex.ru/support/direct/keywords/related-keywords.html) — текст ключевой фразы, а в случае если ключевую фразу определить не удалось — значение «Автоматически добавленная фраза». - Для показа по автотаргетингу — значение «---autotargeting». - Для показа по условию нацеливания на аудиторию — название условия ретаргетинга и подбора аудитории или название интереса к категории мобильных приложений. - Для показа динамического объявления — название условия нацеливания для динамических объявлений или название фильтра. - Для показа смарт-баннера — название фильтра.
Неявно происходит группировка по `CriterionId`. Рекомендуется использовать данное поле вместо поля `Criteria`. [*CriterionId]: Идентификатор условия показа, заданного пользователем: - Для показа по ключевой фразе или синониму — идентификатор ключевой фразы. - Для показа по дополнительной релевантной фразе — идентификатор ключевой фразы, а в случае если ключевую фразу определить не удалось — прочерк. - Для показа по автотаргетингу — идентификатор автотаргетинга. - Для показа по условию нацеливания на аудиторию (как по условию ретаргетинга и подбора аудитории, так и по интересу к категории мобильных приложений) — идентификатор условия нацеливания на аудиторию, а в случае если условие удалено — прочерк. - Для показа по условию нацеливания для динамических объявлений, генерируемых на основе страниц сайта, — идентификатор условия нацеливания для динамических объявлений. - Для показа по фильтру для динамических объявлений, генерируемых на основе фида, или по фильтру для смарт-баннеров — идентификатор фильтра.
Рекомендуется использовать данное поле вместо поля `CriteriaId`. Не отображается в отчете по кампаниям, созданным в Мастере кампаний. [*DynamicTextAdTargetId]: Идентификатор условия нацеливания для динамических объявлений или идентификатор фильтра для динамических объявлений. См. раздел [Условие нацеливания для динамических объявлений (DynamicTextAdTarget — Webpage)](https://yandex.ru/dev/direct/doc/dg/objects/dynamictextadtarget.html). [*Keyword]: Текст ключевой фразы. [*Query]: Поисковый запрос, по которому было показано объявление. [*RlAdjustmentId]: Идентификатор условия ретаргетинга и подбора аудитории, в соответствии с которым применена корректировка ставок для целевой аудитории. [*SmartAdTargetId]: Идентификатор фильтра для смарт-баннеров. [*CriteriaType]: Тип условия показа, заданного пользователем: - KEYWORD — ключевая фраза. - AUTOTARGETING — автотаргетинг. - AUDIENCE_TARGET — условие нацеливания на аудиторию. - DYNAMIC_TEXT_AD_TARGET — условие нацеливания для динамических объявлений или фильтр для динамических объявлений. - SMART_BANNER_FILTER — фильтр для смарт-баннеров. [*AdFormat]: Формат показа объявления: - IMAGE — графический. - TEXT — текстовый. - VIDEO — видео. - SMART_MULTIPLE — смарт-баннер. - SMART_SINGLE — смарт-объявление. - ADAPTIVE_IMAGE — адаптивный графический. - SMART_TILE — смарт-плитка. [*Placement]: Название площадки показов.