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

# Фраза (Phrase)

Объект определяет целевую аудиторию объявления, задает ставку, содержит статистику показов.

Фраза имеет идентификатор — PhraseID, который указан в ответе методов [GetBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBanners.html), [GetBannerPhrases](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBannerPhrases.html) и [GetBannerPhrasesFilter](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBannerPhrasesFilter.html).

Фразы настраивают с помощью метода [CreateOrUpdateBanners](https://yandex.ru/dev/direct/doc/dg-v4/reference/CreateOrUpdateBanners.html). Следующая структура содержит минимальный состав параметров фразы.

```
params = {
   "PhraseID": (long),
   "Phrase": (string),
   "Price": (float)
}
```

Для фраз предусмотрены и другие параметры, описанные ниже. Полный список параметров приведен в ответе метода [GetBannerPhrases](https://yandex.ru/dev/direct/doc/dg-v4/reference/GetBannerPhrases.html).

## Целевая аудитория

Фразы определяют целевую аудиторию группы объявлений (подробнее см. [Таргетинг](https://yandex.ru/dev/direct/doc/dg-v4/concepts/targeting.html#targeting)).

## Ставки

Ставки можно задавать вручную для фраз, а можно использовать автоматические стратегии управления ставками (см. [Стратегии показа](https://yandex.ru/dev/direct/doc/dg-v4/concepts/strategy.html)).

## Статистика

В параметре `Shows` указано, сколько раз объявления группы показаны по данной фразе, в параметре `Clicks` — сколько переходов на сайт рекламодателя при этом выполнено. Данные приводятся за последние 28 дней.

Аналогичная статистика для Рекламной сети Яндекса содержится в параметрах `ContextShows` и `ContextClicks` (Live 4).

## Статус

В параметре `StatusPhraseModerate` указан результат проверки фразы модератором. В параметре `StatusPaused` (Live 4) указано, используется фраза или отключена.

## Подстановочные переменные

В структуре `UserParams` можно указать значения подстановочных переменных `{param1}` и `{param2}` для использования в ссылках — параметрах объявления `Href` и `Sitelinks`. Эти переменные позволяют изменять ссылку на сайт в зависимости от фразы, по которой отобрано и показано объявление. Подробнее о подстановочных переменных можно прочитать в разделе [Параметры, передаваемые в URL объявлений](https://yandex.ru/support/direct/statistics/url-tags.xml) помощи Яндекс Директа.