Описание процесса синхронизации идентификаторов (Cookie Sync) между UMG SSP и сторонними DSP

Платформа UMG поддерживает несколько сценариев синхронизации идентификаторов пользователей (Cookie Sync) со сторонними DSP.

Internal Sync Type (Внутреннее хранение)

В данном сценарии DSP выполняет редирект на UMG SSP, передавая свой идентификатор пользователя (buyerID), который сохраняется в таблице соответствия.

1.1 Обычный редирект:

UMG вызывает предварительно сохранённый URL DSP например, https://dsp.io/rtb/sync/umg, после чего DSP выполняет редирект на UMG SSP с передачей идентификатора пользователя: https://a.utraff.com/sync?dsp=&buyerid=<buyer_id> В результате UMG SSP фиксирует соответствие между идентификаторами.

1.2 Редирект через параметр Sync URL:

UMG вызывает сохранённый URL DSP, передавая в нем redirect_url, ведущий на UMG: https://match.dsp.io/cm?ssp=umg&redirect_url=https%3A%2F%2Fa.utraff.com%2Fsync%3Fdsp%3Dohmybid%26buyerid%3D{{uid}} DSP подставляет идентификатор {uid} и вызывает redirect_url, передавая UMG идентификатор пользователя.

Во время Internal Sync Type процесс выглядит следующим образом:

1

UMG SSP вызывает sync endpoint DSP

пример https://dsp.io/rtb/sync/umg

2

DSP выполняет редирект на Redirect URL UMG SSP

пример https://dsp.io/rtb/sync/umg -> https://a.utraff.com/sync?dsp=&buyerid=<buyer_id>

3

В SSP UMG фиксируется переданный идентификатор (buyerID) и устанавливается связь с User ID в таблице соответствия

buyer_id_1 = user_id_1

4

В дальнейшем UMG SSP передаcт buyerID в Bid Request, если найдено соответствие, что позволяет DSP идентифицировать пользователя;

Bid Request reference including buyerID

{
  "id": "1234567890",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 250
      },
      "bidfloor": 0.5
    }
  ],
  "site": {
    "id": "example-site-id",
    "domain": "example.com",
    "page": "https://example.com/page"
  },
  "device": {
    "ua": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
    "ip": "192.168.1.1"
  },
  "user": {
    "id": "user-id-12345",
    "buyeruid": "buyer-id-67890"  // Уникальный идентификатор покупателя (buyer ID)
  },
  "at": 1,
  "tmax": 100
}

Настройка Matched Only для аукциона со сторонней DSP-платформой возможна только при сценариях с внутренним хранением пар соответствия.

Пошаговый пример:

Шаг 1 — https://exchange.buzzoola.com/cookiesync/redirect?redirect_url= Шаг 2 — переключаем Sync type = internal Шаг 3 — в Redirect URL устанавливаем макрос DSP https://a.utraff.com/sync?dsp=Buzzoola&buyerid=${UUID} Шаг 5 — Кодируем Redirect URL на сайте https://www.urlencoder.org/ получаем https%3A%2F%2Fa.utraff.com%2Fsync%3Fdsp%3DBuzzoola%26buyerid%3D%24%7BUUID%7D Шаг 6 — подклеиваем encoded Redirect URL в Sync URL DSP получаем https://exchange.buzzoola.com/cookiesync/redirect?redirect_url=https%3A%2F%2Fa.utraff.com%2Fsync%3Fdsp%3DBuzzoola%26buyerid%3D%24%7BUUID%7D Шаг 7 проверяем — вызвав URL https://exchange.buzzoola.com/cookiesync/redirect?redirect_url=https%3A%2F%2Fa.utraff.com%2Fsync%3Fdsp%3DBuzzoola%26buyerid%3D%24%7BUUID%7D в строке адреса браузера в случае если все настроено корректно сработает редирект на нас с подстановкой byerid, пример https://a.utraff.com/sync?dsp=Buzzoola&buyerid=ef430e57-6c15-46a2-43d6-4603bf143c8a

External Sync Type

В этом сценарии SSP UMG передаёт свой User ID напрямую в DSP, без выполнения редиректа.

Sync без редиректа:

1

UMG SSP вызывает заранее сохранённый sync endpoint DSP, включая User ID платформы в запрос

Пример https://dsp.io/rtb/sync/umg?u={uid} > https://dsp.io/rtb/sync/umg?u=PqMN4G8f4

2

DSP сохраняет полученный идентификатор на своей стороне

Этот сценарий используется, если DSP управляет таблицей соответствий самостоятельно, и редирект не требуется.