--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.ru/dev/direct/doc/en/objects/keyword.md - https://yandex.ru/dev/direct/doc/ru/objects/keyword.md - href: ru/objects/keyword.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt sourcePath: ru/dg/objects/keyword.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/ru/llms.txt # Ключевая фраза (Keyword) Ключевая фраза определяет, по каким запросам объявление может показываться на поиске, а также тематику страниц и интересы пользователя, в соответствии с которыми объявление может показываться в сетях (Рекламной сети Яндекса и внешних сетях). Подробнее в разделе [Ключевые фразы](https://yandex.ru/support/direct/keywords/keywords.html) Справки Директа. Ключевая фраза может содержать минус-слова. Минус-слова можно также указывать на уровне группы объявлений и на уровне кампании, см. раздел [Минус-фразы](https://yandex.ru/dev/direct/doc/ru/objects/negative-keywords.md). Ключевая фраза может содержать уточняющие операторы, подробнее в разделе [Символы и операторы](https://yandex.ru/support/direct/keywords/symbols-and-operators.html) Справки Директа. ## Сервис {#service} Для управления ключевыми фразами предназначен сервис [Keywords](https://yandex.ru/dev/direct/doc/ref-v5/keywords/keywords.html). ### Методы {#methods} [add](https://yandex.ru/dev/direct/doc/ref-v5/keywords/add.html) | [update](https://yandex.ru/dev/direct/doc/ref-v5/keywords/update.html) | [delete](https://yandex.ru/dev/direct/doc/ref-v5/keywords/delete.html) | [suspend](https://yandex.ru/dev/direct/doc/ref-v5/keywords/suspend.html) | [resume](https://yandex.ru/dev/direct/doc/ref-v5/keywords/resume.html) | [get](https://yandex.ru/dev/direct/doc/ref-v5/keywords/get.html) {% note info %} Для назначения ставок и приоритетов на ключевые фразы предназначен сервис [KeywordBids](https://yandex.ru/dev/direct/doc/ref-v5/keywordbids/keywordbids.html). См. также раздел [Ставка и приоритет (KeywordBid)](https://yandex.ru/dev/direct/doc/ru/objects/bid-priority.md). {% endnote %} ## Ограничения {#restrictions} Не допускается добавление ключевых фраз в группу объявлений с типом CPM_BANNER_AD_GROUP и подтипом USER_PROFILE, а также в группу с типом DYNAMIC_TEXT_AD_GROUP. Ограничение на количество ключевых фраз в группе объявлений для пользователя можно получить с помощью метода [Clients](https://yandex.ru/dev/direct/doc/ref-v5/clients/clients.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/clients/get.html) или [AgencyClients](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/agencyclients.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/get.html) (элемент KEYWORDS_TOTAL_PER_ADGROUP массива [Restrictions](*Restrictions)). Ограничения на количество слов и символов в ключевой фразе см. в разделе [Количественные ограничения](https://yandex.ru/support/direct/troubleshooting/interface.html#limitations) Справки Директа. ## Статус и состояние фразы {#status} Параметр `Status` отражает результат модерации ключевой фразы. #| || **Статус** | **Описание** || || DRAFT | Новая фраза: еще не отправлена на модерацию или находится на модерации. Если в кампании есть хотя бы одно объявление, которое активно или отправлено на модерацию, новые фразы отправляются на модерацию автоматически. || || ACCEPTED | Фраза принята модерацией. || || REJECTED | Фраза отклонена модерацией. || || UNKNOWN | Неизвестный статус. Используется для обеспечения обратной совместимости и отображения статусов, не поддерживаемых в данной версии API. || |# Параметр `State` отражает, остановлены ли показы по фразе. #| || **Состояние** | **Описание** || || ON | Показы объявлений по фразе возможны. || || SUSPENDED | Показы остановлены владельцем (с помощью метода [suspend](https://yandex.ru/dev/direct/doc/ref-v5/keywords/suspend.html) или в веб-интерфейсе). || || OFF | Фраза еще не отправлена на модерацию или отклонена модерацией. || |# Параметр `ServingStatus` отражает статус показов группы объявлений, см. раздел [Статус возможности показов группы](https://yandex.ru/dev/direct/doc/ru/objects/adgroup.md#serving-status). ### Узнайте больше - [Как определить, идут ли показы по ключевой фразе?](https://yandex.ru/dev/direct/doc/support/troubleshooting/faq.html#faq__keyword-running) ## Подстановочные переменные {#userparams} В ссылке объявления и быстрых ссылках можно использовать подстановочные переменные `{param1}` и `{param2}`. Вместо них подставляются значения, указанные в параметрах фразы `UserParam1` и `UserParam2`. Таким образом, можно модифицировать ссылки в зависимости от фразы, по которой отобрано и показано объявление. Подробнее о подстановочных переменных можно прочитать в разделе [Учет параметров объявления в ссылке](https://yandex.ru/support/direct/statistics/url-tags.html) Справки Директа. ## Создание новой фразы в результате редактирования {#update} В результате редактирования фразы может быть создана новая фраза. Например, если в ключевой фразе удалить или заменить ключевое слово или удалить минус-слово, добавить или удалить оператор **!** или **+**. В случае создания новой фразы метод [update](https://yandex.ru/dev/direct/doc/ref-v5/keywords/update.html) возвращает идентификатор новой фразы и предупреждение. По старой фразе остается доступной статистика, но показы по ней прекращаются и управлять ею больше нельзя. ## Дубликаты фраз {#duplicate} Дубликаты — фразы, отличающиеся только формой слов и наличием стоп-слов, например _обменять доллары на рубли_ и _обменяю рубли и доллары_. Методы [add](https://yandex.ru/dev/direct/doc/ref-v5/keywords/add.html) и [update](https://yandex.ru/dev/direct/doc/ref-v5/keywords/update.html) автоматически удаляют дубликаты фраз в рамках группы объявлений: - Если во входном массиве метода `add` переданы две фразы, являющиеся дубликатами, то будет создана одна фраза, в ответе метода будут возвращены одинаковые идентификаторы и предупреждение для одной из фраз. - Если во входном массиве метода `add` передана фраза, являющаяся дубликатом существующей, то новая фраза не будет создана, в ответе метода будет возвращен идентификатор существующей фразы и предупреждение. - Если в результате редактирования фразы методом `update` фраза стала дубликатом существующей, то редактируемая фраза будет удалена, в ответе метода будет возвращен идентификатор существующей фразы и предупреждение. - Если в результате редактирования двух фраз методом `update` фразы стали дубликатами, то одна из фраз будет удалена, в ответе метода для нее будет возвращен идентификатор другой фразы и предупреждение. {% cut "Пример" %} ![keywords-update](../_images/keywords-update.png) {% endcut %} - Если в результате редактирования двух фраз методом `update` фразы стали дубликатами и [создана новая фраза](#update), в ответе метода будут возвращены идентификатор новой фразы и предупреждения: для одной из фраз в запросе — о создании новой фразы, для другой — о наличии такой же фразы. {% cut "Пример" %} ![keywords-update2](../_images/keywords-update2.png) {% endcut %} [*Restrictions]: **Для рекламодателя** Количественные ограничения на объекты рекламодателя. **Для агентства** —