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

Найдите ответы на часто задаваемые вопросы об интеграции с API Display & Video 360 Deal Sync.

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

A: Идентификатор обмена данными назначается командой Display & Video 360 во время настройки аутентификации.

В: Какова цель иерархии заказов и товаров?

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

В: Существует ли тип сделки, доступный для ВСЕХ рекламодателей?

A: API синхронизации сделок предназначен для закрытых сделок. Для публичных сделок, отобранных для всех рекламодателей, см. пакеты аукциона (пакеты инвентаря) .

В: Что произойдет, если у сделки нет конечной даты?

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

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

А: Да, но для каждого продукта допускается только один тип креатива.

В: Поддерживаются ли нативные креативы в рамках программно-гарантированных сделок (PG)?

A: Нет. Предложения с гарантированным бронированием не поддерживают нативные креативы ( CREATIVE_TYPE_NATIVE ).

Обратитесь к представителю Google, если хотите запускать программы гарантированной программной рекламы, принимающие нативные креативы.

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

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

В: Требуется ли определенная продолжительность для сделок по программной гарантированной рекламе видео (PG)?

А: Нет. Если параметр не задан, длительность по умолчанию будет равна ANY .

В: Приводят ли какие-либо статусы заказа к остановке сделки?

А: Нет. Заказ является исключительно предметом переговоров. Изменения в отношении показа рекламы вступают в силу только после того, как рекламодатель примет Заказ.

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

А: Действие соглашения продолжается на ранее согласованных условиях. После того, как рекламодатель примет обновленные условия, действие соглашения начнется на новых условиях.

В: Будет ли соглашение оставаться в силе, если обновленные условия еще не приняты?

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

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

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

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

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

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

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

А: Нет. Партнера нельзя изменить после создания заказа.

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

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

В: В чем разница между статусами заказа «ОТМЕНЕНО» и «АРХИВИРОВАНО»?

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

В: Что такое "мгновенные предложения"?

A: Интеграция мгновенных сделок осуществляется отдельно с использованием конечной точки API продавца. Игнорируйте атрибуты, специфичные для мгновенных сделок; они не связаны с рабочим процессом синхронизации сделок.

В: Что следует проверить, если я получаю ошибку "Неверный запрос"?

А: Ниже перечислены несколько распространенных причин:

1. Проверьте справочное руководство, чтобы убедиться, что все обязательные поля заполнены.
2. Убедитесь, что external_deal_id является уникальным для всех продуктов.
3. Убедитесь, что в условиях бронирования не указывается цена, устанавливаемая на аукционе.

Если проблема сохраняется, проверьте запрос с помощью HTTP-клиента, например Postman, чтобы изучить подробные сообщения об ошибках в теле ответа.

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