Часто задаваемые вопросы по API синхронизации сделок

В: Какой у меня идентификатор Exchange?

A: Идентификатор Exchange назначается DV3 во время настройки аутентификации.

В: Что случилось с иерархией заказов и продуктов?

О: Это в основном предназначено для издателей и рекламодателей, чтобы они могли вести переговоры по нескольким сделкам и продвигать их как один объект переговоров. Однако существуют ограничения: все товары в заказе должны иметь одинаковый тип транзакции и тип ценообразования.** Вполне допустимо всегда настраивать один заказ на один товар.**

В: Есть ли сделка для всех рекламодателей?

A: API синхронизации сделок предназначено для частных сделок. Для публичных сделок см. пакет «Аукцион».

В: Что делать, если у сделки нет даты окончания? Стоит ли просто указать очень далёкую дату, например, 31.12.9999?

О: Нам нужна конечная дата, поэтому да, любая дата в будущем должна подойти. Максимально допустимая дата сейчас — 31.12.2030. Даты окончания можно будет изменить в будущем.

В: Допускает ли поле dimensionCreativeConfig несколько размеров?

О: Да. Но разрешен только один тип креатива.

В: Принимаете ли вы аукционные цены для зарезервированных транзакций?

A: Нет. Предложения по бронированию поддерживают фиксированную цену.

В: Требуется ли продолжительность для сделок с видео PG?

A: Нет, если не задать, будет указана «ЛЮБАЯ» длительность.

В: Приводит ли какой-либо из статусов «Заказ» к автоматической остановке транзакции по сделке? Например, если заказы на гарантированные сделки переведены в режим ожидания, или любой другой заказ переведен в режим ожидания, архивирован, отменён или приостановлен?

О: Нет, заказ — это всего лишь объект переговоров. Он не распространяется, пока рекламодатель не «примет» заказ.

В: Что происходит с уже принятой сделкой, если Exchange отправляет запрос на обновление?

A: Условия сделки остаются прежними. Когда пользователь принимает их, условия сделки обновляются.

В: Если продавец изменит условия сделки, например, увеличит фиксированную цену за тысячу показов, и мы отправим вам уведомление, будет ли сделка продолжать действовать до её принятия?

A: Предположим, что CPM уже изменена на стороне биржи и отражена в запросе на ставку.

  1. Для сделок с резервированием средства не будут потрачены до повторного подтверждения. Поскольку позиции формируются на основе условий сделки, а обновления условий сделки на данный момент всё ещё находятся на стадии переговоров и не были приняты рекламодателями.
  2. Для сделок без резервирования всё зависит от позиции, на которую ориентирована сделка. Если запрос ставки может быть сопоставлен позициями, на которые ориентирована эта сделка, показ продолжится.

В: Можно ли повторно использовать идентификатор сделки в нескольких сделках?

A: Нет. ExternalDealId должен быть уникальным для всех продуктов.

В: Может ли в сделке быть несколько партнеров?

A: Если вы хотите, чтобы сделка была связана с несколькими партнерами, отправьте ее Центральному партнеру.

В: Может ли идентификатор партнера, связанный с идентификатором сделки, измениться после создания сделки?

A: Нет, после создания заказа сменить партнера невозможно.

В: Поддерживаете ли вы несколько имен издателей в заказе?

О: Поле «Имя» — это строка, используемая для информации рекламодателя. Вы можете указать имя нескольких издателей, разделив его запятыми, или просто указать «Несколько издателей из Exchange X».

В: В чем разница между статусами заказа «Отменено» и «Архивировано»?

A: Пользователи могут архивировать и разархивировать подписку. После отмены подписки пользователь не может её отменить.

В: Что такое «мгновенные предложения»? Многие атрибуты обязательны только для мгновенных предложений.

A: Мгновенные сделки — это отдельный процесс интеграции, использующий конечную точку API продавца. Не обращайте внимания на атрибуты, характерные для сценария мгновенной сделки. Они не связаны с рабочим процессом синхронизации сделок.

В: При создании заказа/товара я получаю сообщение об ошибке «Неверный запрос».

О: Причин может быть много, но ниже приведены несколько распространенных.

  1. Воспользуйтесь справочным руководством и проверьте, не пропустили ли вы какие-либо обязательные поля.
  2. External_deal_id должен быть уникальным для всех продуктов.
  3. Сделка по резервированию не поддерживает аукционную цену

Если ничего из вышеперечисленного не произошло, попробуйте использовать http-клиент, например Postman, чтобы проверить, содержит ли ответ полезную информацию.

Если ни одно из вышеперечисленных действий не помогло, обратитесь в службу поддержки API DV3 Seller.