Допустимые поля
Поля указываются в следующих параметрах отчета:
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 | + | + | + | – | – | – | – | – | – | метрика | – | |
AvgEffectiveBid | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
AvgImpressionFrequency | + | + | + | – | – | – | – | – | – | метрика | – | |
AvgImpressionPosition | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | – | метрика | |
AvgPageviews | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
AvgTrafficVolume | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
AvgVideoCompleteCost | + | + | + | – | – | – | – | – | – | метрика | – | |
BounceRate | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Bounces | + | – | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
CampaignId | + | + | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
CampaignName | + | – | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
CampaignUrlPath | + | – | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
CampaignType | + | + | + | сегмент | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
CarrierType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
Clicks | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
ClickType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
ClientLogin | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
ConversionRate | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Conversions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Cost | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
CostPerConversion | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
CPV | + | + | + | – | – | – | – | – | – | метрика | – | |
Criteria | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
CriteriaId | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
CriteriaType | + | + | + | сегмент | сегмент | сегмент | сегмент | атрибут | сегмент | – | сегмент | |
Criterion | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
CriterionId | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
CriterionType | + | + | + | сегмент | сегмент | сегмент | сегмент | атрибут | сегмент | – | сегмент | |
Ctr | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Date | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
Device | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
DynamicTextAdTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | фильтр | |
ExternalNetworkName | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
Gender | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
GoalsRoi | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
ImpressionReach | + | + | + | – | – | – | – | – | – | метрика | – | |
Impressions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
IncomeGrade | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
Keyword | – | + | – | – | – | – | – | фильтр | фильтр | – | фильтр | |
LocationOfPresenceId | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
LocationOfPresenceName | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
MatchedKeyword | + | + | + | – | – | – | – | – | – | – | сегмент | |
MatchType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
MobilePlatform | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
Month | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
Placement | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
Profit | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Quarter | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
Query | + | + | + | – | – | – | – | – | – | – | атрибут | |
Revenue | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
RlAdjustmentId | + | + | + | – | – | – | – | сегмент | сегмент | – | – | |
Sessions | + | – | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | – | |
Slot | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
SmartAdTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | – | |
TargetingCategory | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
TargetingLocationId | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
TargetingLocationName | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
VideoComplete | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoCompleteRate | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoFirstQuartile | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoFirstQuartileRate | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoMidpoint | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoMidpointRate | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoThirdQuartile | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoThirdQuartileRate | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoViews | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoViewsRate | + | + | + | – | – | – | – | – | – | метрика | – | |
Week | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
WeightedCtr | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
WeightedImpressions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Year | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент |
Параметры | Типы отчетов | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Имя поля | ||||||||||||
AdFormat | + | + | + | сегмент | сегмент | сегмент | сегмент | – | сегмент | – | – | |
AdGroupId | + | + | + | – | атрибут | атрибут | – | атрибут | сегмент | сегмент | атрибут | |
AdGroupName | + | – | + | – | атрибут | атрибут | – | атрибут | сегмент | сегмент | атрибут | |
AdId | + | + | + | – | атрибут | – | – | – | сегмент | сегмент | сегмент | |
AdNetworkType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
Age | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
AudienceTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | – | |
AvgClickPosition | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | – | метрика | |
AvgCpc | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
AvgCpm | + | + | + | – | – | – | – | – | – | метрика | – | |
AvgEffectiveBid | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
AvgImpressionFrequency | + | + | + | – | – | – | – | – | – | метрика | – | |
AvgImpressionPosition | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | – | метрика | |
AvgPageviews | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
AvgTrafficVolume | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
AvgVideoCompleteCost | + | + | + | – | – | – | – | – | – | метрика | – | |
BounceRate | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Bounces | + | – | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
CampaignId | + | + | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
CampaignName | + | – | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
CampaignUrlPath | + | – | + | – | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
CampaignType | + | + | + | сегмент | атрибут | атрибут | атрибут | атрибут | сегмент | сегмент | атрибут | |
CarrierType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
Clicks | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
ClickType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
ClientLogin | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
ConversionRate | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Conversions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Cost | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
CostPerConversion | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
CPV | + | + | + | – | – | – | – | – | – | метрика | – | |
Criteria | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
CriteriaId | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
CriteriaType | + | + | + | сегмент | сегмент | сегмент | сегмент | атрибут | сегмент | – | сегмент | |
Criterion | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
CriterionId | + | – | – | – | – | – | – | атрибут | сегмент | – | сегмент | |
CriterionType | + | + | + | сегмент | сегмент | сегмент | сегмент | атрибут | сегмент | – | сегмент | |
Ctr | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Date | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
Device | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
DynamicTextAdTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | фильтр | |
ExternalNetworkName | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
Gender | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
GoalsRoi | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
ImpressionReach | + | + | + | – | – | – | – | – | – | метрика | – | |
Impressions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
IncomeGrade | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
Keyword | – | + | – | – | – | – | – | фильтр | фильтр | – | фильтр | |
LocationOfPresenceId | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
LocationOfPresenceName | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
MatchedKeyword | + | + | + | – | – | – | – | – | – | – | сегмент | |
MatchType | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
MobilePlatform | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
Month | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
Placement | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
Profit | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Quarter | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
Query | + | + | + | – | – | – | – | – | – | – | атрибут | |
Revenue | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
RlAdjustmentId | + | + | + | – | – | – | – | сегмент | сегмент | – | – | |
Sessions | + | – | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | – | |
Slot | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | – | |
SmartAdTargetId | – | + | – | – | – | – | – | фильтр | фильтр | – | – | |
TargetingCategory | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | сегмент | |
TargetingLocationId | + | + | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
TargetingLocationName | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | – | |
VideoComplete | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoCompleteRate | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoFirstQuartile | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoFirstQuartileRate | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoMidpoint | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoMidpointRate | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoThirdQuartile | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoThirdQuartileRate | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoViews | + | + | + | – | – | – | – | – | – | метрика | – | |
VideoViewsRate | + | + | + | – | – | – | – | – | – | метрика | – | |
Week | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | |
WeightedCtr | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
WeightedImpressions | + | + | + | метрика | метрика | метрика | метрика | метрика | метрика | метрика | метрика | |
Year | + | – | + | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент | сегмент |