Трекерный код AdRiver для сайта рекламодателя.

Описание и инструкция по установке на HTML-сайт

1. Описание трекерного кода AdRiver

Код AdRiver типа JS-counter предназначен для обеспечения синхронизации идентификаторов AdRiver и веб-аналитической системы сайта рекламодателя для последующей postview иpostclick- аналитики рекламных кампаний рекламодателя.

Для учета 1st party cookie AdRiver и автоматического получения и передачи ID пользователя Google Analytics (GA), Яндекс.Метрика (ЯМ) или других собственных идентификаторов (например, из CRM или 1st party cookie сайта) на сайте нужно разместить библиотеку FPS и код JS-counter.

Что делает код:

Собирает информацию о совершении посетителями сайта целевых действий, таких как посещение определенных разделов сайта, нажатий на кнопки, заполнений форм, действий в интерфейсе и тп., для дальнейшей оценки эффективности рекламных затрат путем сопоставления информации о контактах пользователя с рекламой и действиях на сайте рекламодателя. Реализуется с помощью postview иpostclick- аналитики рекламных кампаний.
Собирает обезличенные списки посетителей сайта рекламодателя, не являющихся персональными данными с точки зрения 152-ФЗ, с целью дальнейшего анализа их состава с помощью ПО AdRiver в ходе планирования рекламных активностей рекламодателя, а также с целью повторной коммуникации с этими посетителями на ресурсах сети Интернет.
Присваивает уникальные ID посетителям сайта для дальнейшей реализации заявленных выше целей.

Продукты AdRiver, где рекламодатель получает статистику postclick и postview

2. Инструкция по установке трекерного кода AdRiver на HTML-сайт рекламодателя

2.1. Менеджер AdRiver предоставит вам ваши коды для трекерного сайта согласно вашему Техническому заданию.

В ТЗ сообщите менеджеру AdRiver адреса (URL’ы) целей – то еcть контрольных точек сайта. Контрольные точки сайта рекламодателя — это те страницы или группы страниц сайта, которые интересны для исследования в рамках текущей рекламной кампании или рекламной деятельности в целом. Если у рекламодателя специфическая система публикации информации на сайт, которая может изменить вставляемые коды, обязательно сообщите об этом вашему менеджеру, чтобы можно было адаптировать ваши коды под ситуацию.

2.2. Трекерные коды бывают трех видов:

Скриптовый — JS-код — стандартный код.
Обеспечивает статистику, сбор 3p-кук, выдачу новых 3p-кук, сбор 1p-кук.
Библиотека FPS идет в комплекте, она обеспечивает выдачу новых 1p-кук, синк с моб. операторами.
IMG-код — код картинки без JS -скрипта.
Обеспечивает статистику, сбор 3p-кук, выдачу новых 3p-кук, сбор 1p-кук, но все это без дополнительной скриптовой части.
Библиотека FPS идет в комплекте, она обеспечивает выдачу новых 1p-кук, синк с мобильными операторами.
Код для финансовых сервисов — JSCounter подтипа IMG(AdRiverCounterImage) по кнопке «для финансовых сервисов».
Его особенности:
- применяется для страниц, куда рекламодатель по каким-либо причинам не может установить FPS-библиотеку, а готов поставить только небольшой кусок кода с каунтером. Например, где есть фреймы, в которые нельзя ставить JS-код, но при этом необходимо посчитать статистику действия для них (например, отправку сообщений),
- сбор с 3p-cookie, выдача новых 3p-кук
- умеет работать с существующей 1p-cookie только в случае, если вызывается из фреймов того же домена или поддомена, как и страница, на которой был установлен вызов FPS библиотеки
Библиотека FPS по умолчанию НЕ идет в комплекте, но может быть дополнительно установлена по просьбе рекламодателя. Хотя в данном случае рекомендуем перейти на тип кода JS-код или IMG-код. Инструкция по самостоятельному получению кодов

Для любого вида кода выдается как минимум два файла кодов:

сквозной код — устанавливается на все страницы сайта рекламодателя и вызывается как просмотровый
коды для целевых действий устанавливаются, как правило, на кнопки. Код вызывается при совершении конкретного действия (положить в корзину, купить, подключить, записаться на тест драйв и т.д.). Кодов на цели обычно несколько, но как минимум один код требуется.

