Версия Live 4

Адрес для запросов в формате JSON:

https://soap.direct.yandex.ru/live/v4/json/

Адрес WSDL (для взаимодействия по протоколу SOAP):

http://soap.direct.yandex.ru/live/v4/wsdl/

Адрес для SOAP-запросов:

https://soap.direct.yandex.ru/live/v4/soap/

Новое в версии Live 4

• Добавлены параметры GoalsReached

  [no-highlight[ Описание Сколько раз цель достигнута при переходе с поиска Яндекса за все время сбора статистики сервисом Яндекс.Метрика. ]no-highlight]

  и ContextGoalsReached

  [no-highlight[ Описание Сколько раз цель достигнута при переходе из рекламной сети Яндекса за все время сбора статистики сервисом Яндекс.Метрика. ]no-highlight]

  в метод GetStatGoals

  [no-highlight[ Возвращает сведения о целях Яндекс.Метрики, которые доступны для кампании. подробнее GetStatGoals (Live) ]no-highlight]

  .
• Прямые клиенты могут оплачивать кампании за счет овердрафта (см. параметр PayMethod

  [no-highlight[ Описание Метод оплаты кампании: Bank — оплата за счет кредита (применяется рекламными агентствами); Overdraft — оплата за счет овердрафта (применяется прямыми клиентами). Метод «Overdraft» формирует счет на оплату, в котором предустановленным способом оплаты является «Яндекс.Деньги». Клиент может выбрать другой способ оплаты счета. Требуется Да ]no-highlight]

  в методе PayCampaigns

  [no-highlight[ Оплата кампании с отсрочкой внесения средств. подробнее PayCampaigns (Live) ]no-highlight]

  ). Доступную сумму овердрафта возвращает метод GetClientInfo

  [no-highlight[ Возвращает персональные данные клиентов. подробнее GetClientInfo (Live) ]no-highlight]

  (параметр OverdraftSumAvailable

  [no-highlight[ Описание Лимит овердрафта, которым клиент может воспользоваться в текущий момент времени, в условных единицах. Оплата кампаний за счет овердрафта выполняется с помощью метода PayCampaigns. ]no-highlight]

  ).
• Для рекламной сети Яндекса доступны автоматические стратегии управления ставками (см. параметр StrategyName

  [no-highlight[ Описание Название стратегии показов в рекламной сети Яндекса. Ниже перечислены стратегии с ручным и автоматическим управлением ставками. Значение ShowsDisabled выключает показ объявлений в рекламной сети. Это возможно, только если показ не выключен на поиске Яндекса (см. CampaignStrategy). Стратегии с ручным управлением ставками в рекламной сети Яндекса: Default — стратегия “Процент от цены на поиске“. Процент задают в параметре ContextPricePercent. Дополнительные параметры — ContextLimit и ContextLimitSum. Данная стратегия применяется для кампаний, которым стратегия не назначена явно. MaximumCoverage — стратегия «Максимальный доступный охват». Цены за клик задают с помощью методов CreateOrUpdateBanners и UpdatePrices (параметр ContextPrice). Стратегия MaximumCoverage не доступна, если для показов на поиске Яндекса выбрана какая-либо автоматическая стратегия. Автоматические стратегии в рекламной сети Яндекса: Автоматические стратегии для рекламной сети доступны, только если на поиске выключен показ объявлений (см. CampaignStrategy). WeeklyBudget — стратегия «Недельный бюджет. Максимальное количество кликов» (обязательный параметр WeeklySumLimit, дополнительный MaxPrice); CPAOptimizer — стратегия «Недельный бюджет. Максимальная конверсия» (обязательные параметры WeeklySumLimit и GoalID, дополнительный MaxPrice); AverageClickPrice — стратегия «Средняя цена клика» (обязательный параметр AveragePrice, дополнительный WeeklySumLimit). WeeklyPacketOfClicks — стратегия «Недельный пакет кликов» (обязательный параметр ClicksPerWeek, дополнительные MaxPrice или AveragePrice); Требуется Да ]no-highlight]

  в объекте CampaignContextStrategy)
