Autotargeting

Attention.

Autotargeting for campaigns with the TextCampaign type underwent the following changes:

  • When using the adgroups.add method, all ad groups are automatically created with the keyword ---autotargeting.
    • Ad groups in new campaigns served in Search or Search + YAN and created after September 28, 2023, are created with autotargeting enabled. Attempting to disable it will lead to a validation error.
    • Ad groups in old campaigns served in Search or Search + YAN and created before September 28, 2023, are created with autotargeting disabled. Eventually, autotargeting will become a required setting for them as well. We'll warn you in advance when that happens.
    • Ad groups in campaigns served in the YAN are created with autotargeting disabled. You can enable and disable the keyword.
  • Added a disabled keyword ---autotargeting to all existing ad groups that didn't have it before.

  • You can't remove the ---autotargeting keyword using the keywords.delete method. Calling disables autotargeting, assuming it can be disabled for the campaign.

  • To add autotargeting to an ad group:

    • After creating a group, get the---autotargeting keyword using the keywords.get method, then enable it using keywords.resume.
    • Alternatively, add the ---autotargeting keyword using the keywords.add method (this enables the disabled keyword).

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 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 TEXT_AD_GROUP and MOBILE_APP_AD_GROUP types of ad groups.

Add

Use the Keywords.add method to add autotargeting to an ad group. To do so, 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 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 autotargeting as for a keyword, with the exception of 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
Field Value
Criteria, Criterion ---autotargeting
CriteriaId, CriterionId ID of the autotargeting.
CriteriaType AUTOTARGETING

To only select data for autotargeting, filter by CriteriaType:

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