Допустимые поля

Поля указываются в следующих параметрах отчета:

  • 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 + + сегмент сегмент сегмент сегмент сегмент сегмент сегмент сегмент