---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
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
  - href: en/concepts/retargeting.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/en/llms.txt

# Retargeting

The Retargeting object defines settings for displaying ads to users who have already shown interest in the advertiser's products or services.

In the Live 4 version, an ad can have several retargeting conditions set for it, either in addition to keywords or instead of them. For more information about retargeting, see [Retargeting impressions](https://yandex.com/support/direct/features/retargeting.xml) in the Help for Yandex Direct.

## Goals and segments

To configure a retargeting, use goals and segments set up in Yandex Metrica (see [Goals and conversions](https://yandex.com/support/metrika/general/goals.xml) and [Segmentation](https://yandex.com/support/metrika/reports/report-general.xml#segmentation) in the Help for Yandex Metrica), and segments from Yandex Audience (see the [Help](https://yandex.com/support/audience/) for Yandex Audience).

To get a list of available goals and segments, use the `GetRetargetingGoals` (Live) method.

## Retargeting condition {#ret-condition}

The `RetargetingCondition` object contains a condition for displaying ads to users.

The retargeting condition contains one or more groups (the `RetargetingCondition` array) that are grouped by the logical AND operator (the condition is met if all the groups are satisfied).

Each group contains one or more goals or segments (the `Goals` array) and the type of condition (the `Type` parameter) for which the group is satisfied:

- or — "At least one";
- all — "All";
- not — "None".

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

The following structure shows the parameters for retargeting conditions.

```javascript
{
   "RetargetingConditionID": (int),
   "RetargetingConditionName": (string),
   "RetargetingConditionDescription": (string),
   "Login": (string),
   "RetargetingCondition": [
     {  /* RetargetingConditionItem */
        "Type": (string),
        "Goals": [
           {  /* RetargetingConditionGoalItem */
              "Time": (int),
              "GoalID": (long)
           }
           ...
        ] 
     } 
     ...
   ]
}
```

To work with retargeting conditions, use the method [RetargetingCondition (Live)](https://yandex.com/dev/direct/doc/dg-v4/en/live/RetargetingCondition.md).

## Retargeting for ad groups {#ret-params}

The Retargeting object is used for associating an ad with retargeting conditions. Retargeting settings are shared across an [ad group](https://yandex.com/dev/direct/doc/dg-v4/en/concepts/ad-group.md).

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

The following structure shows the retargeting parameters.

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

A retargeting can only use a retargeting condition that contains at least one "all" or "or" type of group.

Use the [Retargeting (Live)](https://yandex.com/dev/direct/doc/dg-v4/en/live/Retargeting.md) method to work with retargeting parameters.