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

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

  • 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+++сегментсегментсегментсегментсегментсегментсегмент
Quarter++сегментсегментсегментсегментсегментсегментсегментсегмент
Query+++атрибут
Revenue+++метрикаметрикаметрикаметрикаметрикаметрикаметрикаметрика
RlAdjustmentId+++сегментсегмент
Sessions++метрикаметрикаметрикаметрикаметрикаметрикаметрика
Slot+++сегментсегментсегментсегментсегментсегмент
SmartBannerFilterId+фильтрфильтр
TargetingLocationId+++сегментсегментсегментсегментсегментсегментсегмент
TargetingLocationName++сегментсегментсегментсегментсегментсегментсегмент
Week++сегментсегментсегментсегментсегментсегментсегментсегмент
WeightedCtr+++метрикаметрикаметрикаметрикаметрикаметрикаметрика
WeightedImpressions+++метрикаметрикаметрикаметрикаметрикаметрикаметрика
Year++сегментсегментсегментсегментсегментсегментсегментсегмент