Установив единожды сквозной код на всех страницах сайта рекламодателя в дальнейшем в интерфейсе AdRiver можно добавлять сайтзоны по шаблону (url) и не выдавать каждый раз новый код для установки.
Коды для целевых действий индивидуальны, т.е. при добавлении в сайт новой сайтзоны по алиасу, для целевого действия нужно выдать свой код и установить его тоже нужно дополнительно.

2.3. Помимо установки трекерных кодов требуется установить библиотеку FPS

Рекомендуется размещение подключение библиотеки FPS в тэгах <head>.

    <script src="https://content.adriver.ru/AdRiverFPS.js"></script>

Зачем нужна эта библиотека? Так как браузеры блокируют либо ограничивают 3p-куки, то это приводит к потере некоторой части данных атрибуции. AdRiver предлагает установить библиотеку AdRiverFPS на сайте рекламодателя. Библиотека создаёт 1p-куку — идентификатор пользователя в системе AdRiver устойчивый к блокировкам браузеров, продлевает его жизнь и связывает визиты с показами, кликами рекламы, позволяя считать post-click и post-view конверсии более полно. Благодаря ей мы не теряем пользователей даже в Safari/Firefox или при отключённых 3p-cookies.

Для чувствительных клиентов возможен вариант размещения библиотеки FPS на серверах рекламодателя:

Скачать библиотеку AsdRiverFPS по адресу https://content.adriver.ru/AdRiverFPS.js
Разместите скрипт на ваших серверах
Сформируйте URL файла скрипта для загрузки с ваших серверов

Добавьте загрузку скрипта в раздел <head> на все страницы вида:

<script src="https://{путь к библиотеке на вашем сервере}/AdRiverFPS.js"></script>

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

Библиотека AdRiverFPS не подгружает никаких дополнительных js файлов, при своей работе.
Запросы все равно пойдут на сервера AdRiver, но это будут не запросы за js, а только за json и картиночными счётчиками (img counter). Что, тем не менее, позволит создавать 1p-куку пользователя и пополнять ее идентификаторами.

2.4. Полученный код можно опубликовать на сайте согласно инструкциям:

Инструкция для установки кодов через GTM
Инструкция для установки кодов через YTM
Инструкция установки кода напрямую на сайт – установите полученный код как можно выше по телу страниц вашего сайта, желательно рядом с кодами используемой вами системой веб-аналитики.

Сквозной код необходимо установить на все страницы сайта.
Коды целевых действий нужно установить на соответствующие контрольные точки (цели).

2.5. Код и библиотека автоматически найдут на странице ID GA и ID ЯМ и передадут в запросе в параметрах gid1 и yid1.

2.6. При размещении кода на страницах сайта через Google Tag Manager (GTM) и наличии возможностей получения ID через надстройку custom task можно самостоятельно заполнять значениями в коде параметры gid1:»»,yid1:»»
В таком случае передаваться в запросе будут в первую очередь заполненные значения параметров.
Если значения параметров остаются пустыми, то код автоматически их заполнит.

2.7. Если сайту требуется передача собственного ID пользователя (например, по данным CRM или 1st party cookie), то в секцию id нужно вписать название собственного ID.
Здесь внимание – не значение, а НАЗВАНИЕ ID или собственной 1st party cookie сайта.
Библиотека и код автоматически передадут в запросе значение cookie под этим названием в отдельном параметре suid.

2.8.Для учета нажатий на кнопки воспользуйтесь инструкцией установки JS-counter на кнопки

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

2.10. Дефолтная сайтзона трекерного сайта с сентября 2025г. по умолчанию не выводится в дашбордах, поэтому при желании получать по ней статистику, ее следует завести как отдельную сайтзону (цель) в вашем трекерном сайте AdRiver.

2.11. Сообщите вашему менеджеру AdRiver когда коды AdRiver JS-counter будут установлены на сайт. Это необходимо чтобы вовремя проверить корректность их установки. Для самостоятельной проверки корректности воспользуйтесь инструкцией

3. Примеры трекерных кодов и описание их параметров

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

3.1.1. Скриптовый JS-код — сквозной (all site)

<!-- AdRiver code START. Type:JS-counter Site: Client -->
<!--Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"></script> -->

<script type="text/javascript">
window.adrCounterStorage = window.adrCounterStorage || []; window.adrCounterStorage.push(function() {
  new AdriverCounterJS({sid:000000, bt:62},{id:"",gid1:"",yid1:""})
});
</script>
<!-- AdRiver code END -->

3.1.2.Скриптовый JS-код — код на действие

