---
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: ru/best-practice/auto-targeting.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/dg/best-practice/auto-targeting.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# Автотаргетинг

Технология автотаргетинга позволяет показывать объявления без использования ключевых фраз, если текст объявления и страница, на которую ведет ссылка, релевантны поисковому запросу, интересам пользователя или тематике площадки. Подробнее читайте в разделе [Автотаргетинг](https://yandex.ru/support/direct/features/autotargeting.html) Справки Директа.

Условие показа по автотаргетингу используется аналогично ключевой фразе и имеет такие же параметры (за исключением возможности редактировать текст фразы).

Автотаргетинг можно использовать в группах с типом `TEXT_AD_GROUP` и `MOBILE_APP_AD_GROUP`.

- При использовании метода [AdGroups.add](https://yandex.ru/dev/direct/doc/ref-v5/adgroups/add.html) все группы автоматически создаются с фразой `---autotargeting`.

- Группы объявлений с показами на Поиске или Поиске + РСЯ создаются с включенным автотаргетингом. Попытка его отключения вызовет ошибку валидации.

- Группы в кампаниях с показами в РСЯ создаются с отключенным автотаргетингом. Фразу можно включать и отключать. Чтобы включить автотаргетинг в такой группе:

     - После создания группы получите фразу `---autotargeting` с помощью метода [Keywords.get](https://yandex.ru/dev/direct/doc/ref-v5/keywords/get.html) и включите ее через [Keywords.resume](https://yandex.ru/dev/direct/doc/ref-v5/keywords/resume.html).
     - Либо добавьте фразу `---autotargeting` с помощью метода [Keywords.add](https://yandex.ru/dev/direct/doc/ref-v5/keywords/add.html) (это включит отключенную фразу).

- Фразу `---autotargeting` нельзя удалить с помощью метода [Keywords.delete](https://yandex.ru/dev/direct/doc/ref-v5/keywords/delete.html). Вызов метода приведет к отключению автотаргетинга (в кампаниях, где отключение автотаргетинга возможно).

## Добавление {#add}

Метод [Keywords.add](https://yandex.ru/dev/direct/doc/ref-v5/keywords/add.html) позволяет добавить автотаргетинг в группу объявлений. Для этого в параметре `Keyword` укажите специальное значение `---autotargeting`.

В группу объявлений можно добавить только один автотаргетинг. При попытке добавить несколько автотаргетингов в одну группу в одном запросе возвращается ошибка для каждого из автотаргетингов.

## Изменение {#update}

Метод [Keywords.update](https://yandex.ru/dev/direct/doc/ref-v5/keywords/update.html) позволяет изменить параметры автотаргетинга `UserParam1` и `UserParam2`. Параметр `Keyword` недоступен для изменения.

## Назначение ставки {#set}

Метод [KeywordBids.set](https://yandex.ru/dev/direct/doc/ref-v5/keywordbids/set.html) позволяет назначить автотаргетингу ставку и приоритет.

Метод [KeywordBids.setAuto](https://yandex.ru/dev/direct/doc/ref-v5/keywordbids/setAuto.html) при обновлении ставок для всех фраз группы объявлений или кампании может повлиять на ставку для автотаргетинга. Метод не поддерживает назначение ставки отдельному автотаргетингу.

## Остановка, запуск, удаление {#suspend}

Методы [Keywords.suspend](https://yandex.ru/dev/direct/doc/ref-v5/keywords/suspend.html) и [Keywords.resume](https://yandex.ru/dev/direct/doc/ref-v5/keywords/resume.html) останавливают и запускают показы по автотаргетингу.

Метод [Keywords.delete](https://yandex.ru/dev/direct/doc/ref-v5/keywords/delete.html) позволяет удалить из группы объявлений автотаргетинг. В дальнейшем его можно будет снова добавить.

## Получение {#get}

Метод [Keywords.get](https://yandex.ru/dev/direct/doc/ref-v5/keywords/get.html) позволяет получить для автотаргетинга те же параметры, что и для ключевой фразы. В параметре `Keyword` возвращается значение `---autotargeting`.

Метод [KeywordBids.get](https://yandex.ru/dev/direct/doc/ref-v5/keywordbids/get.html) позволяет получить для автотаргетинга те же параметры, что и для ключевой фразы, кроме `Search.AuctionBids` и `Network.Coverage`.


## Статистика {#stat}

Сервис `Reports` позволяет получать статистику показов и кликов для автотаргетинга. Параметры автотаргетинга выводятся в следующих полях отчета:

#|
||
**Поле**
|
**Значение**
||
||
`Criteria`, `Criterion`
|
`---autotargeting`
||
||
`CriteriaId`, `CriterionId`
|
Идентификатор автотаргетинга.
||
||
`CriteriaType`
|
AUTOTARGETING
||
|#

Чтобы отбирать данные только по автотаргетингу, используйте фильтр по `CriteriaType`:

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