Autotargeting
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
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
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>