Рабочие процессы API

Создать сделку

1. Проверьте, создан ли товар ранее, используя фильтр «Список товаров» с внешним идентификатором сделки (external_deal_id). Внешний идентификатор сделки (External_deal_id) должен быть уникальным для всех товаров.

   GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"
   

2. Создать заказ . Имя генерируется DV3, и мы рекомендуем сохранить этот идентификатор где-нибудь в вашей системе для дальнейшего использования.

3. Создайте продукт в разделе «Заказ» . Название продукта генерируется DV3, и мы рекомендуем сохранить этот идентификатор где-нибудь в вашей системе для дальнейшего использования.

   В качестве альтернативы вы всегда можете использовать LIST с external_deal_id. Поле «Имя» содержит как идентификатор заказа, так и идентификатор товара, что позволяет легко определить родительский элемент.

Отменить сделку

1. Изменить статус заказа на «Отменён». Поддерживается только отмена, если заказ не был принят. «Отменён» — это окончательное состояние. Повторная активация заказа после отмены невозможна.

Получить подробности о сделке

1. Получите информацию о заказе. Статус обновляется после того, как пользователь принимает, архивирует или отменяет заказ.
2. Получить подробную информацию о продукте .

Получить список предложений

1. СПИСОК заказов с фильтром по статусу, чтобы получить все принятые/ожидающие принятия заказы.
2. СПИСОК продуктов с фильтром external_deal_id.
3. ПЕРЕЧИСЛИТЬ все продукты в заказе.

Обновить сделку

1. Обновить заказ на контактную информацию издателя.
   1. Имя, не позволяет обновить (нельзя задать в field_mask). Статус можно установить только на «Отменено» через API.
   2. partner_id не допускает обновление.
2. Обновите продукт для обновления конкретных условий сделки.
   1. name, externalDealId, transactionType, pricingType, updateTime не могут быть обновлены.
   2. Обновление displayName не требует принятия пользователем.
   3. Обновление rateDetails. CreativeConfig изменит статус родительского заказа на «Ожидает принятия». Рекламодателям DV3 будет предложено принять новое условие на странице согласования, независимо от того, был ли принят предыдущий заказ.

Посмотрите, принял ли пользователь сделку

1. Получите заказ, если вам известен его идентификатор. Проверьте поле статуса.
2. Если идентификатор заказа не отслеживался: отобразите список товаров с фильтром external_deal_id , определите название заказа по названию товара , а затем нажмите «Получить заказ» . Проверьте поле статуса.

Посмотрите, настроил ли пользователь сделку (только для PG)

1. Получить источник инвентаря. Имя: «exchanges/{exchangeId}/inventorysources/{external_deal_id}». Проверить статус покупателя .
   1. Предложения по бронированию
      1. BUYER_STATUS_ACTIVE означает, что сделка принята и настроена. Ожидается, что сделка будет расходоваться в этом состоянии, когда DV3 получит запрос на ставку, соответствующий условиям сделки. Позиция автоматически генерируется на этапе настройки сделки. Подробнее см. в разделе «Настройка сделки» .
      2. BUYER_STATUS_PENDING означает, что заказ принят, но сделка ещё не настроена. В этом состоянии расходы не производятся.
      3. BUYER_STATUS_PAUSED означает, что сделка была явно приостановлена ​​рекламодателями. В этом состоянии расходы не производятся.
   2. Предложения без бронирования
      1. BUYER_STATUS_ACTIVE означает, что сделка принята. Ожидается, что сделка будет расходной в этом состоянии, если DV3 получит запрос на ставку, соответствующий условиям сделки, и если есть активная позиция, таргетингирующая эту сделку, и запрос на ставку соответствует критериям таргетинга позиции. Подробнее см. в разделе «Позиция» .** API продавца для запроса информации о таргетинге позиции НЕТ.**
      2. BUYER_STATUS_PENDING неприменимо.
      3. BUYER_STATUS_PAUSED означает, что сделка была явно приостановлена ​​рекламодателями. В этом состоянии расходы не производятся.

Приостановить/возобновить сделку после принятия

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

Повторные переговоры (обновление сделки после принятия)

Пересмотр условий сделки подразумевает внесение изменений в условия сделки после её принятия покупателем. Это может быть очень полезно как биржам, так и покупателям для внесения изменений в принятые сделки. Например, биржа может обнаружить, что время окончания принятой сделки неверно, и может использовать DV3 Update Product для отправки обновлений покупателям DV3, если сделка ещё не началась.

Какие изменения разрешены и запрещены.

Мы разрешаем вносить изменения во все поля, за исключением некоторых критически важных для обслуживания полей, таких как: startTime , endTime , rateDetails , creativeConfig и т. д. У нас есть валидации для этих критически важных для обслуживания полей. Как правило, обновления этих полей, за исключением creativeConfig , разрешены, если время начала сделки отстоит как минимум на 1 день в будущем. Для текущих сделок разрешены только инкрементные обновления, время начала которых в прошлом, а время окончания — в будущем. Изменения для завершенных сделок, время окончания которых в прошлом, не допускаются. Например, обновление rateDetails сделки, завершенной год назад, запрещено. В подобных случаях DV3 Update Product выдаст ошибку валидации.