В API Директа появился сервис AdVideos. Он предназначен для выполнения операций с видео.

Доступные методы:

• add — выполняет синхронную загрузку видео по ссылкам URL или в виде бинарных данных.
• get — возвращает статус обработки загруженных видео.

Подробнее о видеодополнениях читайте:

• В документации API Директа.
• В документации Директа.

С 31 января у ручных стратегий перестанут поддерживаться параметры совместного управления ставками для текстово-графических объявлений и для рекламы мобильных приложений.

Отключаемые параметры:

• MAINTAIN_NETWORK_CPC — параметр позволял удерживать среднюю цену клика в сетях ниже средней цены на поиске.
• NETWORK_DEFAULT — параметр позволял устанавливать настройки показов в сетях в зависимости от настроек на поиске.

Пожалуйста, запланируйте обновление своих приложений до конца января 2022 года.

Если у вас появились вопросы, вы можете задать их специалистам службы поддержки.

В API Директа появился сервис DynamicFeedAdTargets. Он предназначен для выполнения операций с условиями нацеливания по фидам для динамических текстовых объявлений.

Примерно через восемь рабочих недель параметр StrategyPriority перестанет поддерживаться в сервисах:

• AudienceTargets — в методах add, get и setBids;
• Bids — get и set;
• DynamicTextAdTargets — add, get и setBids;
• KeywordBids — get и set;
• Keywords — add и get;
• SmartAdTargets — add, get setBids и update.

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

Если у вас появились вопросы, вы можете задать их специалистам службы поддержки.

В сервисе Campaigns, в стратегиях WB_MAXIMUM_CONVERSION_RATE,AVERAGE_ROI и AVERAGE_CPA ограничена возможность оптимизации по всем целям. Теперь в параметре GoalId для этих стратегий необходимо передавать идентификатор конкретной цели Яндекс.Метрики.

В сервисе Campaigns появились новые стратегии: 

• PAY_FOR_CONVERSION — для кампаний с типом «Текстово-графические объявления» и «Динамические объявления»;
• PAY_FOR_CONVERSION_PER_CAMPAIGN — для кампаний с типом «Смарт-баннеры».

Стратегии принесут конверсии по цене, указанной при настройке стратегии.

Появилась поддержка профилей организаций из Яндекс.Справочника:

• Добавлен сервис Businesses для получения профилей организаций рекламодателя.
• В методы сервиса Ads добавлен параметр BusinessId для текстово-графических объявлений.

Смарт-баннеры — красивый и удобный формат Директа для ретаргетинга и генерации продаж, объявления с оплатой за клик и динамическим контентом. Чтобы вам было удобнее автоматизировать работу со смарт-баннерами, мы добавили возможность управлять ими в API Директа.

Какие нововведения появились в API:

• Сервис Feeds для управления фидами — файлами с товарными предложениями.
• Сервис SmartAdTargets для управления фильтрами — условиями нацеливания для смарт-баннеров.
• Поддержка кампаний с типом SMART_CAMPAIGN в сервисе Campaigns.
• Поддержка групп объявлений с типом SMART_AD_GROUP в сервисе AdGroups.
• Поддержка объявлений с типом SMART_AD в сервисе Ads.
• Поддержка креативов с типом SMART_CREATIVE в сервисе Creatives.
• Поддержка корректировок с типом SMART_AD_ADJUSTMENT в сервисе BidModifiers.

Прочитать подробности об управлении смарт-баннерами через API можно в документации.

Добавлен таргетинг по интересам для текстово-графических объявлений:

• В группу с типом TEXT_AD_GROUP можно добавить условие нацеливания на аудиторию, в котором условие ретаргетинга и подбора аудитории имеет тип AUDIENCE и содержит только сегменты по краткосрочным интересам.
• В ответ метода RetargetingLists.get добавлен параметр AvailableForTargetsInAdGroupTypes.

Изменения подробно описаны в документации.

Метод Dictionaries.get возвращает в справочнике Currencies новый параметр MinimumAccountDailyBudget — минимальный дневной бюджет общего счета.

Валютный параметр MinimumPayment, который ранее совмещал два значения — минимальный платеж (без учета НДС) и минимальный дневной бюджет общего счета, используйте только в качестве ограничения минимального платежа.

Значения возвращаемых параметров SharedAccountFunds.Spend и CampaignFunds.Sum теперь включают НДС.

В сервисе Campaigns  для настройки ADD_METRICA_TAG в структуре Settings значение по умолчанию изменено с NO на YES.

