Допустимые поля
Поля указываются в следующих параметрах отчета:
FieldNames — поля, которые выводятся в отчете (столбцы);
Field в структуре Filter — поля, которые используются для фильтрации данных в отчете;
Field в структуре OrderBy — поля, которые используются для сортировки строк в отчете.
Наборы допустимых полей в этих параметрах различаются (см. таблицу ниже). Например, поле CampaignName может быть добавлено как столбец в отчете, но не может использоваться для фильтрации данных, а поле Keyword — наоборот, используется только для фильтрации данных и в отчете не выводится.
Тип отчета также влияет на набор допустимых полей и их назначение (см. таблицу ниже):
фильтр — поле используется только для фильтрации данных и не может быть выведено в отчете;
сегмент — при выводе в отчете поле используется для группировки данных;
метрика — поле содержит числовое значение, рассчитанное в соответствии с заданными фильтрами и группировками;
атрибут — поле содержит фиксированное значение в соответствии с заданными группировками, добавление такого поля в отчет не приводит к появлению новой группировки.
Например, поле CampaignId для типа отчета CUSTOM_REPORT является сегментом: если его добавить в отчет, данные будут сгруппированы по кампаниям. А для типа отчета ADGROUP_PERFORMANCE_REPORT поле CampaignId является атрибутом: данные уже сгруппированы по AdGroupId, а идентификатор кампании является для каждой группы фиксированным значением.
Прочерк «–» означает, что в соответствующем параметре или типе отчета это поле использовать нельзя.
| Параметры | Типы отчетов | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Имя поля | | | | | | | | | | | | |
| AdFormat | + | + | + | сегмент | сегмент | сегмент | сегмент | – | сегмент | – | – | |
| AdGroupId | + | + | + | – | атрибут | атрибут | – | атрибут | сегмент | сегмент | атрибут | |
| AdGroupName | + | – | + | – | атрибут | атрибут | – | атрибут | сегмент | сегмент | атрибут | |
| AdId | + | + | + | – | атрибут | – | – | – | сегмент | сегмент | сегмент | |
| AdNetworkType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| Age | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| AudienceTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | – | |
| AvgClickPosition | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | – | метрика | |
| AvgCpc | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| AvgCpm | + | + | + | – | – | – | – | – | – | метрика | – | |
| AvgImpressionFrequency | + | + | + | – | – | – | – | – | – | метрика | – | |
| AvgImpressionPosition | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | – | метрика | |
| AvgPageviews | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| AvgTrafficVolume | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| BounceRate | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Bounces | + | – | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| CampaignId | + | + | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
| CampaignName | + | – | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
| CampaignType | + | + | + | сегмент | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
| CarrierType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| Clicks | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| ClickType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| ConversionRate | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Conversions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Cost | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| CostPerConversion | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Criteria | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
| CriteriaId | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
| CriteriaType | + | + | + | сегмент | сегмент | сегмент | сегмент | атрибут | сегмент | – | сегмент | |
| Criterion | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
| CriterionId | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
| CriterionType | + | + | + | сегмент | сегмент | сегмент | сегмент | атрибут | сегмент | – | сегмент | |
| Ctr | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Date | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| Device | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| DynamicTextAdTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | фильтр | |
| ExternalNetworkName | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| Gender | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| GoalsRoi | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| ImpressionReach | + | + | + | – | – | – | – | – | – | метрика | – | |
| Impressions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| ImpressionShare | + | + | + | – | – | метрика | метрика | метрика | – | – | – | |
| Keyword | – | + | – | – | – | – | – | фильтр | фильтр | – | фильтр | |
| LocationOfPresenceId | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| LocationOfPresenceName | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| MatchedKeyword | + | + | + | – | – | – | – | – | – | – | сегмент | |
| MatchType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
| MobilePlatform | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| Month | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| Placement | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
| Profit | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Quarter | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| Query | + | + | + | – | – | – | – | – | – | – | атрибут | |
| Revenue | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| RlAdjustmentId | + | + | + | – | – | – | – | сегмент | сегмент | – | – | |
| Sessions | + | – | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | – | |
| Slot | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| SmartAdTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | – | |
| TargetingLocationId | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| TargetingLocationName | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| Week | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| WeightedCtr | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| WeightedImpressions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Year | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| Параметры | Типы отчетов | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Имя поля | | | | | | | | | | | | |
| AdFormat | + | + | + | сегмент | сегмент | сегмент | сегмент | – | сегмент | – | – | |
| AdGroupId | + | + | + | – | атрибут | атрибут | – | атрибут | сегмент | сегмент | атрибут | |
| AdGroupName | + | – | + | – | атрибут | атрибут | – | атрибут | сегмент | сегмент | атрибут | |
| AdId | + | + | + | – | атрибут | – | – | – | сегмент | сегмент | сегмент | |
| AdNetworkType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| Age | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| AudienceTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | – | |
| AvgClickPosition | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | – | метрика | |
| AvgCpc | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| AvgCpm | + | + | + | – | – | – | – | – | – | метрика | – | |
| AvgImpressionFrequency | + | + | + | – | – | – | – | – | – | метрика | – | |
| AvgImpressionPosition | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | – | метрика | |
| AvgPageviews | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| AvgTrafficVolume | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| BounceRate | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Bounces | + | – | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| CampaignId | + | + | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
| CampaignName | + | – | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
| CampaignType | + | + | + | сегмент | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
| CarrierType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| Clicks | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| ClickType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| ConversionRate | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Conversions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Cost | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| CostPerConversion | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Criteria | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
| CriteriaId | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
| CriteriaType | + | + | + | сегмент | сегмент | сегмент | сегмент | атрибут | сегмент | – | сегмент | |
| Criterion | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
| CriterionId | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
| CriterionType | + | + | + | сегмент | сегмент | сегмент | сегмент | атрибут | сегмент | – | сегмент | |
| Ctr | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Date | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| Device | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| DynamicTextAdTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | фильтр | |
| ExternalNetworkName | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| Gender | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| GoalsRoi | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| ImpressionReach | + | + | + | – | – | – | – | – | – | метрика | – | |
| Impressions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| ImpressionShare | + | + | + | – | – | метрика | метрика | метрика | – | – | – | |
| Keyword | – | + | – | – | – | – | – | фильтр | фильтр | – | фильтр | |
| LocationOfPresenceId | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| LocationOfPresenceName | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| MatchedKeyword | + | + | + | – | – | – | – | – | – | – | сегмент | |
| MatchType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
| MobilePlatform | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| Month | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| Placement | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
| Profit | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Quarter | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| Query | + | + | + | – | – | – | – | – | – | – | атрибут | |
| Revenue | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| RlAdjustmentId | + | + | + | – | – | – | – | сегмент | сегмент | – | – | |
| Sessions | + | – | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | – | |
| Slot | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
| SmartAdTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | – | |
| TargetingLocationId | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| TargetingLocationName | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
| Week | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
| WeightedCtr | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| WeightedImpressions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
| Year | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |