Описание процесса синхронизации идентификаторов (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 процесс выглядит следующим образом:
UMG SSP вызывает sync endpoint DSP
пример https://dsp.io/rtb/sync/umg
DSP выполняет редирект на Redirect URL UMG SSP
пример https://dsp.io/rtb/sync/umg
-> https://a.utraff.com/sync?dsp=&buyerid=<buyer_id>
В SSP UMG фиксируется переданный идентификатор (buyerID) и устанавливается связь с User ID в таблице соответствия
buyer_id_1 = user_id_1
В дальнейшем UMG SSP передаcт buyerID в Bid Request, если найдено соответствие, что позволяет DSP идентифицировать пользователя;
{
"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
}
Пошаговый пример:
Шаг 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 без редиректа:
UMG SSP вызывает заранее сохранённый sync endpoint DSP, включая User ID платформы в запрос
Пример https://dsp.io/rtb/sync/umg?u={uid}
> https://dsp.io/rtb/sync/umg?u=PqMN4G8f4
DSP сохраняет полученный идентификатор на своей стороне
Этот сценарий используется, если DSP управляет таблицей соответствий самостоятельно, и редирект не требуется.
Last updated