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.

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

Targeting by 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.

For more information about retargeting lists, see the section Retargeting list (RetargetingList).

Targeting by mobile app interests

Targeting by audience interests is only available for mobile app ads.

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.get 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 in the Help for Yandex Direct.

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

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

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

Targeting by mobile app categories

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 reference list.

State of an audience target

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 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.
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 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.