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

# Условие нацеливания на аудиторию (AudienceTarget)

Условие нацеливания на аудиторию позволяет показывать объявления пользователям, отвечающим заданному критерию. Условие нацеливания на аудиторию связывает группу объявлений либо с условием ретаргетинга и подбора аудитории, либо с интересом к категории мобильных приложений. Для условия нацеливания на аудиторию можно задать ставку и/или приоритет.


{% note alert %}

Показы по условиям нацеливания на аудиторию возможны только в сетях (Рекламной сети Яндекса и внешних сетях).

{% endnote %}



## Таргетинг по условию ретаргетинга и подбора аудитории  {#retargeting-list}

Объявления могут быть показаны пользователям, отвечающим условию ретаргетинга и подбора аудитории. Для этого в условии нацеливания на аудиторию необходимо указать идентификатор группы `AdGroupId` и идентификатор условия ретаргетинга и подбора аудитории `RetargetingListId`.

Одно и то же условие ретаргетинга и подбора аудитории можно использовать в нескольких условиях нацеливания, привязанных к разным группам объявлений.

![retargeting](../_images/retargeting.png)

Подробнее об условиях ретаргетинга и подбора аудитории читайте в разделе [Условие ретаргетинга и подбора аудитории (RetargetingList)](https://yandex.ru/dev/direct/doc/ru/objects/retargeting-list.md).


## Таргетинг по интересам к мобильным приложениям {#interest}

Таргетинг по интересам доступен только для продвижения мобильных приложений.

Объявления могут быть показаны пользователям, которые проявляли интерес к заданной категории мобильных приложений. Для этого в условии нацеливания необходимо указать идентификатор группы `AdGroupId` и идентификатор интереса `InterestId`.

Справочник интересов можно получить с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/get.html), указав в запросе имя справочника `Interests`.

Подробнее о таргетинге по интересам читайте в разделе [Таргетинг по интересам к мобильным приложениям](https://yandex.ru/support/direct/mobile/interest-targeting.html) Справки Директа.


## Сервис {#service}

Для управления условиями нацеливания на аудиторию предназначен сервис [AudienceTargets](https://yandex.ru/dev/direct/doc/ref-v5/audiencetargets/audiencetargets.html).

### Методы {#methods}

[add](https://yandex.ru/dev/direct/doc/ref-v5/audiencetargets/add.html) | [delete](https://yandex.ru/dev/direct/doc/ref-v5/audiencetargets/delete.html) | [suspend](https://yandex.ru/dev/direct/doc/ref-v5/audiencetargets/suspend.html) | [resume](https://yandex.ru/dev/direct/doc/ref-v5/audiencetargets/resume.html) | [get](https://yandex.ru/dev/direct/doc/ref-v5/audiencetargets/get.html) | [setBids](https://yandex.ru/dev/direct/doc/ref-v5/audiencetargets/setBids.html)


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

Не более 50 условий нацеливания на аудиторию в группе объявлений с типом TEXT_AD_GROUP и MOBILE_APP_AD_GROUP.

Не более 1 условия нацеливания на аудиторию с типом AUDIENCE в группе объявлений с типом TEXT_AD_GROUP.

Не более 1 условия нацеливания на аудиторию в группе объявлений с типом CPM_BANNER_AD_GROUP и подтипом USER_PROFILE.

Не более 1 условия нацеливания на аудиторию в группе объявлений с типом CPM_VIDEO_AD_GROUP.

### Таргетинг по условию ретаргетинга и подбора аудитории {#restrictions-retarget-list}

Условия нацеливания на аудиторию по условию ретаргетинга могут быть добавлены в группы объявлений, тип которых указан в параметре `AvailableForTargetsInAdGroupTypes` условия ретаргетинга.

Не допускается добавление условий нацеливания на аудиторию в группу объявлений с типом CPM_BANNER_AD_GROUP и подтипом KEYWORDS.

### Таргетинг по интересам к мобильных приложениям {#restrictions-mobile-app-cats}

Условия нацеливания на аудиторию по интересам могут быть добавлены только в группу объявлений с типом MOBILE_APP_AD_GROUP.

Допускаются только интересы, для которых в справочнике в параметре `IsTargetable` указано значение YES.


## Состояние условия нацеливания на аудиторию {#state}

Параметр `State` отражает текущее состояние показов по условию нацеливания на аудиторию.


#|
||
**Состояние**
|
**Описание**
||
||
ON
|
Показы объявлений по условию нацеливания на аудиторию возможны.
||
||
SUSPENDED
|
Показы по условию нацеливания на аудиторию остановлены владельцем (с помощью метода [suspend](https://yandex.ru/dev/direct/doc/ref-v5/audiencetargets/suspend.html) или в веб-интерфейсе).
||
||
UNKNOWN
|
Неизвестное состояние. Используется для обеспечения обратной совместимости и отображения состояний, не поддерживаемых в данной версии API.
||
|#

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

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