<!--AdRiver code START. Type:JS-counter Site: Client  SZ: stranica-1 -->
<!--Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"></script>-->

<script type="text/javascript">
  window.adrCounterStorage = window.adrCounterStorage || []; window.adrCounterStorage.push(function() {
    new AdriverCounterJS({sid:000000, bt:62, sz:'knopka_deistvie'},{id:"",gid1:"",yid1:""})
  });
</script>
<!-- AdRiver code END -->

3.2. IMG-код — сквозной (all site)

<!-- AdRiver code START. Type:JS-counter Вызов картинки. Site: Client -->
<!--Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"></script>-->

<script type="text/javascript">
window.adrCounterStorage = window.adrCounterStorage || []; window.adrCounterStorage.push(function() {
  new AdriverCounterImage({sid:000000, bt:62},{id:"",gid1:"",yid1:""})
});
</script>
<!-- AdRiver code END -->

3.3.Код для финансовых сервисов — сквозной (all site)

<script type="text/javascript">
!function(e,n){function o(e,n,o){n=n||"&",o=o||"=";var d=[];for(var r in e)e.hasOwnProperty(r)&&d.push(r+o+encodeURIComponent(e[r]));return d.join(n)}function d(e,n){var o=e.cookie.match("(^|;) ?"+n+"=([^;]*)(;|$)");return o?decodeURIComponent(o[2]):null}var r,t,i,c,u;r=e,t=n,i=document.domain,c={tail256:document.referrer||"unknown"},void 0!==(u=function(e){var n={};if(e){var o=e.split("&");for(var d in o)if(o.hasOwnProperty(d)){var r=o[d].split("=");void 0!==r[0]&&void 0!==r[1]&&(n[r[0]]=decodeURIComponent(r[1]))}}return n}(window.location.search.substring(1))).adrclid&&(r.fsid=u.adrclid),null!==d(document,"adrcid")&&(r.cid=d(document,"adrcid")),t&&t.id&&null!==d(document,t.id)&&(r.suid=i+"_"+encodeURIComponent(d(document,t.id))),t&&t.gid1?r.gid1=t.gid1:null!==d(document,"_ga")&&(r.gid1=encodeURIComponent(d(document,"_ga"))),t&&t.yid1?r.yid1=t.yid1:null!==d(document,"_ym_uid")&&(r.yid1=encodeURIComponent(d(document,"_ym_uid"))),r.loc=encodeURIComponent(window.location.href),r.custom&&(r.custom=o(r.custom,";")),function(e,n){!function(e){if(e=e.split("![rnd]").join(~~(1e6*Math.random())),document.createElement&&document.body){var n=document.createElement("img");n.style.position="absolute",n.style.display="none",n.style.width=n.style.height="0px",n.setAttribute("referrerpolicy","no-referrer-when-downgrade"),n.src=e,document.body.appendChild(n)}else{var o=new Image;o.setAttribute("referrerpolicy","no-referrer-when-downgrade"),o.src=e}}("https://ad.adriver.ru/cgi-bin/rle.cgi?"+e+"&rnd=![rnd]"+(n?"&"+n:""))}(o(r),o(c))}
({sid:000000, bt:62},{id:"",gid1:"",yid1:""});
</script>

3.4. Запрос трекерного кода на сервер AdRiver

В процессе работы трекерный код отправляет GET-запрос на сервер ad.adriver.ru .

Пример строки запроса:
https://ad.adriver.ru/cgi-bin/rle.cgi?sid=223961&bt=62&sz=order&custom=1=hid;2=wuid;5=any_id;66=any_id_1&cid=A1t9mqBgi1WKRvQc6ZtyJwQ&gid1=GA1.2.949755102.1597758005&loc=http%3A%2F%2Ffiles.adriver.ru%2Fksi%2Ftinkoff.html&rnd=569936&tail256=unknown

Список доменов на стороне AdRiver, на которые отправляются данные работы кода, размещенного на сайте рекламодателя:

ad.adriver.ru
content.adriver.ru

Параметры GET-запроса кода:

sid — ID сайта в системе ( регистрируется менеджером в системе и остается статичным всегда)
bt — тип баннера, для трекингового пикселя это всегда 62
sz — строка, например «order», «order_confirm» и т.д. — название конверсионного события в случае, если для данного конверсионного события не используется определение по URL и настроенным в системе шаблонам. Если параметр указан, то он имеет больший приоритет, чем настроенные в системе шаблоны соответствия URL -> событие. Ограничение 256 байт.
gid1 — ID Google Analytics (строка 64 байта)
yid1 — ID Яндекс.Метрика (строка 64 байта)

