Фильтрация данных
Для фильтрации данных в отчете используйте структуры Filter. Каждый фильтр представляет собой критерий отбора данных. Фильтры объединяются по условию AND: в отчет попадают данные, для которых выполнены все фильтры. Фильтр состоит из трех параметров:
Field — значение какого поля сравнивается;
Operator — каким образом сравнивается;
Values — массив символьных значений, с которыми выполняется сравнение.
Например, чтобы отобрать в отчет строки, в которых количество целевых визитов больше 10, используйте фильтр
"Filter": [{
"Field": "Conversions",
"Operator": "GREATER_THAN",
"Values": ["10"]
}]<Filter>
<Field>Conversions</Field>
<Operator>GREATER_THAN</Operator>
<Values>10</Values>
</Filter>Соответствие полей и операторов представлено в таблице.
| Имя поля | Доступные операторы |
|---|---|
| AdNetworkType | EQUALS, IN |
| CampaignId | |
| CampaignType | |
| ClientLogin 1 | |
| AdFormat | EQUALS, IN, NOT_EQUALS, NOT_IN |
| AdGroupId | |
| AdId | |
| Age 2 | |
| AudienceTargetId 3 | |
| CarrierType | |
| ClickType | |
| CriteriaType | |
| CriterionType | |
| Device | |
| DynamicTextAdTargetId 3 | |
| ExternalNetworkName | |
| Gender | |
| IncomeGrade | |
| LocationOfPresenceId | |
| MatchType | |
| MobilePlatform | |
| Placement | |
| RlAdjustmentId 4 | |
| Slot | |
| SmartAdTargetId 3 | |
| TargetingCategory | |
| TargetingLocationId | EQUALS, IN, GREATER_THAN, LESS_THAN |
| Clicks | |
| Conversions | |
| ImpressionReach | GREATER_THAN, LESS_THAN |
| Impressions | |
| AvgClickPosition | |
| AvgCpc 5 | |
| AvgCpm 5 | |
| AvgEffectiveBid 5 | |
| AvgImpressionFrequency | |
| AvgImpressionPosition | |
| AvgPageviews | |
| AvgTrafficVolume | |
| BounceRate | |
| ConversionRate | |
| Cost 5 | |
| CostPerConversion 5 | |
| Ctr | |
| GoalsRoi | |
| Profit 5 | |
| Revenue 5 | |
| WeightedCtr | |
| WeightedImpressions | |
| Keyword 3 | 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 |
| Имя поля | Доступные операторы |
|---|---|
| AdNetworkType | EQUALS, IN |
| CampaignId | |
| CampaignType | |
| ClientLogin 1 | |
| AdFormat | EQUALS, IN, NOT_EQUALS, NOT_IN |
| AdGroupId | |
| AdId | |
| Age 2 | |
| AudienceTargetId 3 | |
| CarrierType | |
| ClickType | |
| CriteriaType | |
| CriterionType | |
| Device | |
| DynamicTextAdTargetId 3 | |
| ExternalNetworkName | |
| Gender | |
| IncomeGrade | |
| LocationOfPresenceId | |
| MatchType | |
| MobilePlatform | |
| Placement | |
| RlAdjustmentId 4 | |
| Slot | |
| SmartAdTargetId 3 | |
| TargetingCategory | |
| TargetingLocationId | EQUALS, IN, GREATER_THAN, LESS_THAN |
| Clicks | |
| Conversions | |
| ImpressionReach | GREATER_THAN, LESS_THAN |
| Impressions | |
| AvgClickPosition | |
| AvgCpc 5 | |
| AvgCpm 5 | |
| AvgEffectiveBid 5 | |
| AvgImpressionFrequency | |
| AvgImpressionPosition | |
| AvgPageviews | |
| AvgTrafficVolume | |
| BounceRate | |
| ConversionRate | |
| Cost 5 | |
| CostPerConversion 5 | |
| Ctr | |
| GoalsRoi | |
| Profit 5 | |
| Revenue 5 | |
| WeightedCtr | |
| WeightedImpressions | |
| Keyword 3 | 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 Фильтр по полю ClientLogin
В фильтре ClientLogin можно указывать только логины клиентов, доступные управляющему аккаунту.
- Если фильтр по полю не задан, то по умолчанию используется логин из HTTP-заголовка Client-Login. При отсутствии заголовка берется логин из OAuth-токена.
- Если фильтр по ClientLogin задан, максимальное число строк в отчете — 500000 (это же значение используется по умолчанию).
2 Фильтр по полю 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"]
}]<Filter>
<Field>Age</Field>
<Operator>IN</Operator>
<Values>AGE_45</Values>
<Values>AGE_45_54</Values>
<Values>AGE_55</Values>
</Filter>Если в фильтре указаны не все срезы, то статистика за период, включающий дату 21.08.2018, может оказаться неполной. Например, если указаны только значения AGE_45_54 и AGE_55, в отчет не попадут пользователи, чья возрастная группа определена как AGE_45.
Если в фильтре указано значение AGE_45 и не указаны AGE_45_54 и AGE_55, то отчет за период после 21.08.2018 не будет сформирован и будет выдано сообщение об ошибке.
3 Фильтры по условиям показа
Следующие поля не выводятся в отчете и используются только для фильтрации данных. Поля являются взаимоисключающими: только одно из них может присутствовать в массиве Filter.
| Поле | Описание | Комментарий |
|---|---|---|
Keyword | Текст ключевой фразы. | Текст ключевой фразы выводится в отчете в поле Criterion, идентификатор ключевой фразы — в поле CriterionId. |
AudienceTargetId | Идентификатор условия нацеливания на аудиторию. См. раздел Условие нацеливания на аудиторию (AudienceTarget). | Идентификатор условия нацеливания на аудиторию выводится в поле CriterionId. В поле Criterion выводится название условия ретаргетинга и подбора аудитории. Фильтрация по AudienceTargetId доступна для данных начиная с 08.12.2017. |
DynamicTextAdTargetId | Идентификатор условия нацеливания для динамических объявлений или идентификатор фильтра для динамических объявлений. См. раздел Условие нацеливания для динамических объявлений (DynamicTextAdTarget — Webpage). | Идентификатор условия нацеливания для динамических объявлений выводится в отчете в поле CriterionId, название — в поле Criterion. |
SmartAdTargetId | Идентификатор фильтра для смарт-баннеров. | Идентификатор фильтра для смарт-баннеров выводится в отчете в поле CriterionId, название — в поле Criterion. |
| Поле | Описание | Комментарий |
|---|---|---|
Keyword | Текст ключевой фразы. | Текст ключевой фразы выводится в отчете в поле Criterion, идентификатор ключевой фразы — в поле CriterionId. |
AudienceTargetId | Идентификатор условия нацеливания на аудиторию. См. раздел Условие нацеливания на аудиторию (AudienceTarget). | Идентификатор условия нацеливания на аудиторию выводится в поле CriterionId. В поле Criterion выводится название условия ретаргетинга и подбора аудитории. Фильтрация по AudienceTargetId доступна для данных начиная с 08.12.2017. |
DynamicTextAdTargetId | Идентификатор условия нацеливания для динамических объявлений или идентификатор фильтра для динамических объявлений. См. раздел Условие нацеливания для динамических объявлений (DynamicTextAdTarget — Webpage). | Идентификатор условия нацеливания для динамических объявлений выводится в отчете в поле CriterionId, название — в поле Criterion. |
SmartAdTargetId | Идентификатор фильтра для смарт-баннеров. | Идентификатор фильтра для смарт-баннеров выводится в отчете в поле CriterionId, название — в поле Criterion. |
4 Фильтр по RlAdjustmentId
В фильтре по полю RlAdjustmentId можно использовать значение NONE, которое означает, что корректировка ставок для целевой аудитории не была применена.
В частности, чтобы отобрать в отчет только данные с корректировками для целевой аудитории, используйте фильтр
"Filter": [{
"Field": "RlAdjustmentId",
"Operator": "NOT_EQUALS",
"Values": ["NONE"]
}]<Filter>
<Field>RlAdjustmentId</Field>
<Operator>NOT_EQUALS</Operator>
<Values>NONE</Values>
</Filter>5 Фильтры по денежным значениям
Все денежные значения в фильтрах следует указывать в виде целых чисел: сумм в валюте, умноженных на 1 000 000 (независимо от наличия заголовка returnMoneyInMicros: false).