CreateOrUpdateBanners (Live)

Идентификатор объявления. Для создания объявления задают 0, для изменения параметров объявления указывают его идентификатор.

Идентификатор группы объявлений.

Для создания группы объявлений параметр не указывают или задают значение 0.

Для добавления объявления в существующую группу необходимо указать идентификатор этой группы.

Для изменения параметров объявления или группы параметр указывать необязательно (см. раздел Редактирование параметров группы).

Название группы объявлений (до 255 символов). Если не указано, то группе автоматически присваивается название вида «AdGroup №<ID группы>».

Если длина строки превышает 255 символов, лишние символы будут отброшены.

Тип объявления: Desktop или Mobile.

Параметр указывается только при создании объявления. Если значение не задано, подразумевается Desktop.

При попытке изменить значение параметра для существующего объявления возвращается ошибка с кодом 71.

Ссылка на сайт рекламодателя. Может содержать подстановочные переменные (см. раздел Ссылки на сайт).

Объект ContactInfo с контактными данными рекламодателя (визитка).

Идентификаторы регионов, для которых показы включены или выключены. Идентификатор 0 или пустая строка — показывать во всех регионах.

Чтобы выключить показ в регионе, перед идентификатором региона ставят минус, например «1,-219» — показывать для Москвы и Московской области, кроме Черноголовки. Регионы с минусом нельзя использовать, если указан нулевой регион. Также параметр не должен состоять только из минус-регионов.

Полный список регионов можно получить с помощью метода GetRegions.

Указывать параметр необязательно, если значение AdGroupID отлично от 0 и не задан ни один из параметров AdGroupName, Phrases, MinusKeywords, AutоMinusWords.

Массив объектов BannerPhraseInfo, содержащих информацию о фразах. Для группы объявлений должна быть задана хотя бы одна фраза или условие ретаргетинга. Количество фраз в группе — не более 200.

Указывать фразы необязательно в случае, если значение AdGroupID отлично от 0 и при этом не задан ни один из параметров Geo, MinusKeywords, AutоMinusWords, а также в случае, если для группы задано хотя бы одно условие ретаргетинга.

Массив объектов Sitelink с быстрыми ссылками. Массив должен содержать от 1 до 4 объектов Sitelink или отсутствовать.

Массив минус-фраз, общих для всех ключевых фраз группы объявлений.

Минус-фразу следует указывать без минуса перед первым словом.

Не более 7 слов в минус-фразе. Длина каждого слова — не более 35 символов. Суммарная длина минус-фраз в массиве — не более 4096 символов. Оператор «!» или «+» перед словом не учитывается в суммарной длине.

Автоматически сделать фразы в группе объявлений непересекающимися — Yes/No (см. Устранение пересечений). Предустановленное значение — No.

Возрастная категория.

Для объявлений, относящихся к группе baby_food (соответствующее значение возвращается в массиве AdWarnings), — возраст ребенка в месяцах: '0months', '1months', '2months', ..., '12months'.

Для прочих объявлений — возраст, на которую ориентирована информационная продукция. Возможные значения: '0+', '6+', '12+', '16+', '18+'.

Если у объявления отсутствует возрастная категория, параметр не возвращается в ответах и игнорируется при попытке задать его.

Коэффициент настройки цен на мобильных устройствах.

Используется для групп объявлений и указывается в процентах от ставки на десктопе. Диапазон значений от 50 до 1300. Подробнее о коэффициенте можно узнать в разделеКорректировки ставок помощи Директа.

Название организации. Не более 255 символов.

Контактное лицо. Не более 155 символов.

Страна. Не более 50 символов.

Значение должно начинаться со знака «+», например «+7» для России. Исключение: если в поле CityCode указано значение «800», то в поле CountryCode допустимо значение «8».

Город. Не более 50 символов.

Улица. Не более 55 символов.

Номер дома. Не более 30 символов.

Номер строения или корпуса. Не более 10 символов.

Номер квартиры или офиса. Не более 255 символов.

Телефонный код города.

Телефонный номер для связи.

Добавочный телефонный номер для соединения через офисную АТС.

