Autotargeting

You can use autotargeting technology to serve ads without configuring keywords. The ad text and the landing page are matched to the search query, the user's interests, or the site content where it is served. For more information, see Autotargeting in Yandex Direct Help.

The autotargeting criteria are the same as for a keyword and have the same parameters (except that you can't edit the phrase).

Autotargeting can be used in TEXT_AD_GROUP and MOBILE_APP_AD_GROUP types of ad groups.

• When you use the AdGroups.add method, all created groups automatically include the ---autotargeting keyword.

• Ad groups served on Yandex Search or both Yandex Search and the Yandex Advertising Network, are created with autotargeting enabled. You will get a validation error if you try to disable it.

• In campaigns served in the Yandex Advertising Network, ad groups are created with autotargeting disabled. You can enable or disable this keyword as needed. To enable autotargeting in such a group:

  • Once an ad group is created, get the ---autotargeting keyword using the Keywords.get method and enable it using the Keywords.resume method.
  • Alternatively, you can get the ---autotargeting keyword using the Keywords.add method (this enables the previously disabled keyword).

• You can't delete the ---autotargeting keyword using the Keywords.delete method. When called, this method disables autotargeting in those campaigns where it is possible.

Add

Use the Keywords.add method to add autotargeting to an ad group. To do this, specify the special value ---autotargeting in the Keyword parameter.

You can only add one autotargeting to an ad group. If you add multiple autotargetings to an ad group in the same request, an error is returned for each autotargeting.

Edit

Use the Keywords.update method to change UserParam1 and UserParam2 for autotargeting. You can't change the Keyword parameter.

Set the bid

Use the KeywordBids.set method to set the bid and priority for autotargeting.

When changing bids for all the keywords in an ad group or campaign, the KeywordBids.setAuto method may affect the autotargeting bid. The method doesn't support setting the bid for autotargeting separately.

Pause, start, delete

The Keywords.suspend and Keywords.resume methods pause and resume impressions for autotargeting.

Use the Keywords.delete method to remove autotargeting from an ad group. You can add it again later.

Get

Use the Keywords.get method to get the same parameters for autotargeting as for a keyword. The value ---autotargeting is returned in the Keyword parameter.

Use the KeywordBids.get method to get the same parameters for the autotargeting as for a keyword, except Search.AuctionBids and Network.Coverage.

Statistics

Use the Reports service to get statistics on impressions and clicks for autotargeting. Autotargeting parameters are output to the following report fields:

To select data only for autotargeting, filter by CriteriaType:

<Filter>
  <Field>CriteriaType</Field>
  <Operator>EQUALS</Operator>
  <Values>AUTOTARGETING</Values>
</Filter>