значения параметров gid1, yid1 можно указать средствами сайта, если параметры в коде остаются пустыми, код самостоятельно может взять их из cookie GA или ЯМ текущей страницы
custom — в него можно передавать несколько разных кастомных значений параметров и для этого у параметра есть номер позиции.
В коде он выглядит вот так — custom: {1:'hid', 2:'wuid',5:'any_id',66:'any_id_1'}
Параметр custom — строка с ограничением в 512 байт.
suid — параметр для передачи 1 st party cookie сайта для идентификации пользователя при необходимости использовать этот идентификатор в постклик- или поствью-аналитике. Параметр suid заполняется кодом автоматически при указании в коде в параметреid названия 1st party cookie сайта.
Если параметр кода id:““ остается пустым, то в suid также ничего не будет передаваться.
loc — параметр для передачи URL страницы через JS
rnd — параметр случайного числа для предотвращения кэширования запросов пикселя браузерами.
tail256 — параметр для передачи URL предыдущей страницы
Если библиотека не подключается, в этом параметре на странице подставляется 3rd party cookie AdRiver из http-заголовков.

Параметры http-заголовков GET- запроса:

Cookie — cid = {3rd party cookie AdRiver}
Host — ad.adriver.ru
Referer — URL источника запроса, по сути адрес страницы показа пикселя.
User-Agent — идентификационная строка клиентского приложения/браузера
User IP — уникальный числовой идентификатор устройства в компьютерной сети, работающей по протоколу TCP/IP

В ответ на данный запрос сервер AdRiver отвечает реплаем с ContentType=image/gif, в теле ответа отдается картинка gif размером 1х1 пиксель.

Хост ad.adriver.ru размещен в дата-центре https://www.xelent.ru/. Это собственные сервера компании AdRiver.

AdRiver CDN — собственные сервера компании AdRiver. Все договоры заключены с российскими юр. лицами, все сервера размещены в России.
Список хостов AdRiver CDN:

sib2.adriver.ru
edp2.adriver.ru
masterh5.adriver.ru
mh6.adriver.ru
masterh7.adriver.ru
mh8.adriver.ru
servers2.adriver.ru
servers3.adriver.ru
servers7.adriver.ru
servers1.adriver.ru
servers4.adriver.ru
servers6.adriver.ru

Время хранение данных: данные хранятся в течение 365 дней.

Доступ к данным статистики и логов по трекерному сайту рекламодателя и статистике имеют:

ответственные лица лица Рекламодателя/Агентства, в чьем кабинете заведён трекерный сайт,
ответственные аккаунт-менеджера AdRiver,
технического дивизиона AdRiver (техподдержка, отдел аналитики, отдел системных администраторов).

По запросу и под ответственность Рекламодателя/Агентства, в чьем кабинете заведён сайт, AdRiver предоставляет доступ к данным логов по сайту третьим лицам (Клиенту, подрядчику и т.д.).

4. Конфиденциальность и персональные данные

AdRiver соблюдает нормы конфиденциальности, соответствующие требованиям Российского законодательства, международным рекомендациям и этическим стандартам. Мы не собираем персональные данные при посещении сайта www.adriver.ru, за исключением случаев, когда пользователь предоставляет их добровольно. В таких случаях данные используются исключительно для обратной связи.

Библиотека AdRiverFPS получает 1st party cookie пользователя , код JS (либо код IMG, либо код для финансовых сервисов) получает 3st party cookie пользователя для оказания услуг атрибуции в интересах рекламодателя и согласно Политике конфиденциальности AdRiver.

Система AdRiver использует файлы cookie исключительно для идентификации браузера или устройства, без какого-либо сбора персональных данных (имя, адрес, телефон, пол, возраст, предпочтения). Это технический обезличенный идентификатор не влияющий на процессы на сайте рекламодателя, он безопасен и на конфиденциальность данных не влияет.

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

географическое местоположение IP-адреса;
операционная система и браузер пользователя;
количество показов и кликов по рекламным сообщениям;
число посещений и URL-адреса страниц интернет-ресурсов;
обезличенные списки посетителей сайтов Пользователя/рекламодателя для анализа в ПО AdRiver (не являются персональными данными в соответствии с Федеральным законом № 152-ФЗ).

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