Тип сети мгновенного обмена сообщениями — icq, jabber, skype, mail_agent.

Логин в сети мгновенного обмена сообщениями.

Дополнительная информация о рекламируемом товаре или услуге. Не более 200 символов.

Адрес электронной почты. Не более 255 символов.

Режим работы организации или режим обслуживания клиентов. Задается как строка, в которой указан диапазон дней недели, рабочих часов и минут.

Дни недели обозначаются цифрами от 0 до 6, где 0 — понедельник, 6 — воскресенье.

Минуты задают кратно 15: 0, 15, 30 или 45.

Формат строки:

"день_с;день_по;час_с;минуты_с;час_до;мин_до"

Например, строка "0;4;10;0;18;0" задает такой режим:

0;4 — с понедельника по пятницу;

10;0 — с 10 часов 0 минут;

18;0 — до 18 часов 0 минут.

Режим может состоять из нескольких строк указанного формата, например: "0;4;10;0;18;0;5;6;11;0;16;0". Здесь в дополнение к предыдущему примеру задан режим:

5;6 — с субботы по воскресенье;

11;0 — с 11 часов 0 минут;

16;0 — до 16 часов 0 минут.

Круглосуточный режим работы задается строкой "0;6;00;00;00;00".

Код ОГРН для юридических лиц.

Объект MapPoint, задающий координаты местоположения клиента. По этим координатам ставится метка на карте. Если не заданы, метка ставится по указанному адресу клиента.

Долгота точки. От -180 до 180.

Широта точки. От -90 до 90.

Долгота левого нижнего угла области на карте. От -180 до 180.

Широта левого нижнего угла области на карте. От -90 до 90.

Долгота правого верхнего угла области на карте. От -180 до 180.

Широта правого верхнего угла области на карте. От -90 до 90.

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

Может содержать минус-слова, которые указывают со знаком минус перед словом, например [молния -гром -дождь]. Общие для нескольких фраз минус-слова предпочтительно задавать в параметре группы объявлений MinusKeywords.

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

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

Ставка на поиске Яндекса (в валюте, указанной в параметре Currency). Используется, только если для кампании выбрана стратегия с ручным управлением ставками.

Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits.

Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до шага торгов в этой валюте (см. раздел Реальные валюты вместо у. е.). Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке.

Ставка в Рекламной сети Яндекса (в валюте, указанной в параметре Currency).

Параметр доступен для изменения в следующих случаях:

1. Для Рекламной сети выбрана стратегия MaximumCoverage.

2. Для Рекламной сети выбрана стратегия Default и фраза отключена на поиске за низкий CTR.

   Для новых фраз данное условие не актуально, поскольку фразы больше не отключаются за низкий CTR.

Максимальное и минимальное значения представлены в таблице ../concepts/multicurrency_const.html#multicurrency_const__limits.

Если значение перед сохранением конвертируется из у. е. в валюту кампании, то оно округляется вверх с точностью до шага торгов в этой валюте (см. раздел Реальные валюты вместо у. е.). Если после конвертации в валюту кампании значение оказалось меньше минимальной или больше максимальной ставки в этой валюте, оно устанавливается равным минимальной или, соответственно, максимальной ставке.

Приоритет фразы при использовании автоматических стратегий. Возможные значения:

• Low — низкий приоритет;
• Medium — средний приоритет;
• High — высокий приоритет.

Объект PhraseUserParams. Содержит значения подстановочных переменных для формирования ссылки на сайт (см. раздел Ссылки на сайт).

Валюта, в которой указаны ставки.

Возможные значения: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. Значение должно совпадать с валютой кампании.

Если параметр отсутствует или равен NULL, подразумеваются условные единицы (у. е.). В этом случае, если кампания ведется в реальной валюте, переданные приложением ставки перед сохранением конвертируются в реальную валюту (см. раздел Реальные валюты вместо у. е.).

Если значение отлично от NULL и не совпадает с валютой кампании (одной из кампаний), возвращается ошибка с кодом 245.

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

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

Суммарная длина текстов всех быстрых ссылок — не более 66 символов.

Адрес быстрой ссылки. Может содержать подстановочные переменные (см. раздел Ссылки на сайт).