--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/dev/direct/doc/en/objects/retargeting-list.md - https://yandex.com/dev/direct/doc/ru/objects/retargeting-list.md - href: en/objects/retargeting-list.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: en/dg/objects/retargeting-list.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt # Retargeting list (RetargetingList) A retargeting list defines the criteria for selecting users. Retargeting lists are used in audience targets (see [Audience targets (AudienceTarget)](https://yandex.com/dev/direct/doc/en/objects/audience-target.md)) and bid adjustments (see [Adjustments (BidModifier)](https://yandex.com/dev/direct/doc/en/objects/bidmodifier.md)). ## Service {#service} Use the [RetargetingLists](https://yandex.com/dev/direct/doc/retargetinglists/retargetinglists.html) service for managing retargeting lists. ### Methods [add](https://yandex.com/dev/direct/doc/retargetinglists/add.html) | [update](https://yandex.com/dev/direct/doc/retargetinglists/update.html) | [delete](https://yandex.com/dev/direct/doc/retargetinglists/delete.html) | [get](https://yandex.com/dev/direct/doc/retargetinglists/get.html) ## Restrictions {#restrictions} Maximum 2000 retargeting lists per user account. ## Goals and segments {#goals} To set up a retargeting list, you can use: - Goals and segments configured in Yandex Metrica: see the sections [What are goals? Types of goals](https://yandex.ru/support/metrika/general/goals.html) and [Data segmentation](https://yandex.ru/support/metrika/general/segmentation.html) in Yandex Metrica Help, and [Retargeting & Audiences](https://yandex.com/support/direct/en/impression-criteria/retargeting-lists.html) in Yandex Direct Help. - Segments configured in Yandex Audience: see the Yandex Audience [Help](https://yandex.ru/support/audience/). - Segments based on [Crypta](https://yandex.ru/company/technologies/crypta/) data (demographic and behavior-based segments along with user interest segments): see the section [User profile](https://yandex.com/support/direct/en/products-cpm-campaign/display-ads-settings.html) in the Help for Yandex Direct. To get a list of available Yandex Metrica goals, Yandex Metrica segments, and Yandex Audience segments, use the [GetRetargetingGoals (Live)](https://yandex.com/dev/direct/doc/dg-v4/live/GetRetargetingGoals.html) method in the Live 4 version of the API. To get a list of segments based on Crypta data, use the [Dictionaries](https://yandex.com/dev/direct/doc/dictionaries/dictionaries.html).[get](https://yandex.com/dev/direct/doc/dictionaries/get.html) method: - To get the list of demographic and behavior-based segments, specify the `AudienceDemographicProfiles` list name in the request. To get the list of demographic and behavioral characteristics, specify `AudienceCriteriaTypes`. - To get the list of user interest segments, specify the `AudienceInterests` list name in the request. ## Type of retargeting lists {#types} The type of a retargeting list is set when creating it and can't be changed. The following types of retargeting lists are currently available: - RETARGETING — A retargeting list can contain Yandex Metrica goals, Yandex Metrica segments, and Yandex Audience segments. It can be used in “Text & Image Ads” and “Ads for Mobile Apps” campaigns. - AUDIENCE — A retargeting list may contain any types of goals and segments. It can be used in display campaigns. A retargeting list that only contains a selection rule based on short-term interest segments can also be used in “Text & Image Ads” campaigns. ## Rules for user selection {#rules} A retargeting list contains rules for user selection (the `Rules` array) that are combined using the AND principle, meaning the retargeting list applies to users who meet all of the rules. Each selection rule contains a list of goals or segments (the `Arguments` array) and the logical operator (the `Operator` parameter): - ALL — the rule is met if the user completed all the goals and is included in all the segments. - ANY — The rule is met if the user completed at least one of the goals or the user's session is included in at least one of the segments. - NONE — The rule is met if the user didn't complete any of the goals and the user's session isn't included in any of the segments. **Example of the structure**   {% list tabs %} - For retargeting lists of the RETARGETING type ![Example structure for retargeting lists of the RETARGETING type](https://yastatic.net/s3/doc-binary/freeze/fZhdB_bn-aGpBCtqz9UGmX5sQ94.png) - For retargeting lists of the AUDIENCE type ![Example structure for retargeting lists of the AUDIENCE type](https://yastatic.net/s3/doc-binary/freeze/SJ_XKuPW-WvSjeEIWAOq4lEUr48.png) {% endlist %} **Restrictions**   {% list tabs %} - For retargeting lists of the RETARGETING type - Retargeting lists can contain from 1 to 50 selection rules based on Yandex Metrica goals, Yandex Metrica segments, and Yandex Audience segments. - A selection rule may contain from 1 to 250 goals or segments. - For retargeting lists of the AUDIENCE type - A retargeting list must contain at least one rule with the logical operator ALL or ANY. - Each selection rule may contain either Yandex Metrica goals, Yandex Metrica segments, and Yandex Audience segments, or demographic segments, or behavior-based segments, or user interest segments. - For selection rules based on demographic or behavior-based segments: - Each selection rule can only contain segments based on a single characteristic or a single behavior (the [Type](*Type) field returned by the [Dictionaries](https://yandex.com/dev/direct/doc/dictionaries/dictionaries.html).[get](https://yandex.com/dev/direct/doc/dictionaries/get.html) method in the [AudienceDemographicProfiles](*AudienceDemographicProfiles) and [AudienceCriteriaTypes](*AudienceCriteriaTypes) lists). For example, only segments by revenue. - Retargeting lists may contain no more than one selection rule for each demographic characteristic or behavior. For example, no more than one revenue-based selection rule. - For some characteristics and behaviors, you can't specify all the segments (the [Rule](*Rule) field in the [AudienceCriteriaTypes](*AudienceCriteriaTypes) list). For example, the age-based selection rule should not contain all age groups. - Only the ANY operator can be used in a selection rule based on a demographic characteristic or behavior. - For selection rules based on interest segments: - Retargeting lists may include no more than three selection rules based on interest segments. - A selection rule may contain no more than 10 interests. - An interest-based selection rule can only contain segments with the same interest duration (the [InterestType](*InterestType) field returned by the [Dictionaries](https://yandex.com/dev/direct/doc/dictionaries/dictionaries.html).[get](https://yandex.com/dev/direct/doc/dictionaries/get.html) method in the [AudienceInterests](*AudienceInterests) list). For example, only short-term interests. - Only the ANY operator can be used in an interest-based selection rule. - For selection rules based on goals and segments from Yandex Metrica and Yandex Audience segments: - Retargeting lists can contain from 1 to 50 selection rules based on Yandex Metrica goals, Yandex Metrica segments, and Yandex Audience segments. - A selection rule may contain from 1 to 250 goals or segments. {% endlist %} ## Scope {#type} The scope of the retargeting list depends on its type and which kinds of selection rules it has. The `AvailableForTargetsInAdGroupTypes` and `Scope`parameters returned by the [RetargetingLists](https://yandex.com/dev/direct/doc/retargetinglists/retargetinglists.html).[get](https://yandex.com/dev/direct/doc/retargetinglists/get.html) method describe the scope of the retargeting list: - The `AvailableForTargetsInAdGroupTypes` parameter defines the types of groups that can have an audience target added for the specified retargeting list. - The `Scope` parameter defines where the retargeting list can be used: only in audience targets, only in bid adjustments, or everywhere. {% list tabs %} - For retargeting lists of the RETARGETING type - If a retargeting list of the RETARGETING type contains at least one rule with the ALL or ANY operator, it can be applied both in bid adjustments and in audience targets. The `Scope` parameter contains the value FOR_TARGETS_AND_ADJUSTMENTS, and the `AvailableForTargetsInAdGroupTypes` parameter contains the TEXT_AD_GROUP and MOBILE_APP_AD_GROUP values. - If a retargeting list consists exclusively of rules with the NONE operator, it can only be used in bid adjustments. The `Scope` parameter is used for returning the FOR_ADJUSTMENTS_ONLY value, and `AvailableForTargetsInAdGroupTypes` is null (nil). ![Schema for retargeting lists of the RETARGETING type](https://yastatic.net/s3/doc-binary/freeze/0dEUq_eEtNrkww3I3Gh5jODif-c.png) {% note alert %} - If you modify a retargeting list that contains at least one rule with the ALL or ANY operator, it still must contain at least one rule with the ALL or ANY operator after your changes. - If you modify a retargeting list that consists exclusively of rules with the NONE operator, it must still contain only rules with the NONE operator after your changes. Otherwise, the edit operation isn't performed, and an error is returned. {% endnote %} - For retargeting lists of the AUDIENCE type Retargeting lists with the AUDIENCE type are only used in audience targets: in the `Scope` parameter always returns FOR_TARGETS_ONLY. If the retargeting list consists only of a selection rule based on short-term interest segments, the `AvailableForTargetsInAdGroupTypes` parameter has the values TEXT_AD_GROUP, CPM_BANNER_AD_GROUP, and CPM_VIDEO_AD_GROUP. In all other cases, only CPM_BANNER_AD_GROUP and CPM_VIDEO_AD_GROUP. {% note alert %} - You can't add audience targeting criteria to CPM_BANNER_AD_GROUP ad groups with the KEYWORDS subtype. - Image Ad group, it must still contain only short-term interests after editing. {% endnote %} {% endlist %} ### Learn more - [Audience targets (AudienceTarget)](https://yandex.com/dev/direct/doc/en/objects/audience-target.md) [*Type]: ID of a demographic or behavioral characteristic (the [Type ](https://yandex.com/dev/direct/doc/dictionaries/get.html#output__AudienceCriteriaTypesItem-Type)parameter in the AudienceCriteriaTypes structure). [*AudienceDemographicProfiles]: Segments based on demographic and behavioral characteristics for targeting by user profile. [*AudienceCriteriaTypes]: Demographic and behavioral characteristics. [*Rule]: Whether all segments for this characteristic can be specified in a user selection rule (for example, you aren't allowed to specify all age groups, but you can specify all professions). [*InterestType]: Type of interest: short-term, long-term, or for any period. [*AudienceInterests]: Segments based on user interests for targeting by user profile.