ADFOX Sites Help

Разметка пользователей - getid

Стандартный процесс разметки пользователей

Разметка пользователей, посетивших сайт с установленными кодами вызова ADFOX, производится с помощью записи идентификатора пользователя в Cookie-файлы.

При загрузке страницы с кодом ADFOX, браузер отправляет запрос к рекламному серверу.

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

Если пользователь не размечен, то для запроса устанавливается тестовое значение aaaa:aaaa:aaaa:aaaa. Затем браузер отправляет 302 REDIRECT getCodeTest, чтобы считать установленное тестовое значение:

-- если тестовое значение записано в браузере, то считается, что запись Cookie включена и производится разметка пользователя — выдается реальный идентификатор;

-- если тестового значения нет, значит запись Cookie выключена и пользователю идентификатор не выдается.

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

Особенности разметки для браузеров с ITP политикой.

Браузеры с Intelligent Tracking Preventio (далее — ITP) политикой отслеживают cookie-файлы от сторонних рекламных сетей и удаляет их каждые 24 часа, что усложняет идентификацию пользователей и таргетирование рекламы.

ADFOX автоматически определяет такие браузеры: iOS>= 11 или Safari High Sierra и старше.

При загрузке сайта в браузере с ITP политикой:
• При использовании кодов вставки с библиотекой loader.js к запросу добавляются два параметра extid_loader и extidtag_loader и сервер определяет пользователей по этим идентификаторам.
• Значение куки или параметра lpdid игнорируется.

Если на сайте используются устаревшие коды вставки без loader.js или код вставки установлен в плеере, то для настройки идентификации пользователей с учетом браузеров с ITP политикой, рекомендуем обратиться в службу технической поддержки.


Разметка пользователей с помощью getid

Вызов getid дает возможность получить идентификатор пользователя ADFOX, в том числе до вызова кода вставки ADFOX.

Если пользователь уже имеет идентификатор, то getid передаст его в заголовках запроса и в ответе сервер вернет текущий идентификатор пользователя, обновив при этом информацию о пользователе на сервере ADFOX.

Случаи применения getid:

  1. В некоторых браузерах (например, Safari под iOS) не работает редирект, который необходим при стандартном процессе разметки пользователей. Для обхода этого ограничения в html 5 плеерах есть готовое решение, см. подробнее тут.

  2. Если выключена запись кук в браузере, или запрещена запись кук от третьих сторон, но при этом владелец сайта желает размечать пользователей, хранить идентификаторы на своей стороне и передавать их в запросах к ADFOX.
    В этом случае вызов getid позволяет получить идентификатор пользователя, после чего идентификатор может быть записан в локальное хранилище в браузере или в любое другое (localStorage и т.п.).

Далее, при рекламных запросах, нужно к каждому запросу подставлять параметр lpdid= и в качестве значения передавать идентификатор пользователя из хранилища.

Например:

//ads.adfox.ru/owner_id/***/prepareCode?p1=***&p2=***&pct=***&pfc=***&pfb=***&pr=638047&lpdid=24:10914658

В случае запроса за рекламой из браузера с ITP политикой значение параметра lpdid игнорируется.

Формат запроса getid

Вызов getid формируется следующим образом:

//ads.adfox.ru/owner_id/getid?pr=13123&t=json

где:

http:// - протокол запроса. Если используется SSL соединение, то необходимо делать вызов с протоколом https://

ads.adfox.ru - домен, на который произойдет установка куки, по умолчанию - на домен adfox.ru

owner_id - нужно указать номер owner_id вашего аккаунта

getid - функция, принимающая переменные:

t - формат ответа:
t=json
t=jsonp&f=functionName
t=xml
t=raw
t=cookie (empty file)
t=redirect (для синхронизации кук)

pr - случайное число для рандомизации ссылки

Если вызвать getid повторно для пользователя, у которого уже установлен идентификатор, то getid передаст его в заголовках запроса и в ответе вернет текущий идентификатор пользователя, обновив информацию о пользователе на сервере ADFOX.

Синхронизация кук через редирект

В случае t=redirect активизируется режим перенаправления, в котором вызов getid формируется в виде:

//ads.adfox.ru/owner_id/getid?pr=13123&t=redirect&u=...

где:

u - целевой адрес для перенаправления, в котором допустимы следующие макросы:

%lpduserid% - значение идентификатора пользователя в системе ADFOX,  
%random% - случайное число для рандомизации ссылки.

Например, при запросе вида:

//ads.adfox.ru/owner_id/getid?pr=13123&t=redirect&u=http://site.ru/1/c/v/2?e=%lpduserid%

произойдёт перенаправление на:

http://site.ru/1/c/v/2?e=24:10914658

В случае, если целевой адрес u содержит более одного параметра, весь адрес должен быть url encoded.

Например, для целевого адреса

http://site.ru/1/c/v/2?e=%lpduserid%&a=%random%

запрос должен иметь вид

//ads.adfox.ru/owner_id/getid?pr=13123&t=redirect&u=http%3A%2F%2Fsite.ru%2F1%2Fc%2Fv%2F2%3Fe%3D%25lpduserid%25%26a%3D%25random%25

В случае отсутствия в запросе параметра u перенаправление не будет произведено со статусом 404 из-за отсутствия ссылки для перенаправления.