---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/concepts/retargeting.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/retargeting.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# Ретаргетинг (Retargeting)

Объект Ретаргетинг (Retargeting) определяет настройки показа объявлений пользователям, которые уже проявляли интерес к товарам и услугам рекламодателя.

В версии Live 4 для объявлений можно задать несколько условий ретаргетинга в дополнение к фразам или вместо них. Подробная информация о ретаргетинге приведена в разделе [Показы по условиям ретаргетинга](https://yandex.ru/support/direct/features/retargeting.xml) помощи Директа.

## Цели и сегменты

Для настройки ретаргетинга используются цели и сегменты, настроенные в Яндекс Метрике (см. раздел [Цели и конверсии](https://yandex.ru/support/metrika/general/goals.xml) и раздел [Сегментация](https://yandex.ru/support/metrika/reports/report-general.xml#segmentation), а также сегменты, настроенные в Яндекс Аудиториях (см. [помощь](https://yandex.ru/support/audience/) Яндекс Аудиторий).

Для получения списка доступных целей и сегментов предназначен метод [GetRetargetingGoals (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetRetargetingGoals.md).

## Условие ретаргетинга {#ret-condition}

Объект Условие ретаргетинга (RetargetingCondition) содержит условие показа объявлений пользователям.

Условие ретаргетинга содержит одну или несколько групп (массив RetargetingCondition), объединенных логическим оператором И (условие выполнено, если выполнены все группы).

Каждая группа содержит одну или несколько целей или сегментов (массив Goals) и тип условия (параметр Type), при котором группа выполнена:

- or — «Выполнено хотя бы одно»;
- all — «Выполнены все»;
- not — «Не выполнено ни одного».

![](../_assets/retargeting-condition.png)

Следующая структура показывает параметры условия ретаргетинга.

```javascript
{
   "RetargetingConditionID": (int),
   "RetargetingConditionName": (string),
   "RetargetingConditionDescription": (string),
   "Login": (string),
   "RetargetingCondition": [
     {  /* RetargetingConditionItem */
        "Type": (string),
        "Goals": [
           {  /* RetargetingConditionGoalItem */
              "Time": (int),
              "GoalID": (long)
           }
           ...
        ] 
     } 
     ...
   ]
}
```
Для работы с условиями ретаргетинга предназначен метод [RetargetingCondition (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/RetargetingCondition.md).

## Ретаргетинг для групп объявлений {#ret-params}

Для связи объявлений с условиями ретаргетинга предназначен объект Ретаргетинг (Retargeting). Настройки ретаргетинга являются общими для [группы объявлений](https://yandex.com/dev/direct/doc/dg-v4/ru/concepts/ad-group.md).

![](../_assets/retargeting.png)

Следующая структура показывает параметры ретаргетинга.

```javascript
{
   "RetargetingID": (int),
   "AdID": (int),
   "RetargetingConditionID": (int),
   "ContextPrice": (float),
   "AutoBudgetPriority": (string),
   "StatusPaused": (string)
}
```

В ретаргетинге можно использовать только условие ретаргетинга, содержащее по крайней мере одну группу с типом all или or.

Для работы с параметрами ретаргетинга предназначен метод [Retargeting (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/Retargeting.md).