Допустимые поля
Поля указываются в следующих параметрах отчета:
- FieldNames — поля, которые выводятся в отчете (столбцы);
- Field в структуре Filter — поля, которые используются для фильтрации данных в отчете;
- Field в структуре OrderBy — поля, которые используются для сортировки строк в отчете.
Наборы допустимых полей в этих параметрах различаются (см. таблицу ниже). Например, поле CampaignName может быть добавлено как столбец в отчете, но не может использоваться для фильтрации данных, а поле Keyword — наоборот, используется только для фильтрации данных и в отчете не выводится.
Тип отчета также влияет на набор допустимых полей и их назначение (см. таблицу ниже):
- фильтр — поле используется только для фильтрации данных и не может быть выведено в отчете;
- сегмент — при выводе в отчете поле используется для группировки данных;
- метрика — поле содержит числовое значение, рассчитанное в соответствии с заданными фильтрами и группировками;
- атрибут — поле содержит фиксированное значение в соответствии с заданными группировками, добавление такого поля в отчет не приводит к появлению новой группировки.
Например, поле CampaignId для типа отчета CUSTOM_REPORT является сегментом: если его добавить в отчет, данные будут сгруппированы по кампаниям. А для типа отчета ADGROUP_PERFORMANCE_REPORT поле CampaignId является атрибутом: данные уже сгруппированы по AdGroupId, а идентификатор кампании является для каждой группы фиксированным значением.
Прочерк «–» означает, что в соответствующем параметре или типе отчета это поле использовать нельзя.
Описание полей см. на странице Содержание отчета
|
Параметры |
Типы отчетов |
||||||||||
|
Имя поля |
FieldNames |
Filter.Field |
OrderBy.Field |
ACCOUNT_PERFORMANCE_REPORT |
AD_PERFORMANCE_REPORT |
ADGROUP_PERFORMANCE_REPORT |
CAMPAIGN_PERFORMANCE_REPORT |
CRITERIA_PERFORMANCE_REPORT |
CUSTOM_REPORT |
REACH_AND_FREQUENCY_PERFORMANCE_REPORT |
SEARCH_QUERY_PERFORMANCE_REPORT |
|
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 |
+ |
+ |
+ |
метрика |
метрика |
метрика |
метрика |
метрик |
метрика |
метрика |
метрика |
|
PurchaseGoals |
- |
+ |
- |
метрика |
метрика |
метрика |
метрика |
метрик |
метрика |
метрика |
метрика |
|
PurchaseRevenue |
+ |
+ |
+ |
метрика |
метрика |
метрика |
метрика |
метрик |
метрика |
метрика |
метрика |
|
PurchaseProfit |
+ |
+ |
+ |
метрика |
метрика |
метрика |
метрика |
метрик |
метрика |
метрика |
метрика |
|
PurchaseGoalsRoi |
+ |
+ |
+ |
метрика |
метрика |
метрика |
метрика |
метрик |
метрика |
метрика |
метрика |
|
Quarter |
+ |
– |
+ |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
|
Query |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
– |
атрибут |
|
Revenue |
+ |
+ |
+ |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
|
RlAdjustmentId |
+ |
+ |
+ |
– |
– |
– |
– |
сегмент |
сегмент |
– |
– |
|
Sessions |
+ |
– |
+ |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
– |
|
Slot |
+ |
+ |
+ |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
– |
– |
|
SmartAdTargetId |
– |
+ |
– |
– |
– |
– |
– |
фильтр |
фильтр |
– |
– |
|
TargetingCategory |
+ |
+ |
+ |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
– |
сегмент |
|
TargetingLocationId |
+ |
+ |
+ |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
– |
|
TargetingLocationName |
+ |
– |
+ |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
– |
|
VideoComplete |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoCompleteRate |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoFirstQuartile |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoFirstQuartileRate |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoMidpoint |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoMidpointRate |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoThirdQuartile |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoThirdQuartileRate |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoViews |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
VideoViewsRate |
+ |
+ |
+ |
– |
– |
– |
– |
– |
– |
метрика |
– |
|
Week |
+ |
– |
+ |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
|
WeightedCtr |
+ |
+ |
+ |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
|
WeightedImpressions |
+ |
+ |
+ |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
метрика |
|
Year |
+ |
– |
+ |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |
сегмент |