Источники данных

Общий процесс подключения data источников

Данный документ описывает общий процесс взаимодействия для интеграции между AdSniper и дата провайдером.

1. Матчинг пользователей

Для того, что бы начать использовать сегменты, прежде всего необходимо сопоставить идентификаторы пользователей. Наиболее распространенным идентификатором является cookie пользователя. Процесс матчинга представляет собой вызов со стороны пользователя некоторого URL, в который подставлен внешний идентификатор пользователя, а внутренний идентификатор пользователя доступен из cookie в момент обращения к серверу.

Различают 2 вида матчинга: на стороне AdSniper и на стороне дата провайдера.

<img src="//sync.bumlam.com/?src=${DataProviderID}&uid=${DataProviderUID}&rurl=${DataProviderURL}" width="0" height="0" border="0">

Спецификация вызываемого сервиса.

Название элементаЗначение элементаКомментарий
схема//поддерживает как http, так и https протокол, поэтому наилучшим вариантом будет совершать вызов без указания протокола
хостsync.bumlam.comосновной домен AdSniper для хранения идентификаторов пользователя
src${DataProviderID}идентификатор провайдера данных, назначается на стороне AdSniper
uid${DataProviderUID}идентификатор пользователя со стороны дата провайдера
rurl${DataProviderURL}${DataProviderURL} urlencode от урла, в котором может присутствовать макрос ${UID}, при нахождении такого макроса мы заменим его на свой uid

2. Передача данных

Процесс передачи данных состоит из: передачи таксономии и непосредственно данных.

Таксономия представляет собой идентификатор сегмента и описание этого сегмента (при этом описание может представлять собой набор полей или вложенную структуру).

Данные представляют собой идентификатор пользователя на стороне дата провайдера и перечисление сегментов, к которым относится пользователь.

Мы ожидаем следующую структуру файла в выгрузке DMP, который содержит идентификаторы пользователей и перечисление сегментов, с которым соотносится пользователь:

Идентификатор пользователя\tИдентификатор сегмента1,Идентификатор сегмента2…Идентификатор сегмента n