• Добавлен параметр AutoMinusWords

  [no-highlight[ Описание Делать фразы уникальными — Yes/No. Если не задано, подразумевается No. Уникальность означает, что любому поисковому запросу соответствует не более одной фразы в объявлении. Это достигается приписыванием минус-слов к пересекающимся фразам (см. пример ниже). Данная процедура выполняется автоматически при редактировании объявления. Минус-слова увеличивают суммарный размер фраз. Если достигнут предустановленный лимит (4096 символов для всех фраз объявления), новые минус-слова не добавляются, и уникальность фраз в объявлении не гарантируется. Если поисковому запросу соответствует несколько фраз одного объявления, возникает неоднозначность выбора фразы. Например, фразы — «шубы» и «шубы норковые» равнозначны при сравнении с запросом «норковые шубы» (в обеих фразах каждое слово входит в запрос). В таком случае для целей статистики фраза выбирается случайным образом. Однако если в первой фразе задать минус-слово «шубы -норковые», она перестает соответствовать показанному запросу, и фразы становятся уникальными. Благодаря этому статистика точнее показывает эффективность отдельных фраз. Требуется Нет ]no-highlight]

  в метод CreateOrUpdateBanners (Live)

  [no-highlight[ Создает объявление или редактирует параметры существующего объявления. подробнее CreateOrUpdateBanners (Live) ]no-highlight]

  .
• В отчет о статистике кампании выводятся идентификаторы фраз phrase_id (см. Пример отчета).
• Новый метод GetEventsLog (Live)

  [no-highlight[ Возвращает записи из журнала событий. подробнее GetEventsLog (Live) ]no-highlight]

  .
• Методы GetCampaignsListFilter (Live)

  [no-highlight[ Возвращает список кампаний, соответствующих условиям отбора, с краткими сведениями о кампаниях. подробнее GetCampaignsListFilter (Live) ]no-highlight]

  и GetBanners (Live)

  [no-highlight[ Возвращает параметры объявлений. подробнее GetBanners (Live) ]no-highlight]

  . Добавлены параметры Limit и Offset для постраничной выборки из базы данных.
• Метод GetStatGoals (Live)

  [no-highlight[ Возвращает сведения о целях Яндекс.Метрики, которые доступны для кампании. подробнее GetStatGoals (Live) ]no-highlight]

  . Добавлены результирующие параметры AvailableForStrategy

  [no-highlight[ Описание Цель подходит для ведения автоматической стратегии «Недельный бюджет. Максимальная конверсия» на поиске Яндекса — Yes/No. Для этого подходят только несоставные цели. ]no-highlight]

  и AvailableForContextStrategy

  [no-highlight[ Описание Смысл, как у предыдущего параметра, но относится к стратегиям в рекламной сети Яндекса, а не к стратегиям на поиске. ]no-highlight]

  .
