---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/best-practice/auto-targeting.md
  - https://yandex.com/dev/direct/doc/ru/best-practice/auto-targeting.md
  - href: en/best-practice/auto-targeting.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/dg/best-practice/auto-targeting.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt

# 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](https://yandex.com/support/direct/features/autotargeting.html) 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](https://yandex.com/dev/direct/doc/adgroups/add.html) 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](https://yandex.com/dev/direct/doc/keywords/get.html) method and enable it using the [Keywords.resume](https://yandex.com/dev/direct/doc/keywords/resume.html) method.
     - Alternatively, you can get the `---autotargeting` keyword using the [Keywords.add](https://yandex.com/dev/direct/doc/keywords/add.html) method (this enables the previously disabled keyword).

- You can't delete the `---autotargeting` keyword using the [Keywords.delete](https://yandex.com/dev/direct/doc/keywords/delete.html) method. When called, this method disables autotargeting in those campaigns where it is possible.

## Add{#add}

Use the [Keywords.add](https://yandex.com/dev/direct/doc/keywords/add.html) 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{#update}

Use the [Keywords.update](https://yandex.com/dev/direct/doc/keywords/update.html) method to change `UserParam1` and `UserParam2` for autotargeting. You can't change the `Keyword` parameter.

## Set the bid{#set}

Use the [KeywordBids.set](https://yandex.com/dev/direct/doc/keywordbids/set.html) 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](https://yandex.com/dev/direct/doc/keywordbids/setAuto.html) method may affect the autotargeting bid.  The method doesn't support setting the bid for autotargeting separately.

## Pause, start, delete{#suspend}

The [Keywords.suspend](https://yandex.com/dev/direct/doc/keywords/suspend.html) and [Keywords.resume](https://yandex.com/dev/direct/doc/keywords/resume.html) methods pause and resume impressions for autotargeting.

Use the [Keywords.delete](https://yandex.com/dev/direct/doc/keywords/delete.html) method to remove autotargeting from an ad group.  You can add it again later.

## Get{#get}

Use the [Keywords.get](https://yandex.com/dev/direct/doc/keywords/get.html) 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](https://yandex.com/dev/direct/doc/keywordbids/get.html) method to get the same parameters for the autotargeting as for a keyword, except `Search.AuctionBids` and `Network.Coverage`.


## Statistics{#stat}

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`:

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