update

Изменяет параметры ключевых фраз и автотаргетингов.

Узнайте больше

Ограничения

Не более 1000 объектов в одном вызове метода.

Запрос

Структура запроса в формате JSON:

{
  "method": "update",
  "params": { /* params */
    "Keywords": [{  /* KeywordUpdateItem */
      "Id": (long), /* required */
      "Keyword": (string),
      "UserParam1": (string), /* nillable */
      "UserParam2": (string), /* nillable */
      "AutotargetingCategories" : [{  /* AutotargetingCategoriesUpdateItem */
        "Category" : ("EXACT"|"ALTERNATIVE"|"COMPETITOR"|"BROADER"|"ACCESSORY") /* required */,
        "Value" : ("YES"|"NO") /* required */
      }, ...],
      "AutotargetingSettings" : {
        "Categories" : {
            "Exact" : ("YES"|"NO"),
            "Narrow" : ("YES"|"NO"),
            "Alternative" : ("YES"|"NO"),
            "Accessory" : ("YES"|"NO"),
            "Broader" : ("YES"|"NO")
        },
        "BrandOptions" : {
            "WithoutBrands" : ("YES"|"NO"),
            "WithAdvertiserBrand" : ("YES"|"NO"),
            "WithCompetitorsBrand" : ("YES"|"NO")
        }
      }
    }, ... ] /* required */
  }
}

Параметр

Тип

Описание

Обязательный

Структура params (для JSON) / UpdateRequest (для SOAP)

Keywords

array of KeywordUpdateItem

Ключевые фразы и автотаргетинги, параметры которых требуется изменить.

Да

Структура KeywordUpdateItem

Id

long

Идентификатор ключевой фразы или автотаргетинга.

Да

Keyword

string

Ключевая фраза.

Может содержать минус-слова, которые указывают со знаком минус перед словом, например молния -гром -дождь.

Длина ключевой фразы — не более 4096 символов. Оператор “!” перед минус-словом не учитывается в длине фразы (последовательность “-!” считается как один символ).

Не более 7 слов в ключевой фразе, без учета стоп-слов и минус-слов. Каждое слово — не более 35 символов, без учета минуса перед минус-словом.

Внимание

В результате изменения ключевой фразы может быть создана новая фраза, см. Создание новой фразы в результате редактирования.
В результате изменения ключевой фразы она может быть удалена, так как стала дубликатом другой фразы, см. Дубликаты фраз.

Для автотаргетинга значение недоступно для изменения.

Нет

UserParam1

string, nillable

Значение подстановочной переменной{param1}. Не более 255 символов.

Нет

UserParam2

string, nillable

Значение подстановочной переменной{param2}. Не более 255 символов.

Нет

AutotargetingCategories

array of AutotargetingCategoriesUpdateItem

Категории таргетинга, которые требуется обновить.

Внимание

Структура устарела и больше не поддерживается. Нельзя одновременно передать AutotargetingCategories и AutotargetingSettings, вернется ошибка валидации.

Нет

AutotargetingSettings

AutotargetingSettingsUpdateItem

Настройки таргетинга, которые требуется обновить.

Нет

Структура AutotargetingCategoriesUpdateItem

Category

AutotargetingCategoriesEnum

Категория таргетинга:

EXACT — целевые запросы. Рекламное объявление точно отвечает на запросы пользователя;
ALTERNATIVE — альтернативные запросы. Пользователь ищет продукт, который можно заменить рекламируемым. При этом объявление также может удовлетворить запрос;
COMPETITOR — запросы с упоминанием конкурентов. Поиск рекламируемого продукта у конкурентов;
BROADER — широкие запросы. Запросы с интересом к продукту, примером которого является рекламное предложение;
ACCESSORY — сопутствующие запросы. Запросы по продуктам, которые могут быть интересны вместе с рекламируемым товаром или услугой.

Внимание

Поле устарело и скоро перестанет поддерживаться.

Настройки, заданные с помощью API, сконвертируются в веб-интерфейсе по следующим правилам:

API	Веб-интерфейс
Включенная категория `EXACT`.	Если в группе отключены категории «Целевые», «Узкие» – Включенные категории «Целевые», «Узкие». Если в группе включены категории «Целевые» и/или «Узкие» – без изменений.
Выключенная категория `EXACT`.	Если в группе включены категории «Целевые» и/или «Узкие» – Выключенные категории «Целевые», «Узкие». Если в группе отключены категории «Целевые», «Узкие» – без изменений.
Включенная категория `COMPETITOR` (если это единственная включенная категория).	Включенная опция упоминания брендов “Конкуренты” + отключение остальных опций упоминания брендов + включение всех категорий.
Включенная категория `COMPETITOR` (если это не единственная включенная категория).	Включенная опция упоминания брендов “Конкуренты”.
Выключенная категория `COMPETITOR`.	Выключенная опция упоминания брендов “Конкуренты”.

Да

Value

YesNoEnum

Признак включения указанной категории таргетинга. По умолчанию включены все категории таргетинга.

Да

Структура AutotargetingSettingsUpdateItem

Categories

AutotargetingSettingsCategoriesFieldNames

Категории таргетинга. Доступные опции:

Exact – целевые запросы. Рекламное объявление точно отвечает на запросы пользователя.
Narrow – узкие запросы. Рекламное объявление шире, чем запросы пользователя.
Alternative – альтернативные запросы. Пользователь ищет продукт, который можно заменить рекламируемым. При этом объявление также может удовлетворить запрос.
Accessory – сопутствующие запросы. Запросы по продуктам, которые могут быть интересны вместе с рекламируемым товаром или услугой.
Broader – широкие запросы. Запросы с интересом к продукту, примером которого является рекламное предложение.

Нет

BrandOptions

AutotargetingSettingsBrandOptionsFieldNames

Настройки брендовости. Доступные опции:

WithoutBrands – без упоминания брендов.
WithAdvertiserBrand – с упоминанием бренда рекламодателя.
WithCompetitorsBrand – с упоминанием брендов конкурентов.

Нет

Ответ

Структура ответа в формате JSON:

{
  "result": {  /* result */
    "UpdateResults": [{  /* ActionResult */
      "Id": (long),
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
       }, ...
      ]
    }, ... ] /* required */
  }
}

Параметр	Тип	Описание
Структура result (для JSON) / UpdateResponse (для SOAP)
`UpdateResults`	array of ActionResult	Результаты изменения параметров ключевых фраз и автотаргетингов.
Структура ActionResult
`Id`	long	Идентификатор измененной ключевой фразы или автотаргетинга. Возвращается в случае отсутствия ошибок, см. раздел Операции над массивом объектов.
`Warnings`	array of ExceptionNotification	Предупреждения, возникшие при выполнении операции.
`Errors`	array of ExceptionNotification	Ошибки, возникшие при выполнении операции.

Была ли статья полезна?

suspend

KeywordsResearch: предобработка ключевых фраз