Autotargeting

Autotargeting technology allows you to serve ads without using keywords. For more information, see Autotargeting in the Help for Yandex.Direct.

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 groups with the type TEXT_AD_GROUP (autotargeting impressions are only available on search) and MOBILE_APP_AD_GROUP (impressions are available both on search and in ad networks).

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 try to add multiple autotargetings to the same group in the same request, an error is returned for each of the autotargetings. If you try to add autotargeting to an ad group that already has an autotargeting, it returns a warning and the parameters of the existing autotargeting do not change.

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 start and stop serving ads 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:

Field Value
Criteria, Criterion ---autotargeting
CriteriaId, CriterionId ID of the autotargeting.
CriteriaType AUTOTARGETING

To select data only for autotargeting, filter by CriteriaType:

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