Retargeting list (RetargetingList)

A retargeting list defines the criteria for selecting users. Retargeting lists are used in audience targets (see the section Audience targets (AudienceTarget)) and in bid adjustments (see the section Bid adjustments (BidModifier)).

Rules for user selection

A retargeting list contains from 1 to 50 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 from 1 to 250 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:

A retargeting list that uses segments from Yandex.Metrica or Yandex.Audience must contain at leat one rule and the logical operator ALL or ANY. A retargeting list that consists exclusively of rules with the NONE operator can only contain Yandex.Metrica goals.

Scope

The scope of a retargeting list depends on which kinds of rules it has:

  • FOR_TARGETS_AND_ADJUSTMENTS

    If a retargeting list contains at least one rule with the ALL or ANY operator, it can be applied both in bid adjustments and in audience targets.

    This type of retargeting list can use goals and segments from Yandex.Metrica and segments from Yandex.Audience.

  • FOR_ADJUSTMENTS_ONLY

    If a retargeting list consists exclusively of rules with the NONE operator, it can only be used in bid adjustments.

    This type of retargeting list can only use Yandex.Metrica goals. Segments from Yandex.Metrica and Yandex.Audience are not allowed.

Changing the scope is not allowed.
  • 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.