Фильтрация данных

Для фильтрации данных в отчете используйте структуры Filter. Каждый фильтр представляет собой критерий отбора данных. Фильтры объединяются по условию AND: в отчет попадают данные, для которых выполнены все фильтры. Фильтр состоит из трех параметров:

  • Field — значение какого поля сравнивается;

  • Operator — каким образом сравнивается;

  • Values — массив символьных значений, с которыми выполняется сравнение.

Например, чтобы отобрать в отчет строки, в которых количество целевых визитов больше 10, используйте фильтр

"Filter": [{
  "Field": "Conversions",
  "Operator": "GREATER_THAN",
  "Values": ["10"]
}]

Соответствие полей и операторов представлено в таблице.

Имя поля Доступные операторы
AdNetworkType EQUALS, IN
CampaignId
CampaignType
AdFormat EQUALS, IN, NOT_EQUALS, NOT_IN
AdGroupId
AdId
Age 1
AudienceTargetId 2
CarrierType
ClickType
CriteriaType
CriterionType
Device
DynamicTextAdTargetId 2
ExternalNetworkName
Gender
LocationOfPresenceId
MatchType
MobilePlatform
Placement
RlAdjustmentId 3
Slot
SmartBannerFilterId 2
TargetingLocationId
Clicks EQUALS, IN, GREATER_THAN, LESS_THAN
Conversions
ImpressionReach
Impressions
Renderings
Sov
SovByImpressions
ViewableRate
AvgClickPosition GREATER_THAN, LESS_THAN
AvgCpc 4
AvgCpm 4
AvgImpressionFrequency
AvgImpressionPosition
AvgPageviews
AvgTimeToConversion
AvgTrafficVolume
BounceRate
ConversionRate
Cost 4
CostPerConversion 4
Ctr
GoalsRoi
ImpressionShare
Profit 4
RenderingRate
Revenue 4
Sov
SovByImpressions
ViewableRate
WeightedCtr
WeightedImpressions
Keyword 2 EQUALS, IN, NOT_EQUALS, NOT_IN, STARTS_WITH_IGNORE_CASE, STARTS_WITH_ANY_IGNORE_CASE, DOES_NOT_START_WITH_IGNORE_CASE, DOES_NOT_START_WITH_ALL_IGNORE_CASE
MatchedKeyword
Query

1 Фильтр по полю Age

В поле Age в статистике за период до 21.08.2018 выводится значение AGE_45, за период после 21.08.2018 — значения AGE_45_54 и AGE_55.

Чтобы получить статистику по всем пользователям от 45 лет независимо от периода отчета, рекомендуем указать в фильтре по полю Age все три значения:

"Filter": [{
  "Field": "Age",
  "Operator": "IN",
  "Values": ["AGE_45", "AGE_45_54", "AGE_55"]
}]

Если в фильтре указаны не все срезы, то статистика за период, включающий дату 21.08.2018, может оказаться неполной. Например, если указаны только значения AGE_45_54 и AGE_55, в отчет не попадут пользователи, чья возрастная группа определена как AGE_45.

Если в фильтре указано значение AGE_45 и не указаны AGE_45_54 и AGE_55, то отчет за период после 21.08.2018 не будет сформирован и будет выдано сообщение об ошибке.

2 Фильтры по условиям показа

Следующие поля не выводятся в отчете и используются только для фильтрации данных. Поля являются взаимоисключающими: только одно из них может присутствовать в массиве Filter.

Поле Описание Комментарий
Keyword Текст ключевой фразы. Текст ключевой фразы выводится в отчете в поле Criterion, идентификатор ключевой фразы — в поле CriterionId.
AudienceTargetId Идентификатор условия нацеливания на аудиторию. См. раздел Условие нацеливания на аудиторию (AudienceTarget).

Идентификатор условия нацеливания на аудиторию выводится в поле CriterionId. В поле Criterion выводится название условия ретаргетинга и подбора аудитории.

Фильтрация по AudienceTargetId доступна для данных начиная с 08.12.2017.

DynamicTextAdTargetId Идентификатор условия нацеливания для динамических объявлений или идентификатор фильтра для динамических объявлений. См. раздел Условие нацеливания для динамических объявлений (DynamicTextAdTarget — Webpage). Идентификатор условия нацеливания для динамических объявлений выводится в отчете в поле CriterionId, название — в поле Criterion.
SmartBannerFilterId Идентификатор фильтра для смарт-баннеров.

Идентификатор фильтра для смарт-баннеров выводится в отчете в поле CriterionId, название — в поле Criterion.

3 Фильтр по RlAdjustmentId

В фильтре по полю RlAdjustmentId можно использовать значение NONE, которое означает, что корректировка ставок для целевой аудитории не была применена.

В частности, чтобы отобрать в отчет только данные с корректировками для целевой аудитории, используйте фильтр

"Filter": [{
  "Field": "RlAdjustmentId",
  "Operator": "NOT_EQUALS",
  "Values": ["NONE"]
}]

4 Фильтры по денежным значениям

Все денежные значения в фильтрах следует указывать в виде целых чисел: сумм в валюте, умноженных на 1 000 000 (независимо от наличия заголовка returnMoneyInMicros: false).