---
metadata:
  - name: generator
    content: Diplodoc Platform v5.55.0
alternate:
  - https://yandex.com/dev/direct/doc/en/audiencetargets/add.md
  - https://yandex.com/dev/direct/doc/ru/audiencetargets/add.md
  - href: ru/audiencetargets/add.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/ref-v5/audiencetargets/add.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# add

Создает условия нацеливания на аудиторию, назначает ставки и приоритеты для создаваемых условий нацеливания.

{% note alert %}

- Ставки и цены передаются через API Директа в виде **целых чисел**. Передаваемое значение представляет собой ставку или цену, **умноженную на 1 000 000**.

- Все ставки и цены указываются в валюте пользователя.

{% endnote %}


{% cut "Как применяются ставки и приоритеты" %}

Ставка или приоритет используются в зависимости от того, какая стратегия выбрана в кампании:
- Если в кампании настроена ручная стратегия, то используется параметр `ContextBid`.

- Если в кампании настроена автоматическая стратегия, то используется параметр `StrategyPriority`: объявления по условиям нацеливания на аудиторию с более высоким приоритетом по возможности получают больший объем трафика, а при недостатке бюджета отключаются в последнюю очередь.

В случае если **не указан параметр, соответствующий стратегии**, то будет сохранено значение по умолчанию.

- Если стратегия ручная, а ставка не указана, по умолчанию назначается минимальная ставка (зависит от валюты пользователя).

- Если стратегия автоматическая, а приоритет не указан, по умолчанию назначается средний приоритет.


В случае если **указан параметр, не соответствующий стратегии**, его значение будет сохранено.

- Если стратегия ручная, а указан приоритет, то в дальнейшем в момент смены стратегии на автоматическую заданное значение приоритета будет применено.

- Если стратегия автоматическая, а указана ставка, то это значение ставки **не будет применено**: в момент смены стратегии с автоматической на ручную будет задана ставка, подобранная автоматическим алгоритмом.

{% endcut %}


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

- [Условие нацеливания на аудиторию (AudienceTarget)](https://yandex.ru/dev/direct/doc/dg/objects/audience-target.html)


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

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

Прочие ограничения приведены в разделе [Ограничения](https://yandex.ru/dev/direct/doc/dg/objects/audience-target.html#restrictions).


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

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

```javascript translate=no
{
  "method": "add",
  "params": { /* params */
    "AudienceTargets": [{  /* AudienceTargetAddItem */
      "AdGroupId": (long), /* required */
      "RetargetingListId": (long),
      "InterestId": (long),
      "ContextBid": (long),
      "StrategyPriority": ( "LOW" | "NORMAL" | "HIGH" )
    }, ... ] /* required */
  }
}
```


#|
||
**Параметр**
|
**Тип**
|
**Описание**
|
**Обязательный**
||
||
**Структура params (для JSON) / AddRequest (для SOAP)**
|
>
|
>
|
>
||
||
`AudienceTargets`
|
array of AudienceTargetAddItem
|
Условия нацеливания на аудиторию, которые требуется добавить.
|
Да
||
||
**Структура AudienceTargetAddItem**
|
>
|
>
|
>
||
||
`AdGroupId`
|
long
|
Идентификатор группы, в которую добавляется условие нацеливания на аудиторию.
|
Да
||
||
`RetargetingListId`
|
long
|
Идентификатор условия ретаргетинга и подбора аудитории.

Область применения условия ретаргетинга должна соответствовать типу группы объявлений, см. [Область применения](https://yandex.ru/dev/direct/doc/dg/objects/retargeting-list.html#type).

Идентификатор должен быть уникален в рамках группы объявлений: не допускается наличие двух условий нацеливания с одинаковым идентификатором условия ретаргетинга и подбора аудитории.
|
Либо `RetargetingListId`, либо `InterestId`
||
||
`InterestId`
|
long
|
Идентификатор интереса к категории мобильных приложений.

Справочник интересов можно получить с помощью метода [Dictionaries](https://yandex.com/dev/direct/doc/ru/dictionaries/dictionaries.md).[get](https://yandex.com/dev/direct/doc/ru/dictionaries/get.md), указав в запросе имя справочника `Interests`. Допускаются только интересы, для которых в справочнике в параметре `IsTargetable` указано значение YES.

Параметр можно указывать только для групп объявлений с типом MOBILE_APP_AD_GROUP. Идентификатор должен быть уникален в рамках группы (не допускается наличие двух условий нацеливания с одинаковым идентификатором интереса).
|
^
||
||
`ContextBid`
|
long
|
Ставка в сетях, умноженная на 1 000 000. Целое число. Используется только для ручной стратегии.

<!-- source: ru/_includes/keywords/add/id-input/bid-limits-network.md -->
Указывается в валюте пользователя. Ограничения представлены в справочнике валют, который можно получить с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ru/dictionaries/dictionaries).[get](https://yandex.ru/dev/direct/doc/ru/dictionaries/get), указав в запросе имя справочника `Currencies`.
<!-- endsource: ru/_includes/keywords/add/id-input/bid-limits-network.md -->


Значение по умолчанию — минимальная ставка.

<!-- source: ru/_includes/bids/set/id-input/inage-ad-bid.md -->
{% note alert %}

Показ графического объявления возможен только при условии, что ставка не ниже минимальной ставки для объявления с включенным в него изображением.

{% endnote %}
<!-- endsource: ru/_includes/bids/set/id-input/inage-ad-bid.md -->
|
Нет
||
||
`StrategyPriority`
|
PriorityEnum
|
Приоритет условия нацеливания на аудиторию: LOW, NORMAL или HIGH. Используется только для автоматической стратегии.

Значение по умолчанию — NORMAL.
|
Нет
||
|# 


## Ответ {#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
|
Предупреждения, возникшие при выполнении операции.
||
||
`Errors`
|
array of ExceptionNotification
|
Ошибки, возникшие при выполнении операции.
||
|#