Documentation

Autotargeting

Autotargeting technology allows you to show ads for search queries that are related to the ad text and the page that it links to, without having to use keywords. You can only use autotargeting for serving ads in search results. 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).

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 Bids.set method to set the bid on search and the priority for the autotargeting.

When changing bids for all the keywords in an ad group or campaign, the Bids.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

The Keywords.get method allows you to get the same parameters for the autotargeting as for a keyword, except ContextBid, Productivity, and StatisticsNetwork. The value ---autotargeting is returned in the Keyword parameter.

The Bids.get method allows you to get the same parameters for the autotargeting as for a keyword, except ContextBid, ContextCoverage, AuctionBids, CompetitorsBids, CurrentSearchPrice, MinSearchPrice, and SearchPrices.

Statistics

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

FieldValue
Criteria, Criterion ---autotargeting
CriteriaId, CriterionIdID 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>