Dynamic feed ad target (DynamicFeedAdTarget). Yandex Direct API. Version 5

Dynamic feed ad target (DynamicFeedAdTarget)

A dynamic ad target defines the set of the advertiser's website pages that ads are dynamically generated for. For more information about dynamic ads, see the section Dynamic ads in the Help for Yandex Direct.

Service

Use the DynamicFeedAdTargets service to manage targets for dynamic ads.

Methods

Dynamic text ad targets can't be edited. If you need to change a dynamic text ad target, you must delete it and create a new one.

Restrictions

A dynamic text ad target can only be added to the DYNAMIC_TEXT_AD_GROUP type of ad group.

Maximum of 50 dynamic ad targets per group.

Type of product offer selection

There are two types of selection:

ITEMS_ALL — “Select all”.

Dynamic ads will be generated for all product offers from your feed.
ITEMS_SUBSET — “A group of pages”.

The filter contains up to 10 selection rules. Dynamic ads are generated only for those product offers that meet all the selection rules at the same time.

Note. For the Yandex Realty feed and Flights feed in Google Ads, only the ITEMS_ALL type is available.

Selection rule

A rule for page selection consists of three parameters:

Operand — The feed field.
Operator — The comparison operator.
Arguments — An array of values to compare the field value in the feed with.

For a description of the fields for each type of feed, see Configuring filters in the Help for Yandex Direct.

The compatibility of feed fields and operators depends on the feed:

Retail sales, other business: Yandex Market feed


Feed field	Operators	Restrictions on values
categoryId	GREATER_THAN, LESS_THAN	One number
	EQUALS_ANY	Up to 20,000 numbers
	RANGE	Max 10 ranges. See example.
id	GREATER_THAN, LESS_THAN	One number
	EQUALS_ANY	Max 50 numbers
	RANGE	Max 10 ranges. See example.
market_category typePrefix vendor	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
market_category typePrefix vendor	EXISTS	Pass the value 1
description model name	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
url	EQUALS,CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
oldprice price	GREATER_THAN, LESS_THAN	Single number, up to 2 decimal places
	EQUALS_ANY	Max 50 numbers, up to 2 decimal places
	RANGE	Max 10 ranges, up to 2 decimal places. See the example.
	EXISTS	Pass the value 1
adult manufacturer_warranty pickup store	EQUALS_ANY	Acceptable values: 0 1
adult manufacturer_warranty pickup store	EXISTS	Pass the value 1
age	EQUALS_ANY	Acceptable values: integer from 0 to 12, 16, or 18.
age	EXISTS	Pass the value 1


Feed field	Operators	Restrictions on values
categoryId	GREATER_THAN, LESS_THAN	One number
	EQUALS_ANY	Up to 20,000 numbers
	RANGE	Max 10 ranges. See example.
id	GREATER_THAN, LESS_THAN	One number
	EQUALS_ANY	Max 50 numbers
	RANGE	Max 10 ranges. See example.
market_category typePrefix vendor	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
market_category typePrefix vendor	EXISTS	Pass the value 1
description model name	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
url	EQUALS,CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
oldprice price	GREATER_THAN, LESS_THAN	Single number, up to 2 decimal places
	EQUALS_ANY	Max 50 numbers, up to 2 decimal places
	RANGE	Max 10 ranges, up to 2 decimal places. See the example.
	EXISTS	Pass the value 1
adult manufacturer_warranty pickup store	EQUALS_ANY	Acceptable values: 0 1
adult manufacturer_warranty pickup store	EXISTS	Pass the value 1
age	EQUALS_ANY	Acceptable values: integer from 0 to 12, 16, or 18.
age	EXISTS	Pass the value 1

Hotels: Google Ads "Hotels and rentals" feed


Feed field	Operators	Restrictions on values
Rsis	GREATER_THAN, LESS_THAN	Single number, up to 2 decimal places
	EQUALS_ANY	Max 50 numbers, up to 2 decimal places
	RANGE	Max 10 ranges, up to 2 decimal places. See the example.
Description max_score name location url	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
class	EQUALS_ANY	Acceptable values: 1 2 3 4 5
class	EXISTS	Pass the value 1
OfferID Score	GREATER_THAN, LESS_THAN	Single integer
	EQUALS_ANY	Max 50 integers
	RANGE	Max 10 ranges or integers. See the example.


Feed field	Operators	Restrictions on values
Rsis	GREATER_THAN, LESS_THAN	Single number, up to 2 decimal places
	EQUALS_ANY	Max 50 numbers, up to 2 decimal places
	RANGE	Max 10 ranges, up to 2 decimal places. See the example.
Description max_score name location url	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
class	EQUALS_ANY	Acceptable values: 1 2 3 4 5
class	EXISTS	Pass the value 1
OfferID Score	GREATER_THAN, LESS_THAN	Single integer
	EQUALS_ANY	Max 50 integers
	RANGE	Max 10 ranges or integers. See the example.

Automobiles: Auto.ru feed


Feed field	Operators	Restrictions on values
body_type color folder_id mark_id	CONTAINS_ANY, NOT_CONTAINS_ALL,	Max 50 lines, max 175 characters per line
wheel	CONTAINS_ANY	Recommended values: left right
metallic	EQUALS_ANY	Recommended values: yes none
availability	EQUALS_ANY	Recommended values: in stock on order
year	EQUALS_ANY	Max 10 numbers
url	CONTAINS_ANY, NOT_CONTAINS_ALL, EQUALS_ANY	Max 50 lines, max 175 characters per line
price	GREATER_THAN, LESS_THAN	Single integer
	EQUALS_ANY	Max 50 integers
	RANGE	Max 10 ranges. See example.


