ADFOX Sites Help

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

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

ADFOX выдает идентификатор пользователю, только если этот идентификатор возможно сохранить в куках пользователя. Это реализовано с помощью установки тестового значения идентификатора и редиректа. Пример:

  1. На сайт, где установлены коды ADFOX, пришел посетитель;

  2. Код ADFOX отправляет первый запрос getCode к серверу;

    - если у пользователя уже установлен идентификатор, то он передается в заголовках запроса и пользователю показывается реклама;

    - если у пользователя идентификатора нет, то getCode устанавливает тестовое значение aaaa:aaaa:aaaa:aaaa и производит 302 REDIRECT getCodeTest;

  3. getCodeTest проверяет наличие идентификатора aaaa:aaaa:aaaa:aaaa:

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

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

Формат запроса 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 из-за отсутствия ссылки для перенаправления.

Функционал getid

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

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

  2. Если выключена запись кук в браузере, или запрещена запись кук от третьих сторон.

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

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

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

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

Например:

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