Разметка пользователей - getid
Статья была обновлена
21.11.2018
Стандартный процесс разметки пользователей
Разметка пользователей, посетивших сайт с установленными кодами вызова 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:
В некоторых браузерах (например, Safari под iOS) не работает редирект, который необходим при стандартном процессе разметки пользователей. Для обхода этого ограничения в html 5 плеерах есть готовое решение, см. подробнее тут.
Если выключена запись кук в браузере, или запрещена запись кук от третьих сторон, но при этом владелец сайта желает размечать пользователей, хранить идентификаторы на своей стороне и передавать их в запросах к 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 из-за отсутствия ссылки для перенаправления.