--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.ru/dev/direct/doc/en/filters.md - https://yandex.ru/dev/direct/doc/ru/filters.md - href: ru/filters.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt sourcePath: ru/reports/filters.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt # Фильтрация данных Для фильтрации данных в отчете используйте структуры Filter. Каждый фильтр представляет собой критерий отбора данных. Фильтры объединяются по условию AND: в отчет попадают данные, для которых выполнены все фильтры. Фильтр состоит из трех параметров: - Field — значение какого поля сравнивается; - Operator — каким образом сравнивается; - Values — массив символьных значений, с которыми выполняется сравнение. Например, чтобы отобрать в отчет строки, в которых количество целевых визитов больше 10, используйте фильтр {% list tabs %} - JSON ```text translate=no "Filter": [{ "Field": "Conversions", "Operator": "GREATER_THAN", "Values": ["10"] }] ``` - XML ```text translate=no Conversions GREATER_THAN 10 ``` {% endlist %} Соответствие полей и операторов представлено в таблице. #| || **Имя поля** | **Доступные операторы** || || AdNetworkType | EQUALS, IN || || CampaignId | ^ || || CampaignType | ^ || || ClientLogin | ^ || || AdFormat | EQUALS, IN, NOT_EQUALS, NOT_IN || || AdGroupId | ^ || || AdId | ^ || || Age | ^ || || AudienceTargetId | ^ || || CarrierType | ^ || || ClickType | ^ || || CriteriaType | ^ || || CriterionType | ^ || || Device | ^ || || DynamicTextAdTargetId | ^ || || ExternalNetworkName | ^ || || Gender | ^ || || IncomeGrade | ^ || || LocationOfPresenceId | ^ || || MatchType | ^ || || MobilePlatform | ^ || || Placement | ^ || || RlAdjustmentId | ^ || || Slot | ^ || || SmartAdTargetId | ^ || || TargetingCategory | ^ || || TargetingLocationId | EQUALS, IN, GREATER_THAN, LESS_THAN || || Clicks | ^ || || Conversions | ^ || || ImpressionReach | GREATER_THAN, LESS_THAN || || Impressions | ^ || || AvgClickPosition | ^ || || AvgCpc | ^ || || AvgCpm | ^ || || AvgEffectiveBid | ^ || || AvgImpressionFrequency | ^ || || AvgImpressionPosition | ^ || || AvgPageviews | ^ || || AvgTrafficVolume | ^ || || BounceRate | ^ || || ConversionRate | ^ || || Cost | ^ || || CostPerConversion | ^ || || Ctr | ^ || || GoalsRoi | ^ || || Profit | ^ || || Revenue | ^ || || WeightedCtr | ^ || || WeightedImpressions | ^ || || Keyword | 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 | ^ || || PurchaseGoals | IN || |# ## Фильтр по полю ClientLogin В фильтре ClientLogin можно указывать только логины клиентов, доступные управляющему аккаунту. - Если фильтр по полю не задан, то по умолчанию используется логин из HTTP-заголовка `Client-Login`. При отсутствии заголовка берется логин из OAuth-токена. - Если фильтр по `ClientLogin` задан, максимальное число строк в отчете — 500000 (это же значение используется по умолчанию). ## Фильтр по полю Age В поле Age в статистике за период до 21.08.2018 выводится значение AGE_45, за период после 21.08.2018 — значения AGE_45_54 и AGE_55. Чтобы получить статистику по всем пользователям от 45 лет независимо от периода отчета, рекомендуем указать в фильтре по полю Age все три значения: {% list tabs %} - JSON ```text translate=no "Filter": [{ "Field": "Age", "Operator": "IN", "Values": ["AGE_45", "AGE_45_54", "AGE_55"] }] ``` - XML ```text translate=no Age IN AGE_45 AGE_45_54 AGE_55 ``` {% endlist %} Если в фильтре указаны не все срезы, то статистика за период, включающий дату 21.08.2018, может оказаться неполной. Например, если указаны только значения AGE_45_54 и AGE_55, в отчет не попадут пользователи, чья возрастная группа определена как AGE_45. Если в фильтре указано значение AGE_45 и не указаны AGE_45_54 и AGE_55, то отчет за период после 21.08.2018 не будет сформирован и будет выдано сообщение об ошибке. ## Фильтры по условиям показа Следующие поля не выводятся в отчете и используются только для фильтрации данных. Поля являются взаимоисключающими: только одно из них может присутствовать в массиве Filter. #| || **Поле** | **Описание** | **Комментарий** || || `Keyword` | Текст ключевой фразы. | Текст ключевой фразы выводится в отчете в поле `Criterion`, идентификатор ключевой фразы — в поле `CriterionId`. || || `AudienceTargetId` | Идентификатор условия нацеливания на аудиторию. См. [раздел Условие нацеливания на аудиторию (AudienceTarget)](https://yandex.ru/dev/direct/doc/dg/objects/audience-target.html). | Идентификатор условия нацеливания на аудиторию выводится в поле `CriterionId`. В поле `Criterion` выводится название условия ретаргетинга и подбора аудитории. Фильтрация по `AudienceTargetId` доступна для данных начиная с 08.12.2017. || || `DynamicTextAdTargetId` | Идентификатор условия нацеливания для динамических объявлений или идентификатор фильтра для динамических объявлений. См. раздел [Условие нацеливания для динамических объявлений (DynamicTextAdTarget — Webpage)](https://yandex.ru/dev/direct/doc/dg/objects/dynamictextadtarget.html). | Идентификатор условия нацеливания для динамических объявлений выводится в отчете в поле `CriterionId`, название — в поле `Criterion`. || || `SmartAdTargetId` | Идентификатор фильтра для смарт-баннеров. | Идентификатор фильтра для смарт-баннеров выводится в отчете в поле `CriterionId`, название — в поле `Criterion`. || |# ## Фильтр по RlAdjustmentId В фильтре по полю `RlAdjustmentId` можно использовать значение NONE, которое означает, что корректировка ставок для целевой аудитории не была применена. В частности, чтобы отобрать в отчет только данные с корректировками для целевой аудитории, используйте фильтр {% list tabs %} - JSON ```text translate=no "Filter": [{ "Field": "RlAdjustmentId", "Operator": "NOT_EQUALS", "Values": ["NONE"] }] ``` - XML ```text translate=no RlAdjustmentId NOT_EQUALS NONE ``` {% endlist %} ## Фильтры по денежным значениям Все денежные значения в фильтрах следует указывать в виде **целых чисел**: сумм в валюте, **умноженных на 1 000 000** (независимо от наличия заголовка `returnMoneyInMicros: false`). ## Фильтр по полю PurchaseGoals {#purchasegoals} Фильтр используется для управления набором целей для расчета `PurchaseRevenue`, `PurchaseProfit`, `PurchaseGoalsRoi`. Если его не передать, то будет использоваться логика [по умолчанию](https://yandex.ru/support/direct/ru/statistics/profit-and-value#kak-vybrat-celi-dlya-rascheta-dohoda). {% list tabs %} - JSON ```text translate=no "Filter": [{ "Field": "PurchaseGoals", "Operator": "IN", "Values": ["GOAL_ID_1", ... , "GOAL_ID_N"] }] ``` - XML ```text translate=no PurchaseGoals IN GOAL_ID_1 ... GOAL_ID_N ``` {% endlist %}