Варианты трекерных кодов для сайта рекламодателя: JS, IMG, для фин.сервисов
1. Варианты трекерных-кодов AdRiver на сайте рекламодателя
Для сайта рекламодателя можно получить один из трех вариантов трекерного кода:
- Код JS (название в интерфейсе JS (AdRiverCounterJS)
- Код IMG (название в интерфейсе AdRiverCounterImage)
- Код для финансовых сервисов (название в интерфейсе – сначала AdRiverCounterImage затем под окном кода «код для финансовых сервисов»)
Их характеристики см в статье.
Код JS и код IMG – короткие и их легко разместить на сайте с помощью YTM и GTM
Код для финансовых сервисов содержит исполняемую часть сразу в себе (что является частым требованием службы безопасности рекламодателя) и поэтому достаточно объемный, что требует его установки на сайте напрямую.
Любой из трех вариантов надо получать в интерфейсе по типу кода JS-counter:
Для любого из трех вариантов кодов необходимо получить как минимум два обязательных файла кодов – сквозной код и код на целевое действие (цель, сайтзона), также часто требуется код на действие.
- Сквозной код — устанавливается на все страницы сайта рекламодателя и вызывается как просмотровый.
Также на всех страницах вместе со сквозным кодом необходимо подключить библиотеку FPS. Без нее не будут учитываться
1p-куки и часть конверсий теряется из учета.
Установив единожды сквозной код на всех страницах сайта рекламодателя в дальнейшем в интерфейсе AdRiver можно добавлять сайтзоны по шаблону (url) и не выдавать каждый раз новый код для установки. - Код на целевое действие (на цель) – необходим для учета посещения конкретной страницы или совершении целевого действия (положить в корзину, купить, подключить, записаться на тест драйв и т.д.). Кодов на цели обычно несколько, но как минимум один код требуется. Код на целевое действие в отличие от просмотрового делается на конкретную сайтзону (SZ) и имеет в коде отдельное имя — alias. То есть это код на цель уникален — при добавлении в трекерный сайт в интерфейсе AdRiver новой сайтзоны по алиасу для цели нужно получить для нее отдельный код и установить его тоже нужно на цель дополнительно помимо уже установленного сквозного кода.
Дополнительно к сквозному и целевому коду возможно получать еще другие подвиды кодов (внутри каждого из трех вариантов трекерного кода). А именно:
- Код на сайтзону на действие — для учета отдельных событий — нажатий на кнопки, нажатий на отдельные элементы внутри страницы.
- Код на сайтзону просмотровый для закрытых областей сайта – фреймов
- Код сквозной просмотровый для e-commerce параметров
- Код для учета количества отправленных форм
2. Получение трекерных кодов в интерфейсе
2.1. Вариант 1 код JS (AdRiverCounterJS)
2.1.1. Вариант 1 код JS (AdRiverCounterJS) — сквозной просмотровый на все страницы сайта рекламодателя
Шаги:- Тематическая зона — выбрать «Без сайтзон»
- Тип баннера — выбрать JS-counter. При его выборе появятся доп. настройки выбора подтипа: JS(AdRiverCounterJS)/ IMG(AdRiverCounterImage)
- Тип JSCounter — выбрать JS(AdRiverCounterJS)
- Нажать кнопку «Получить код»
- В появившемся окне с кодом проверить себя — что сайтзон (SZ) нет в коде
Пример кода
<!-- AdRiver code START. Type:JS-counter Site: test-adri -->
<!--
Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"/>
-->
<script type="text/javascript">
window.adrCounterStorage = window.adrCounterStorage || []; window.adrCounterStorage.push(() => {
new AdriverCounterJS({ sid: 55916, bt: 62 }, { id: "", gid1: "", yid1: "" })
});
</script>
<!-- AdRiver code END -->
2.1.2. Вариант 1 код JS (AdRiverCounterJS) — код на цель (на сайтзону)
Как разделить сайт на сайтзоны инструкция здесь.
Код можно получить в интерфейсе AdRiver (аналогично сквозному коду), только выбрав сайтзону, для которой он нужен.
Шаги:- Тематическая зона — выбрать конкретную сайтзону
- Тип баннера — выбрать JS-counter. При его выборе появятся доп. настройки выбора подтипа: JS(AdRiverCounterJS)/IMG(AdRiverCounterImage)
- Тип JSCounter — выбрать JS(AdRiverCounterJS)
- Нажать кнопку «Получить код»
- В появившемся окне с кодом проверить что SZ имеется и нужная (в примере это SZ: price)
Пример кода
<!-- AdRiver code START. Type:JS-counter Site: test-adri SZ: price -->
<!--
Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"/>
-->
<script type="text/javascript">
window.adrCounterStorage = window.adrCounterStorage || []; window.adrCounterStorage.push(() => {
new AdriverCounterJS({ sid: 55916, bt: 62, sz: 'price' }, { id: "", gid1: "", yid1: "" })
});
</script>
<!-- AdRiver code END -->
2.1.3. Вариант 1 код JS (AdRiverCounterJS) – однострочный код на кнопку на действие
Это код на сайтзону на действие — для учета отдельных событий: нажатий на кнопки, нажатий на отдельные
элементы.
Важное отличие кода на кнопки от кода просмотрового или кода на цель в том, что однострочный код на кнопку выполняется
не в случае загрузки страницы (просмотра), а только по совершению пользователем действия на странице — нажатия на
кнопку
и функция учета этого действия программируется на совершение действия. Это единственный случай, когда на одной
странице
трекерного сайта может быть установлено два кода AdRiver – один просмотровый, второй – код на совершение действия
(нажатие на кнопку).
Подробнее описание кода в статье.
- Тематическая зона — выбрать конкретную сайтзону
- Тип баннера — выбрать JS-counter. При его выборе появятся доп. настройки выбора подтипа: JS(AdRiverCounterJS)/IMG(AdRiverCounterImage)
- Тип JSCounter — выбрать JS(AdRiverCounterJS)
- Поставить галку «Однострочный код на действие»
- Нажать кнопку «Получить код»
- В появившемся окне с кодом проверить что SZ имеется и нужная
Пример кода
<!-- AdRiver code START. Type:JS-counter Однострочный код на действие Site: test-adri SZ: price_knopka -->
<!--
Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"/>
-->
<script type="text/javascript">
new AdriverCounterJS({ sid: 55916, bt: 62, sz: 'price_knopka' }, { id: "", gid1: "", yid1: "" })
</script>
<!-- AdRiver code END -->
2.2. Вариант 2 код IMG (AdRiverCounterImage)
2.2.1 Вариант 2 код IMG (AdRiverCounterImage) — сквозной просмотровый на все страницы сайта
Шаги:- Тематическая зона — выбрать «Без сайтзон»
- Тип баннера — выбрать JS-counter. При его выборе появятся доп. настройки выбора подтипа: JS(AdRiverCounterJS)/ IMG(AdRiverCounterImage)
- Тип JSCounter — выбрать IMG(AdRiverCounterImage)
- Нажать кнопку «Получить код»
- В появившемся окне с кодом проверить себя — что сайтзон (SZ) нет в коде
Пример кода
<!-- AdRiver code START. Type:JS-counter Вызов картинки. Site: test-adri -->
<!--
Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"/>
-->
<script type="text/javascript">
window.adrCounterStorage = window.adrCounterStorage || []; window.adrCounterStorage.push(() => {
new AdriverCounterImage({ sid: 55916, bt: 62 }, { id: "", gid1: "", yid1: "" })
});
</script>
<!-- AdRiver code END -->
2.2.2 Вариант 2 код IMG (AdRiverCounterImage) — код на цель (на сайтзону)
Шаги:- Тематическая зона — выбрать конкретную сайтзону
- Тип баннера — выбрать JS-counter. При его выборе появятся доп. настройки выбора подтипа: JS(AdRiverCounterJS)/IMG(AdRiverCounterImage)
- Тип JSCounter — выбрать IMG(AdRiverCounterImage
- Нажать кнопку «Получить код»
- В появившемся окне с кодом проверить что SZ имеется и нужная
Пример кода
<!-- AdRiver code START. Type:JS-counter Вызов картинки. Site: test-adri SZ: price -->
<!--
Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"/>
-->
<script type="text/javascript">
window.adrCounterStorage = window.adrCounterStorage || []; window.adrCounterStorage.push(() => {
new AdriverCounterImage({ sid: 55916, bt: 62, sz: 'price' }, { id: "", gid1: "", yid1: "" })
});
</script>
<!-- AdRiver code END -->
2.2.3 Вариант 2 код IMG (AdRiverCounterImage) – однострочный код на кнопку на действие
Это код на сайтзону на действие — для учета отдельных событий: нажатий на кнопки, нажатий на отдельные элементы.
Важное отличие кода на кнопки от кода просмотрового или кода на цель в том, что однострочный код на кнопку выполняется
не в случае загрузки страницы (просмотра), а только по совершению пользователем действия на странице — нажатия на
кнопку и функция учета этого действия программируется на совершение действия. Это единственный случай – когда на одной
странице трекерного сайта может быть установлено два кода AdRiver – один просмотровый, второй – код на совершение
действия (нажатие на кнопку).
Подробнее описание кода в статье.
- Тематическая зона — выбрать конкретную сайтзону
- Тип баннера — выбрать JS-counter. При его выборе появятся доп. настройки выбора подтипа: JS(AdRiverCounterJS)/IMG(AdRiverCounterImage)
- Тип JSCounter — выбрать IMG(AdRiverCounterImage
- Поставить галку «Однострочный код на действие»
- Нажать кнопку «Получить код»
- В появившемся окне с кодом проверить что SZ имеется и нужная
Пример кода
<!-- AdRiver code START. Type:JS-counter Вызов картинки. Однострочный код на действие Site: test-adri SZ: price_knopka -->
<!--
Использование этого кода требует установки в <head> страницы загрузки библиотеки
<script src="https://content.adriver.ru/AdRiverFPS.js"/>
-->
<script type="text/javascript">
new AdriverCounterImage({ sid: 55916, bt: 62, sz: 'price_knopka' }, { id: "", gid1: "", yid1: "" })
</script>
<!-- AdRiver code END -->
2.3. Вариант 3 код для финансовых сервисов
2.3.1. Вариант 3 код для финансовых сервисов — сквозной просмотровый на все страницы сайта
Код для финансовых сервисов является подвидом варианта IMG(AdRiverCounterImage) с тем отличием, что сама рабочая часть кода выдается для расположения на сайте рекламодателя, что часто бывает востребовано службой безопасности рекламодателя.
Шаги:- Тематическая зона — НЕ выбирать никакую сайтзону – оставить «без сайтзоны»
- Тип баннера — выбрать JS-counter. При его выборе появятся доп. настройки выбора подтипа: JS(AdRiverCounterJS)/IMG(AdRiverCounterImage)
- Тип JSCounter — выбрать IMG(AdRiverCounterImage)
- Однострочный код на действие – НЕ выбирать галку
- Под окном с кодом нажать на кнопку «Сгенерировать код JS-counter: финансовые сервисы»
Вот так выглядит полученный код в интерфейсе – он объемный и без сайтзон:
Пример кода
<!-- AdRiver code START. Type:JS-counter: финансовые сервисы Site: test-adri -->
<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: 55916, bt: 62 }, { id: "", gid1: "", yid1: "" });
</script>
<!-- AdRiver code END -->
2.3.2. Вариант 3 код для финансовых сервисов – на цель (сайтзону)
Шаги:- Тематическая зона — выбрать конкретную сайтзону
- Тип баннера — выбрать JS-counter. При его выборе появятся доп. настройки выбора подтипа: JS(AdRiverCounterJS)/IMG(AdRiverCounterImage)
- Тип JSCounter — выбрать IMG(AdRiverCounterImage)
- Нажать кнопку «Получить код»
- Под окном с кодом нажать на кнопку «Сгенерировать код JS-counter: финансовые сервисы»
- В появившемся окне с кодом проверить что SZ имеется и нужная
Вот так выглядит полученный код в интерфейсе – он объемный и сайтзона указана:
Пример кода
<!-- AdRiver code START. Type:JS-counter: финансовые сервисы Site: test-adri SZ: price -->
<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: 55916, bt: 62, sz: 'price' }, { id: "", gid1: "", yid1: "" });
</script>
<!-- AdRiver code END -->
2.3.3 Вариант 3 код для финансовых сервисов – однострочный код на кнопку на действие
Этот тип кода совпадает с кодом из пункта 2.2.3. Вариант 2 код IMG (AdRiverCounterImage) – однострочный код на кнопку на действие
Дополнительные возможности кодов
2.4. Код на сайтзону просмотровый для закрытых областей сайта (фреймов)
Данный тип кода применяется для страниц, где есть фреймы, в которые нельзя ставить JS-код, но при этом необходимо
посчитать определенные действия для них (например, отправку сообщений).
Этот код умеет отправлять js-counter двумя видами — js запросом или img запросом.
Устанавливать этот код нужно вместе со всеми остальными кодами.
Вызывать postMessage нужно в момент, когда в этом фрейме произошло событие, которое требуется посчитать через систему
AdRiver.
Пример отправки сообщения из фрейма, где нельзя ставить js
let message = {
"adriver":"IMGCounter",
"parameters": {sid:12345, bt:62, ad:12345, pid:12345, bid:12345, bn:12345, "custom":{"1":123,"55":"hello"}},
"cookies": {id:"",gid1:"",yid1:""}
};
window.parent.postMessage(JSON.stringify(message), '*');
Параметры
- adriver — «IMGCounter» / «JSCounter» — вид каунтера, который нужно вызвать
- parameters — набор стандартных параметров, скопированных из интерфейса при получении кода вызова
- cookies — набор параметров для кук (не обязательно)
2.5 Код сквозной просмотровый для e-commerce параметров
Код можно получить в интерфейсе DSP Soloway.
Пример кода и описание см. в статье.
2.6 Код для учета количества отправленных форм
Пример кода и описание см. в статье.
2.7 Архив: ранняя версия этой статьи от марта 2023г.
В статье была другая логика:
- 2.1 Код для установки на все страницы сайта рекламодателя (сквозной)
- 2.2 Код для тематических зон сайта (сайтзон)
- 2.3. Код для учета отдельных событий — нажатий на кнопки, нажатий на отдельные элементы
А внутри каждого пункта расписаны три варианта:
- код JS (AdRiverCounterJS)
- код IMG (AdRiverCounterImage)
- код Финансовые сервисы
В данной обновленной статье первичны три варианта
- код JS (AdRiverCounterJS)
- код IMG (AdRiverCounterImage)
- код Финансовые сервисы
А внутри каждого варианта расписаны подвиды
- код сквозной просмотровый
- код на цель (на сайтзону)
- однострочный код на кнопку на действие
3. Апп-трекеры
Если реклама ведет по клику не на web-сайт, а на приложения, то настроить цели и учитывать конверсии в AdRiver тоже можно.
AdRiver интегрирован с популярными app-трекерами. Чтобы получать постбэки в статистике необходимо провести предварительные настройки в вашем app-трекере.