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 one audience target in an ad group with the CPM_BANNER_AD_GROUP type and USER_PROFILE subtype.

You cannot add audience targets to an ad group that has the CPM_BANNER_AD_GROUP type and KEYWORDS subtype, or to the DYNAMIC_TEXT_AD_GROUP type of ad group.

Targeting by retargeting list

In the TEXT_AD_GROUP and MOBILE_APP_AD_GROUP types of ad groups, only audience targets that specify a retargeting list with the RETARGETING type and the FOR_TARGETS_AND_ADJUSTMENTS scope are allowed.

For an ad group with the CPM_BANNER_AD_GROUP type and the USER_PROFILE subtype, only audience targets that specify a retargeting list with the AUDIENCE type and the FOR_TARGETS_ONLY scope are allowed.

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.