---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.ru/dev/direct/doc/en/retargetinglists/add.md
  - https://yandex.ru/dev/direct/doc/ru/retargetinglists/add.md
sourcePath: ru/ref-v5/retargetinglists/add.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt

# add

Создает условия ретаргетинга и подбора аудитории.

## Узнайте больше

- [Условие ретаргетинга и подбора аудитории (RetargetingList)](https://yandex.ru/dev/direct/doc/dg/objects/retargeting-list.html)

## Ограничения {#restrictions}

Одному пользователю может принадлежать не более 2000 условий ретаргетинга и подбора аудитории.

Не более 1000 условий ретаргетинга и подбора аудитории в одном вызове метода.


## Запрос {#input}

Структура запроса в формате JSON:

```javascript translate=no
{
  "method": "add",
  "params": { /* params */
    "RetargetingLists": [{  /* RetargetingListAddItem */
      "Type": ( RETARGETING | AUDIENCE ),
      "Name": (string), /* required */
      "Description": (string),
      "Rules": [{  /* RetargetingListRuleItem */
        "Arguments": [{  /* RetargetingListRuleArgumentItem */
           "MembershipLifeSpan": (int),
           "ExternalId": (long) /* required */
        }, ... ], /* required */
        "Operator": ( "ALL" | "ANY" | "NONE" ) /* required */
      }, ... ] /* required */
    }, ... ] /* required */
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||

||
**Структура params (для JSON) / AddRequest (для SOAP)**
||
||
`RetargetingLists`
|
array of RetargetingListAddItem
|
Условия ретаргетинга и подбора аудитории, которые требуется добавить.
|
Да
||

||
**Структура RetargetingListAddItem**
||
||
`Type`
|
RetargetingListTypeEnum
|
Тип условия ретаргетинга и подбора аудитории. См. раздел [Тип условия ретаргетинга и подбора аудитории](https://yandex.ru/dev/direct/doc/dg/objects/retargeting-list.html).

Значение по умолчанию — RETARGETING.
|
Нет
||
||
`Name`
|
string
|
Название условия ретаргетинга и подбора аудитории (не более 250 символов).
|
Да
||
||
`Description`
|
string
|
Текстовое примечание к условию ретаргетинга и подбора аудитории (не более 4096 символов).
|
Нет
||
||
`Rules`
|
array of RetargetingListRuleItem
|
Правила отбора посетителей сайта. Посетитель удовлетворяет условию ретаргетинга и подбора аудитории, если для него выполнены одновременно все правила.
Ограничения на правила отбора и примеры структуры приведены в разделе [Правила отбора пользователей](https://yandex.ru/dev/direct/doc/dg/objects/retargeting-list.html).
|
Да
||

||
**Структура RetargetingListRuleItem**
||
||
`Arguments`
|
array of RetargetingListRuleArgumentItem
|
Цели и сегменты.

См. раздел [Цели и сегменты](https://yandex.ru/dev/direct/doc/dg/objects/retargeting-list.html).
|
Да
||
||
`Operator`
|
RetargetingListRuleOperatorEnum
|
Логический оператор правила отбора:

- ALL — правило выполнено, если пользователь выполнил все цели и входит во все сегменты;

- ANY — правило выполнено, если пользователь выполнил хотя бы одну из целей или входит хотя бы в один из сегментов;

- NONE — правило выполнено, если пользователь не выполнил ни одну из целей и не входит ни в один из сегментов.
|
Да
||

||
**Структура RetargetingListRuleArgumentItem**
||
||
`MembershipLifeSpan`
|
int
|
Количество дней (от 1 до 540), за которое проверяется выполнение цели.

Для сегментов Яндекс Метрики и сегментов Яндекс Аудиторий параметр не используется, переданное значение игнорируется.
|
Для целей Яндекс Метрики
||
||
`ExternalId`
|
long
|
Идентификатор цели или сегмента.

Для сегментов по [интересам пользователя](https://yandex.ru/support/direct/ru/products-cpm-campaign/display-ads-settings#user-interests) необходимо перед идентификатором указать тип интереса с помощью префикса:

- 10 — краткосрочный интерес;
- 20 — долгосрочный интерес;
- 30 — любой интерес.

Например, идентификатору сегмента `2499001105` при долгосрочном интересе будет соответствовать `ExternalId``202499001105`.
|
Да
||
|# 


## Ответ {#output}

Структура ответа в формате JSON:

```javascript translate=no
{
  "result": { /* result */
    "AddResults": [{  /* ActionResult */
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ]
    }, ... ]
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
||

||
**Структура result (для JSON) / AddResponse (для SOAP)**
||
||
`AddResults`
|
array of ActionResult
|
Результаты добавления условий ретаргетинга и подбора аудитории.
||

||
**Структура ActionResult**
||
||
`Id`
|
long
|
Идентификатор созданного условия ретаргетинга и подбора аудитории. Возвращается в случае отсутствия ошибок, см. раздел [Операции над массивом объектов](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html).
||
||
`Warnings`
|
array of [ExceptionNotification](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html)
|
Предупреждения, возникшие при выполнении операции.
||
||
`Errors`
|
array of [ExceptionNotification](https://yandex.ru/dev/direct/doc/dg/best-practice/modify.html)
|
Ошибки, возникшие при выполнении операции.
||
|#