---
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: en/dg/objects/audience-target.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/en/llms.txt

# Audience targets (AudienceTarget)

Audience targets allow you to display ads to users who meet the specified criteria. Audience targets link an ad group to either a retargeting list or audience interest in a mobile app category. You can set a bid and/or priority for an audience target.


{% note alert %}

Displays for audience targets are only available in ad networks (the Yandex Advertising Network and external networks).

{% endnote %}



## Targeting by retargeting list  {#retargeting-list}

Ads can be shown to users who meet the criteria in a retargeting list. To do this, the audience target should specify the ad group (`AdGroupId`) and the retargeting list (`RetargetingListId`).

You can use the same retargeting list in multiple audience targets that are assigned to different groups of ads.

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

For more information about retargeting lists, see the section [Retargeting list (RetargetingList)](https://yandex.ru/dev/direct/doc/en/objects/retargeting-list.md).


## Targeting by app category {#interest}

Targeting by audience interests is only available for app promotion.

Ads can be shown to users who are interested in a specific category of mobile apps. To do this, the audience target should specify the ad group (`AdGroupId`) and the interest (`InterestId`).

To get the list of app categories, use the [Dictionaries](https://yandex.com/dev/direct/doc/dictionaries/dictionaries.html).[get](https://yandex.com/dev/direct/doc/dictionaries/get.html) method and specify the dictionary name `Interests` in the request.

For more information about targeting ads by audience interests, see [Targeting by mobile app interests](https://yandex.com/support/direct/en/mobile/interest-targeting.html) in Yandex Direct Help.


## Service {#service}

Use the [AudienceTargets](https://yandex.com/dev/direct/doc/audiencetargets/audiencetargets.html) service for managing audience targets.

### Methods {#methods}

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


## Restrictions {#restrictions}

Maximum of 50 audience targets in the TEXT_AD_GROUP and MOBILE_APP_AD_GROUP types of ad groups.

Maximum of 1 audience targeting criteria with the AUDIENCE type in a TEXT_AD_GROUP type of ad group.

Maximum of one audience target in an ad group with the CPM_BANNER_AD_GROUP type and USER_PROFILE subtype.

Maximum of one audience target in an ad group with the CPM_VIDEO_AD_GROUP type.

### Targeting by retargeting list {#restrictions-retarget-list}

Audience targeting criteria based on retargeting criteria can be added to the types of ad groups that are specified in the `AvailableForTargetsInAdGroupTypes` parameter for retargeting.

You can't add audience targeting criteria to CPM_BANNER_AD_GROUP ad groups with the KEYWORDS subtype.

### Targeting by mobile app categories {#restrictions-mobile-app-cats}

Audience targets by interests (mobile app categories) can only be added to an ad group with the  MOBILE_APP_AD_GROUP type.

You can only use interests that have the `IsTargetable` parameter set to YES in the dictionary.


## State of an audience target {#state}

The `State` parameter reflects the current state of displays for the audience target.


#|
||
**State**
|
**Description**
||
||
ON
|
Ads can be served for an audience target.
||
||
SUSPENDED
|
Ad serving for the audience target was stopped by the owner (using the [suspend](https://yandex.com/dev/direct/doc/audiencetargets/suspend.html) method, or in the web interface).
||
||
UNKNOWN
|
Unknown state. Used for providing backward compatibility and displaying states that are not supported in this version of the API.
||
|#

### Learn more

- [Retargeting list (RetargetingList)](https://yandex.ru/dev/direct/doc/en/objects/retargeting-list.md)