> For the complete documentation index, see [llms.txt](https://docs.umg.team/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umg.team/main/udsp.io/integraciya-storonnei-dmp-s-udsp.md).

# Интеграция сторонней DMP с uDSP

Интеграция сторонней DMP с uDSP должна осуществляться с помощью пикселя для синхронизации.

### Пиксель для синхронизации

Пример пикселя для sync:

```html
<img src='https://d.dmp.com/1/7577/i/i?a=1580&e=$UID&i=$RND'/>
```

**Параметры:**

* `i` — параметр кешбастера (случайное число)
* `e` — идентификатор uDSP

Далее uDSP со своей стороны подставляет в пиксель свой идентификатор.

***

### Механика передачи сегментов

Необходимо каждый день предоставлять по FTP два файла: **Batch-файл** и **Meta-файл**.

#### 1. Batch-файл

Файл содержит данные о профилях пользователей и их сегментах.

**Формат и требования:**

* **Регулярность:** Батч поставляется ежедневно.
* **Формат:** Файл отсылается в формате `.tsv` с обязательной архивацией (`gzip`).
* **Размер:** Желательно дробить большие файлы на части (рекомендуемый размер одной архивированной части — менее 1 ГБ).
* **Формат записей батча:** `XXXXXXXXX/t120396,126573,213871`
  * `XXXXXXXXX` — идентификатор рекламной сети.
  * `120396, 126573, 213871` — идентификаторы сегментов, которые есть у профиля.

**Инкрементное обновление (опционально):** Поддерживается применение инкремента:

* При изменении информации о пользователе в батче передается строка с актуальным набором сегментов: `XXXXXXXXX/t120396,126573,213871`
* Если пользователь лишился всех сегментов: `XXXXXXXXX/t`

**Пример batch-файла (TSV):**

```tsv
11dd0221-9db5-4932-99a8-a65e3715fc27	279676
fa8219f1-5230-45e4-a3d3-6d2884720abe	279676
01dda97b-af97-4ad1-9345-5564397425c8	279676
```

*Где `11dd0221...` — user id, а `279676` — id сегмента.*

***

#### 2. Meta-файл

Файл должен содержать информацию по древу сегментов, их цене и доступности.

**Формат и требования:**

* **Формат:** Файл отсылается в формате `.tsv` **без архивации**.

**Пример записи в файле meta.tsv:**

```tsv
280250	Interest/Realty/Elite estate	35.0	160
280248	Interest/Realty/Medium budget	15.0	
280246	Interest/Realty/Economy-type budget	15.0	
280244	Interest/Realty/Other services	15.0	
280242	Interest/Realty/New Movers	15.0	
280240	Interest/Realty/Reality owners	15.0	
```

**Описание полей в Meta-файле:**

1. `280250` — id сегмента.
2. `Interest/Realty/Elite estate` — название/путь сегмента в дереве.
3. `35.0` — CPM (стоимость).
4. `160` — id пользователя uDSP с доступом к сегменту (может быть пустым, если доступ не ограничен).