Feed field	Operators	Restrictions on values
body_type color folder_id mark_id	CONTAINS_ANY, NOT_CONTAINS_ALL,	Max 50 lines, max 175 characters per line
wheel	CONTAINS_ANY	Recommended values: left right
metallic	EQUALS_ANY	Recommended values: yes none
availability	EQUALS_ANY	Recommended values: in stock on order
year	EQUALS_ANY	Max 10 numbers
url	CONTAINS_ANY, NOT_CONTAINS_ALL, EQUALS_ANY	Max 50 lines, max 175 characters per line
price	GREATER_THAN, LESS_THAN	Single integer
	EQUALS_ANY	Max 50 integers
	RANGE	Max 10 ranges. See example.

Realty: Yandex Realty feed

This feed doesn't use selection rules.

Flights: Google Ads "Flights" feed

This feed doesn't use selection rules.

Other business: universal feed


Feed field	Operators	Restrictions on values
url	EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
description name	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
description name	EXISTS	Pass the value 1
price oldprice	GREATER_THAN, LESS_THAN	Single number, up to 2 decimal places
	EQUALS_ANY	Max 50 numbers, up to 2 decimal places
	RANGE	Max 10 ranges, up to 2 decimal places. See the example.


Feed field	Operators	Restrictions on values
url	EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
description name	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
description name	EXISTS	Pass the value 1
price oldprice	GREATER_THAN, LESS_THAN	Single number, up to 2 decimal places
	EQUALS_ANY	Max 50 numbers, up to 2 decimal places
	RANGE	Max 10 ranges, up to 2 decimal places. See the example.

Other business: Google Ads "Custom" feed


Feed field	Operators	Restrictions on values
category description name second_title	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
category description name second_title	EXISTS	Pass the value 1
url	EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
price sale_price	GREATER_THAN, LESS_THAN	One number, up to two decimal places
	IN_RANGE	Max 10 ranges, up to two decimal places
	EQUALS_ANY	Max 50 values, up to two decimal places


Feed field	Operators	Restrictions on values
category description name second_title	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
category description name second_title	EXISTS	Pass the value 1
url	EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
price sale_price	GREATER_THAN, LESS_THAN	One number, up to two decimal places
	IN_RANGE	Max 10 ranges, up to two decimal places
	EQUALS_ANY	Max 50 values, up to two decimal places

Other business: Google Ads "Travel" feed


Feed field	Operators	Restrictions on values
Category destination origin Title	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
Category destination origin Title	EXISTS	Pass the value 1
url	EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
price sale_price	GREATER_THAN, LESS_THAN	One number, up to two decimal places
	IN_RANGE	Max 10 ranges, up to two decimal places
	EQUALS_ANY	Max 50 numbers, up to two decimal places


Feed field	Operators	Restrictions on values
Category destination origin Title	CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
Category destination origin Title	EXISTS	Pass the value 1
url	EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL	Max 50 lines, max 175 characters per line
price sale_price	GREATER_THAN, LESS_THAN	One number, up to two decimal places
	IN_RANGE	Max 10 ranges, up to two decimal places
	EQUALS_ANY	Max 50 numbers, up to two decimal places

Examples

The value contains one of the specified rows

{
  "Operand": "mark_id",
  "Operator": "CONTAINS_ANY",
  "Arguments": ["Audi","Opel"]
}

Range: price from 111 to 222 or 3000 to 10000

{
  "Operand": "price",
  "Operator": "IN_RANGE",
  "Arguments": ["111-222", "3000-10000"]
}

Value from the list

{
  "Operand": "wheel",
  "Operator": "EQUALS_ANY",
  "Arguments": ["left"]
}

State of dynamic text ad targets

The State parameter reflects the current state of displays for a dynamic ad target.


State	Description
ON	Ad impressions are possible by target.
OFF	The dynamic ad target isn't in use.
SUSPENDED	Impressions by target for dynamic ads were stopped by the owner (using the suspend method, or in the web interface).
DELETED	The ad target for dynamic ads was deleted by the owner. Note. The get method returns a dynamic text ad target in the DELETED state only if the States parameter is set to DELETED or the ID of this target is specified in the Ids parameter. If both the Ids and States parameters are omitted, the method doesn't return dynamic text ad targets in the DELETED state.
UNKNOWN	Unknown state. Used for providing backward compatibility and displaying states that are not supported in this version of the API.


State	Description
ON	Ad impressions are possible by target.
OFF	The dynamic ad target isn't in use.
SUSPENDED	Impressions by target for dynamic ads were stopped by the owner (using the suspend method, or in the web interface).
DELETED	The ad target for dynamic ads was deleted by the owner. Note. The get method returns a dynamic text ad target in the DELETED state only if the States parameter is set to DELETED or the ID of this target is specified in the Ids parameter. If both the Ids and States parameters are omitted, the method doesn't return dynamic text ad targets in the DELETED state.
UNKNOWN	Unknown state. Used for providing backward compatibility and displaying states that are not supported in this version of the API.

Was the article useful?

Please tell us what you didn't like about this article:

Filter — targeting criteria for smart banners (SmartAdTarget)

Ad target for dynamic ads (DynamicTextAdTarget — Webpage)

Contents

Service Restrictions Type of product offer selection Selection rule State of dynamic text ad targets

Filter — targeting criteria for smart banners (SmartAdTarget)

Ad target for dynamic ads (DynamicTextAdTarget — Webpage)