Таким образом, для новых кампаний настройка по умолчанию включена. Это означает, что к ссылкам объявлений автоматически добавляется метка ?yclid= с уникальным номером клика. Необходимо убедиться, что страницы сайта рекламодателя корректно открываются по  ссылкам с этой меткой.

В методы сервиса Campaigns добавлен параметр AttributionModel для кампаний с типом «Текстово-графические объявления» и «Динамические объявления».

В сервисе Reports для входного параметра AttributionModels добавлено значение LYDC — «Последний переход из Яндекс.Директа». Статистика по новой модели атрибуции доступна за период начиная с 30 июля 2019 г.

Сервис Sitelinks теперь поддерживает до 8 быстрых ссылок в каждом наборе.

Суммарная длина текстов быстрых ссылок № 1–4 — не более 66 символов. Суммарная длина текстов быстрых ссылок № 5–8 — также не более 66 символов.

В сервис Campaigns внесены изменения, о которых мы сообщали ранее:

• Из структуры NetworkDefault исключен параметр BidPercent.
• Параметр LimitPercent в структуре NetworkDefault используется только в случае, если стратегия на поиске — HIGHEST_POSITION.
• Настройка MAINTAIN_NETWORK_CPC в структуре Settings используется только в случае, если стратегия на поиске — HIGHEST_POSITION, а стратегия в сетях — NETWORK_DEFAULT.

Изменения подробно описаны в документации.

Хотим предупредить вас, что в середине августа в сервисе Campaigns произойдут изменения, связанные с недавно анонсированным обновлением стратегий. Изменения затронут кампании с типом TEXT_CAMPAIGN и  MOBILE_APP_CAMPAIGN.

• Из структуры NetworkDefault будет исключен параметр BidPercent. Методы add и update будут выдавать ошибку при попытке задать его, а метод get перестанет возвращать.
• Параметр LimitPercent в структуре NetworkDefault будет использоваться только в случае, если стратегия на поиске — HIGHEST_POSITION.

  Если на поиске автоматическая стратегия:

  • Методы add и update будут игнорировать переданное значение и выдавать предупреждение.  Чтобы включить стратегию в сетях NETWORK_DEFAULT вместе с автоматической на поиске, необходимо будет передать пустую структуру NetworkDefault.
  • Метод get не будет возвращать структуру NetworkDefault.
• Настройка MAINTAIN_NETWORK_CPC в структуре Settings будет использоваться только в случае, если стратегия на поиске — HIGHEST_POSITION, а стратегия в сетях — NETWORK_DEFAULT. В остальных случаях методы add и update будут игнорировать переданное значение и выдавать предупреждение, а метод get не будет возвращать настройку MAINTAIN_NETWORK_CPC.

Если у вас появились вопросы, вы можете задать их  специалистам службы поддержки.

В API Директа появилась поддержка наборов минус-фраз:

• Добавлен сервис NegativeKeywordSharedSets для управления наборами минус-фраз.
• В методы сервиса AdGroups добавлен параметр NegativeKeywordSharedSetIds — в нем можно указать до трех идентификаторов наборов. Метод AdGroups.get позволяет отбирать группы объявлений, в которых используются заданные наборы минус-фраз.

Если у вас появились вопросы, вы можете задать их специалистам службы поддержки.

Появилась поддержка видеообъявлений в медийных кампаниях:

• В сервис AdGroups добавлена поддержка групп объявлений с типом CPM_VIDEO_AD_GROUP.

  Ограничение. Настройка Сбор аудитории видео в настоящее время не поддерживается в API.

• В сервис Ads добавлена поддержка объявлений с типом CPM_VIDEO_AD.
• В сервис Creatives добавлена поддержка креативов с типом CPM_VIDEO_CREATIVE.

Подробнее об управлении медийными кампаниями читайте в документации.

• Отменено ограничение на условия ретаргетинга и подбора аудитории, состоящие только из правил с оператором NONE. Теперь в таких условиях можно использовать не только цели Яндекс.Метрики, но и сегменты Яндекс.Метрики, и сегменты Яндекс.Аудиторий.
• Параметр MembershipLifeSpan теперь используется только для целей Яндекс.Метрики. Для сегментов Яндекс.Метрики и сегментов Яндекс.Аудиторий методы add и update игнорируют переданное значение.
• Максимальное количество дней в параметре MembershipLifeSpan увеличено до 540.

Хотим предупредить вас, что скоро к объявлениям в Директе можно будет добавить до восьми быстрых ссылок. Новый лимит начнет применяться в июне.

Изменения затронут сервис Sitelinks — если вы используете его, подготовьте свои приложения.

Любые вопросы вы можете задать специалистам службы поддержки API Директа.