Фраза (Phrase)

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

Фраза имеет идентификатор — PhraseID, который указан в ответе методов GetBanners, GetBannerPhrases и GetBannerPhrasesFilter.

Фразы настраивают с помощью метода CreateOrUpdateBanners. Следующая структура содержит минимальный состав параметров фразы.

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

Для фраз предусмотрены и другие параметры, описанные ниже. Полный список параметров приведен в ответе метода GetBannerPhrases.

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

Фразы определяют целевую аудиторию группы объявлений (подробнее см. Таргетинг).

Ставки

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

Статистика

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

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

Статус

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

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

В структуре UserParams можно указать значения подстановочных переменных {param1} и {param2} для использования в ссылках — параметрах объявления Href и Sitelinks. Эти переменные позволяют изменять ссылку на сайт в зависимости от фразы, по которой отобрано и показано объявление. Подробнее о подстановочных переменных можно прочитать в разделе Параметры, передаваемые в URL объявлений помощи Яндекс.Директа.