• Метод CreateOrUpdateCampaign (Live)

  [no-highlight[ Создает кампанию c указанными параметрами или изменяет параметры существующей кампании. подробнее CreateOrUpdateCampaign (Live) ]no-highlight]

  . Добавлен входной параметр ContextStrategy

  [no-highlight[ Описание Определяет стратегию показов в рекламной сети Яндекса. Содержит объект CampaignContextStrategy с названием и параметрами стратегии. Требуется Нет ]no-highlight]

  , устанавливающий стратегию показов в рекламной сети Яндекса. Параметры ContextLimit

  [no-highlight[ Описание Ограничение бюджета при показе объявлений на сайтах рекламной сети Яндекса: Default — бюджет не ограничен (предустановленное значение); Limited — бюджет ограничен значением параметра ContextLimitSum. При значении Limited и если в параметре ContextLimitSum задан ноль показ объявлений в рекламной сети отключается независимо от выбранной стратегии. Требуется Нет ]no-highlight]

  , ContextLimitSum

  [no-highlight[ Описание Максимальный процент бюджета, расходуемый для показа в рекламной сети Яндекса. Значение должно быть кратно 10 или равняться нулю: 0, 10, 20, ..., 100. Предустановленное значение — null не накладывает ограничений на бюджет (равнозначно установке Default в параметре ContextLimit). Требуется Нет ]no-highlight]

  , ContextPricePercent

  [no-highlight[ Описание Параметр для вычисления цены за клик в рекламной сети Яндекса для стратегии Default. Задается в процентах от цены за клик на поиске Яндекса. Значение кратно 10 или равняется нулю: 0, 10, 20, ..., 100. Предустановленное значение — 100 делает цену за клик в рекламной сети равной цене на поиске. Значении 0 уменьшает цену за клик в рекламной сети до нуля, что останавливает показы в рекламной сети. Требуется Нет ]no-highlight]

  перенесены под параметр ContextStrategy

  [no-highlight[ Описание Определяет стратегию показов в рекламной сети Яндекса. Содержит объект CampaignContextStrategy с названием и параметрами стратегии. Требуется Нет ]no-highlight]

  .
  В настройки временного таргетинга добавлен параметр BidCoefs

  [no-highlight[ Описание Массив коэффициентов, которые уменьшают цены за клик в определенные часы. Применяется для стратегий с ручным управлением ставками. Коэффициенты указываются в процентах от 0 до 100. Необходимо задавать столько коэффициентов, сколько часов указано в массиве Hours. Каждый коэффициент соотносится с определенным часом в порядке следования в массиве. Если параметр отсутствует, ранее заданные коэффициенты не изменяются. Требуется Нет ]no-highlight]

  , с помощью которого можно уменьшать цены за клик в определенные часы.
• Методы GetCampaignParams (Live)

  [no-highlight[ Возвращает параметры кампании. подробнее GetCampaignParams (Live) ]no-highlight]

  и GetCampaignsParams (Live)

  [no-highlight[ Возвращает параметры одной или нескольких кампаний. подробнее GetCampaignsParams (Live) ]no-highlight]

  возвращают параметры ContextStrategy

  [no-highlight[ Описание Определяет стратегию показов в рекламной сети Яндекса. Содержит объект CampaignContextStrategy с названием и параметрами стратегии. ]no-highlight]

  и BidCoefs

  [no-highlight[ Описание Массив коэффициентов, которые уменьшают цены за клик в определенные часы. Применяется для стратегий с ручным управлением ставками. Коэффициенты указаны в процентах от 0 до 100. Используется столько коэффициентов, сколько часов указано в массиве Hours. Каждый коэффициент соотносится с определенным часом в порядке следования в массиве. ]no-highlight]

  .
• Методы GetCampaignsList (Live)

  [no-highlight[ Возвращает список кампаний с краткими сведениями о них. подробнее GetCampaignsList (Live) ]no-highlight]

  и GetCampaignsListFilter (Live)

  [no-highlight[ Возвращает список кампаний, соответствующих условиям отбора, с краткими сведениями о кампаниях. подробнее GetCampaignsListFilter (Live) ]no-highlight]

  . Добавлены результирующие параметры StrategyName

  [no-highlight[ Описание Стратегия показов на поиске Яндекса. ]no-highlight]

  и ContextStrategyName

  [no-highlight[ Описание Стратегия показов в рекламной сети Яндекса. ]no-highlight]

  .
• Метод GetRegions (Live)

  [no-highlight[ Возвращает список регионов, зарегистрированных в Яндекс.Директе. подробнее GetRegions (Live) ]no-highlight]

  . Добавлен параметр RegionType

  [no-highlight[ Описание Тип региона. Возможные значения: Continent, Region, Country, Administrative area, Administrative area, City, Village. ]no-highlight]

  .