# Описание процесса синхронизации идентификаторов (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:**&#x20;

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 процесс выглядит следующим образом:

{% stepper %}
{% step %}
UMG SSP вызывает sync endpoint DSP

пример [`https://dsp.io/rtb/sync/umg`](https://dsp.io/rtb/sync/umg)&#x20;
{% endstep %}

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

пример [`https://dsp.io/rtb/sync/umg`](https://dsp.io/rtb/sync/umg) -> `https://a.utraff.com/sync?dsp=&buyerid=<buyer_id>`
{% endstep %}

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

`buyer_id_1 = user_id_1`
{% endstep %}

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

{% code title="Bid Request reference including buyerID" fullWidth="true" %}

```json
{
  "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
}
```

{% endcode %}
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Настройка Matched Only для аукциона со сторонней DSP-платформой возможна только при сценариях с внутренним хранением пар соответствия.
{% endhint %}

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

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

### **External Sync Type**&#x20;

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

#### **Sync без редиректа**:&#x20;

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

Пример `https://dsp.io/rtb/sync/umg?u={uid}` > `https://dsp.io/rtb/sync/umg?u=PqMN4G8f4` &#x20;
{% endstep %}

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

{% endstep %}
{% endstepper %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umg.team/main/ussp.io/opisanie-processa-sinkhronizacii-identifikatorov-cookie-sync/opisanie-processa-sinkhronizacii-identifikatorov-cookie-sync-mezhdu-umg-ssp-i-storonnimi-dsp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.