---
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: en/type.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/reports/type.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt

# Report type

In the [ReportType](*ReportType) parameter, specify the type of report. The report type affects which fields are available and how the data is grouped.

For example, if you set the SEARCH_QUERY_PERFORMANCE_REPORT type, the report data will be grouped by `AdGroupId` and `Query`. Note that when you group data by certain fields, those fields aren't added automatically to the report. The report contains only the fields that are listed in the [FieldNames](*FieldNames) parameter.

The most general report type is CUSTOM_REPORT. It doesn't add any groupings.

The table lists the report types.

#|
||
**Report type**
|
**Description**
|
**Adds data grouping**
|
**Fields not allowed**
||
||
ACCOUNT_PERFORMANCE_REPORT
|
Statistics for the user's account
|
–
|
See section [Allowed fields](https://yandex.com/dev/direct/doc/en/fields-list.md)
||
||
CAMPAIGN_PERFORMANCE_REPORT
|
Statistics for campaigns
|
[CampaignId](*CampaignId)
|
See section [Allowed fields](https://yandex.com/dev/direct/doc/en/fields-list.md)
||
||
ADGROUP_PERFORMANCE_REPORT
|
Statistics for ad groups
|
[AdGroupId](*AdGroupId)
|
See section [Allowed fields](https://yandex.com/dev/direct/doc/en/fields-list.md)
||
||
AD_PERFORMANCE_REPORT
|
Statistics for ads
|
[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
|
Statistics for targeting criteria
|
[AdGroupId](*AdGroupId), [CriteriaId](*CriteriaId), [CriteriaType](*CriteriaType)
|
[AdFormat](*AdFormat), [AdId](*AdId), [Query](*Query)
||
||
CUSTOM_REPORT
|
Statistics with custom groupings
|
–
|
[Query](*Query)
||
||
REACH_AND_FREQUENCY_PERFORMANCE_REPORT
|
Statistics for display campaigns.

The report only contains data for display campaigns and ignores all other types of campaigns.
|
In the report request, set the [FieldNames](*FieldNames) value to `CampaignId`
|
See section [Allowed fields](https://yandex.com/dev/direct/doc/en/fields-list.md)
||
||
SEARCH_QUERY_PERFORMANCE_REPORT
|
Statistics for search queries
|
[AdGroupId](*AdGroupId), [Query](*Query)
|
See section [Allowed fields](https://yandex.com/dev/direct/doc/en/fields-list.md)
||
|#


{% note info %}

All the report types use single attribution: each impression and click is attributed to only one targeting criteria, region, user age, etc.

{% endnote %}

[*ReportType]: Report type.<br/> **Required** Yes

[*FieldNames]: Names of fields (columns) that will be in the report. To see which fields you can specify, see the sections [Available fields](https://yandex.com/dev/direct/doc/en/fields-list.md) and [Incompatible fields and dependencies](https://yandex.com/dev/direct/doc/en/compatibility.md). For the REACH_AND_FREQUENCY_PERFORMANCE_REPORT report type, the CampaignId field is required.<br/> **Required** Yes

[*CampaignId]: The campaign ID

[*AdGroupId]: ID of the ad group. It's not shown in the report on campaigns created in the Campaign Wizard.

[*AdId]: The ad ID. It's not shown in the report on campaigns created in the Campaign Wizard.

[*AudienceTargetId]: ID of the audience target. See the section [Audience target (AudienceTarget)](https://yandex.com/dev/direct/doc/objects/audience-target.html).

[*Criteria]: Name or text of the targeting criteria:
- For impressions for a keyword or synonym: a keyword with an ID.
- For autotargeting: the “---autotargeting” value.
- For targeting a related keyword:
   - an empty value, if the report type is CUSTOM_REPORT.
   - the text of the related keyword, if the report type is SEARCH_QUERY_PERFORMANCE_REPORT.
- For targeting an audience target: the name of the retargeting list, or the name of a mobile app category.
- For showing a dynamic ad: the name of the dynamic text ad target, or the name of the filter.
- For showing smart banners: the name of the filter.<br/>
The selection is grouped by `CriteriaID` implicitly.

[*CriteriaId]: ID of the targeting criteria:
- For targeting a keyword or synonym: the keyword ID.
- For autotargeting: the autotargeting ID.
- For targeting a related keyword – a dash.
- For targeting an audience target: the ID of the audience target.
- For showing a dynamic ad: the ID of the dynamic text ad target, or the ID of the filter.
- For showing smart banners: the ID of the filter.<br/>
It's not shown in the report on campaigns created in the Campaign Wizard.

[*Criterion]: The name or text of the targeting criteria set by the user:
- For impressions for a keyword or synonym: a keyword with an ID.
- For targeting a [related keyword](https://yandex.com/support/direct/en/keywords/related-keywords.html) – the keyword text, or the value “Automatically added phrase” if the keyword couldn't be determined.
- For autotargeting: the “---autotargeting” value.
- For targeting an audience target: the name of the retargeting list, or the name of a mobile app category.
- For showing a dynamic ad: the name of the dynamic text ad target, or the name of the filter.
- For showing smart banners: the name of the filter.<br/>
The selection is grouped by `CriterionID` implicitly. We recommend using this field instead of `Criteria`.

[*CriterionId]: The ID of the targeting criteria set by the user:
- For targeting a keyword or synonym: the keyword ID.
- For targeting a related keyword: the ID of the keyword, or a dash if the keyword couldn't be determined.
- For autotargeting: the autotargeting ID.
- For targeting an audience (using a retargeting list or interest in a mobile app category): the ID of the audience target, or a dash if the target was deleted.
- For a dynamic text ad target generated from site pages: the ID of the dynamic text ad target.
- For a filter for dynamic ads generated from a feed, or a filter for smart banners, the filter ID.<br/>
We recommend using this field instead of `CriteriaId`. It's not shown in the report on campaigns created in the Campaign Wizard.

[*DynamicTextAdTargetId]: The ID of the dynamic text ad target, or the ID of the filter for dynamic ads. See the section [Ad target for dynamic ads (DynamicTextAdTarget — Webpage)](https://yandex.com/dev/direct/doc/objects/dynamictextadtarget.html)

[*Keyword]: The keyword text.

[*Query]: The search query that triggered the ad.

[*RlAdjustmentId]: ID of the retargeting and retargeting criteria used for applying bid adjustments to the target audience.

[*SmartAdTargetId]: The ID of the filter for smart banners.

[*CriteriaType]: The type of the targeting criteria set by the user:
- KEYWORD: Keyword.
- AUTOTARGETING: Autotargeting.
- AUDIENCE_TARGET — Audience target.
- DYNAMIC_TEXT_AD_TARGET — Dynamic text ad target or filter for dynamic ads.
- SMART_BANNER_FILTER: Filter for smart banners.

[*AdFormat]: Format of the ad impression:
- IMAGE: Image ad.
- TEXT: Text ad.
- VIDEO: Video ad.
- SMART_MULTIPLE: Smart banner.
- SMART_SINGLE: Smart ad.
- ADAPTIVE_IMAGE: Adaptive image ad.
- SMART_TILE — Smart tile.

[*Placement]: Name of the site where the ad is being displayed.