Update
Изменяет параметры ретаргетингов.
Входные данные
Ниже показана структура входных данных в формате JSON.
{
"method": "Retargeting",
"param": {
/* RetargetingRequest */
"Action": (string),
"Login": (string),
"Retargetings": [
{ /* Retargeting */
"Fields": [
(string)
...
],
"RetargetingID": (int),
"ContextPrice": (float),
"Currency": (string),
"AutoBudgetPriority": (string),
"StatusPaused": (string)
}
...
]
}
}
Ниже приведено описание параметров.
Параметр |
Описание |
Требуется |
Объект RetargetingRequest |
||
|
Выполняемая операция: Update. |
Да |
|
Логин клиента, для которого нужно изменить параметры ретаргетингов. Для рекламодателей параметр игнорируется. |
Для агентств |
|
Массив объектов |
Да |
Объект Retargeting |
||
|
Названия параметров, которые необходимо обновить. Если не задано, будут обновлены (а если значение не задано — сброшены) все параметры. |
Нет |
|
Идентификатор ретаргетинга. |
Да |
|
Ставка в Рекламной сети Яндекса при использовании стратегий MaximumCoverage и Default (в валюте, указанной в параметре Максимальное и минимальное значения представлены в таблице {#T}. Если для кампании выбрана автоматическая стратегия показа, то передаваемое значение игнорируется, выдается предупреждение 209. |
Нет |
|
Валюта, в которой указана ставка. Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой клиента, в противном случае возвращается ошибка с кодом 245. |
Да |
|
Приоритет ретаргетинга при использовании автоматических стратегий. Возможные значения:
Высокий приоритет обеспечивает на 10–15% больше показов, чем по фразам/ретаргетингам со средним приоритетом. Низкий приоритет уменьшает показы на такую же величину. Если в объявлении только один ретаргетинг и отсутствуют фразы, параметр не влияет на количество показов. Значение по умолчанию — Medium. Если для кампании выбрана ручная стратегия показа, то передаваемое значение сохраняется, но не влияет на показы. |
Нет |
|
Ретаргетинг временно отключен (не используется для показа объявления) — Yes/No. Предустановленное значение — No. |
Нет |
Результирующие данные
Внимание
Ошибка при изменении одного из ретаргетингов не влечет отмену всей операции и не влияет на успешность изменения остальных ретаргетингов.
Ниже показана структура результирующих данных в формате JSON.
{
"data": {
/* RetargetingResponse */
"ActionsResult": [
{ /* RetargetingActionResult */
"Warnings": [
{ /* Warning */
"WarningCode": (int),
"WarningString": (string),
"Description": (string)
}
...
],
"Errors": [
{ /* Error */
"FaultCode": (int),
"FaultString": (string),
"FaultDetail": (string)
}
...
],
"RetargetingID": (int)
}
...
]
}
}
Ниже приведено описание параметров.
Параметр |
Описание |
Объект RetargetingResponse |
|
|
Массив объектов
|
Объект RetargetingActionResult |
|
|
Массив объектов |
|
Массив объектов |
|
Идентификатор ретаргетинга. |
Объект Warning |
|
|
|
|
Текст предупреждения. |
|
Описание предупреждения в формате JSON. Вместе с |
Объект Error |
|
|
Код ошибки. |
|
Текст сообщения об ошибке. |
|
Подробное описание причины ошибки. |
Примеры входных данных
Python
{
'Action': 'Update',
'Login': 'agrom',
'Retargetings': [
{
'Fields': ['AutoBudgetPriority'],
'RetargetingID': 7521,
'AutoBudgetPriority': 'High'
}
]
}
PHP
array(
'Action' => 'Update',
'Login' => 'agrom',
'Retargetings' => array(
array(
'Fields' => array('AutoBudgetPriority'),
'RetargetingID' => 7521,
'AutoBudgetPriority' ='High'
)
)
)
Perl
{
'Action' => 'Update',
'Login' => 'agrom',
'Retargetings' => [
{
'Fields' => ['AutoBudgetPriority'],
'RetargetingID' => 7521,
'AutoBudgetPriority' ='High'
}
]
}