Returns retargeting conditions.


This method is outdated and will soon be disabled. Use version 5 of the API.

For information about the compatibility of methods between versions Live 4 and 5, see the Migration guide.

Input data

The input data structure in JSON is shown below.

   "method": "RetargetingCondition",
   "param": {
      /* RetargetingConditionRequest */
      "Action": (string),
      "SelectionCriteria": {
         /* RetargetingConditionSelectionCriteria */
         "RetargetingConditionIDS": [
         "Logins": [

Parameters are described below.

RetargetingConditionRequest object
ActionAction: Get.Yes
SelectionCriteriaThe SelectionCriteria object, which contains criteria for selecting retargeting conditions to delete.Yes
RetargetingConditionSelectionCriteria object
RetargetingConditionIDSArray containing the IDs of retargeting conditions to perform the operation for.No

Array containing usernames of clients to perform the operation for.

For direct advertisers, this parameter is ignored.

  1. For advertisers: If the SelectionCriteria structure is empty, the operation will be performed for all the retargeting conditions.
  2. For agencies: At least one of the RetargetingConditionIDS or Logins parameters must be set. If both parameters are set, the operation will be performed for retargeting conditions that simultaneously meet both criteria: a condition ID set in the RetargetingConditionIDS array, and a username of the condition's owner that is set in the Logins array.

Output data

The output data structure in JSON is shown below.

   "data": {
      /* RetargetingConditionResponse */
      "RetargetingConditions": [
         {  /* RetargetingCondition */
            "IsAccessible": (string),
            "RetargetingConditionName": (string),
            "RetargetingConditionDescription": (string),
            "Login": (string),
            "RetargetingConditionID": (int),
            "RetargetingCondition": [
               {  /* RetargetingConditionItem */
                  "Type": (string),
                  "Goals": [
                     {  /* RetargetingConditionGoalItem */
                        "Time": (int),
                        "GoalID": (long)

Parameters are described below.

RetargetingConditionResponse object
RetargetingConditionsThe method returns an array of RetargetingCondition objects, each of which contains information about a retargeting condition.
RetargetingCondition object

Yes — all the goals and segments in the retargeting condition are available; No — the condition has an inaccessible goal or segment, and impressions are not possible for this condition.

A goal or segment becomes unavailable if it is deleted, or if the owner revokes access (see Managing tag access in the Help for Yandex.Metrica).

RetargetingConditionNameName of the retargeting condition (maximum 250 characters).
RetargetingConditionDescriptionText description of the retargeting condition (maximum 4096 characters).
LoginUsername of the condition's owner.
RetargetingConditionIDID of the retargeting condition.
RetargetingConditionArray of RetargetingConditionItem objects. Each object contains a group that describes the desired user behavior. If the retargeting condition has several groups, they are united with the logical AND operator (the condition is satisified if all the groups of goals are achieved).
RetargetingConditionItem object

Type of group:

  • all — The group is satisfied if all the goals and segments are met.
  • or — The group is satisfied if at least one of the goals or segments is met.
  • not — The group is satisfied if none of the goals or segments is met.

A retargeting condition that uses Yandex.Metrica segments or Yandex.Audience segments must contain at least one "all" or "or" type of group. A retargeting condition that consists solely of "not" groups can only use Yandex.Metrica goals.

GoalsArray of goals and segments (RetargetingConditionGoalItem objects).
RetargetingConditionGoalItem object

Number of days (from 1 to 90) for checking whether goals are completed or segments are matched.

GoalIDID of the goal or segment.

Examples of input data


   'Action': 'Get',
   'SelectionCriteria': {
      'Logins': ['agrom','larry']


   'Action' => 'Get',
   'SelectionCriteria' => array(
      'Logins' => array('agrom','larry')


   'Action' => 'Get',
   'SelectionCriteria' => {
      'Logins' => ['agrom','larry']