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

  1. Стандартный процесс разметки пользователей
  2. Особенности разметки для браузеров с ITP политикой.
  3. Разметка пользователей с помощью getid
  4. Формат запроса getid
  5. Синхронизация кук через редирект

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

Разметка пользователей, посетивших сайт с установленными кодами вызова 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. Если выключена запись кук в браузере, или запрещена запись кук от третьих сторон, но при этом владелец сайта желает размечать пользователей, хранить идентификаторы на своей стороне и передавать их в запросах к 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 — формат ответа:
    • pr — случайное число для рандомизации ссылки

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