ADFOX Sites Help

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Например:

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

где:

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 - случайное число для рандомизации ссылки

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

где:

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

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

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

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

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

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