Adexium Documentation

Appearance

Трекинг конверсий через пиксель Adexium (pixel.js) ​

Пиксель Adexium — самый простой способ передавать конверсии с вашего лендинга: интеграция с бэкендом не требуется. Достаточно одного тега <script> — пиксель сам подхватит идентификатор клика из URL, отправит конверсии и соберёт сигналы качества трафика, которые помогают нам присылать вам более качественный трафик.

Если вам удобнее серверный трекинг (постбеки с вашего бэкенда) — см. Трекинг конверсий.

Быстрый старт ​

1. Настройте ссылку в кампании ​

В настройках кампании добавьте параметр click_id к ссылке на ваш лендинг:

http
https://yourwebsite.com/landing?click_id=[CLICK_ID]

Макрос [CLICK_ID] подставляется автоматически на стороне Adexium. Пиксель также распознаёт имена параметров tg_click_id и cl.

2. Добавьте пиксель на лендинг ​

Разместите тег перед закрывающим </body> (или в <head>):

html
<script src="https://cdn.techtg.space/assets/js/pixel.js"></script>

Готово — пиксель инициализируется сам и создаёт глобальный объект TGAdsTracker.

3. Отправьте конверсию ​

В момент целевого действия (регистрация, покупка, отправка формы) вызовите:

html
<script>
  TGAdsTracker.trackConversion();
</script>

Пиксель отправит конверсию вместе с сохранённым идентификатором клика в Adexium. Если страница открыта без идентификатора клика (например, прямой заход), вызов просто игнорируется — ошибок не будет.

Без кода: трекинг клика по кнопке ​

Если ваша конверсия — «пользователь нажал на CTA-кнопку», JavaScript писать не нужно. Укажите пикселю кнопку через CSS-селектор:

html
<script src="https://cdn.techtg.space/assets/js/pixel.js"
        data-cta="a.cta-button"
        data-event="level1"></script>

Каждый клик по элементу, подходящему под селектор a.cta-button, автоматически отправит конверсию level1.

Уровни конверсий (события воронки) ​

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

СобытиеЗначениеКак отправляется
level0Просмотр лендинга (сигнал качества трафика)Автоматически, через ~2,5 с после загрузки, один раз на клик
level1Основная конверсия (регистрация, лид, клик по CTA)trackConversion() — значение по умолчанию
level2Более глубокое действие (квалифицированный лид, депозит, покупка)trackConversion('level2')
level3Самое ценное действие (повторная покупка, апсейл)trackConversion('level3')
javascript
// Основная конверсия
TGAdsTracker.trackConversion();

// Более глубокие события воронки
TGAdsTracker.trackConversion('level2');
TGAdsTracker.trackConversion('level3');

Передача level2/level3 необязательна, но настоятельно рекомендуется: кампании с данными по воронке получают лучшую оптимизацию качества трафика и доступ к Auto CPA биддингу.

JavaScript API ​

trackConversion(eventType?, extra?) ​

Отправляет событие конверсии. Возвращает true, если событие отправлено, и false, если нет идентификатора клика или событие уже было отправлено (дедупликация).

javascript
TGAdsTracker.trackConversion();                    // level1
TGAdsTracker.trackConversion('level2');            // level2

bindCTA(selector, eventType?) ​

Привязывает отправку конверсии к кликам по элементам, подходящим под CSS-селектор:

javascript
TGAdsTracker.bindCTA('#signup-button', 'level1');

trackEmail(email, eventType?) ​

Отправляет конверсию, связанную с подпиской по email (по умолчанию level3). Сам email-адрес никогда не передаётся — только короткий префикс SHA-256-хеша, домен и флаг валидности, чтобы мы могли оценивать качество регистраций, не получая персональных данных:

javascript
TGAdsTracker.trackEmail('[email protected]', 'level2');

getParam(name) ​

Хелпер для чтения параметра из query-строки текущего URL:

javascript
var subId = TGAdsTracker.getParam('sub_id');

Параметры тега script ​

Все опции задаются через data-*-атрибуты на теге script:

АтрибутПо умолчаниюНазначение
data-cta—CSS-селектор CTA-элементов; клики по ним автоматически отправляют конверсию
data-eventlevel1Уровень события для кликов из data-cta
data-dedupe1Установите 0, чтобы разрешить повторную отправку одного уровня события в рамках одного клика
data-level01Установите 0, чтобы отключить автоматический сигнал просмотра лендинга

Пример:

html
<script src="https://cdn.techtg.space/assets/js/pixel.js"
        data-cta="a.buy-now"
        data-event="level1"
        data-dedupe="1"></script>

Как это работает (детали) ​

  • Захват идентификатора клика. При загрузке пиксель читает click_id (или tg_click_id / cl) из URL лендинга и сохраняет его на 30 дней (localStorage с фолбэком на cookie). Все конверсии атрибуцируются этому клику — включая конверсии на последующих страницах воронки, где в URL параметра клика уже нет. Свежий клик всегда перезаписывает сохранённый.
  • Дедупликация. Каждый уровень события отправляется не более одного раза на идентификатор клика. Пиксель запоминает отправленные события в localStorage, поэтому обновление страницы не создаёт дублей конверсий. Отключается через data-dedupe="0", если кампания учитывает повторные конверсии.
  • Доставка. События отправляются через navigator.sendBeacon с фолбэками на image-пиксель и fetch, поэтому конверсии доходят надёжно, даже если пользователь сразу закрывает страницу.
  • Телеметрия качества трафика. Вместе с каждым событием пиксель отправляет анонимные поведенческие и девайс-сигналы (количество взаимодействий, видимость страницы, размер экрана, часовой пояс). Эти сигналы позволяют Adexium отсеивать ботный трафик до того, как он потратит ваш бюджет — лендинги с установленным пикселем получают заметно более чистый трафик. Персональные данные (имена, email-адреса, cookie, идентификаторы) не собираются.

Подключение через Google Tag Manager ​

Если на сайте уже стоит GTM, пиксель можно установить, не трогая код сайта — два тега Custom HTML:

Тег 1 — загрузка пикселя. Триггер: All Pages.

html
<!-- Adexium — загрузка пикселя -->
<script src="https://cdn.techtg.space/assets/js/pixel.js"></script>

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

Тег 2 — отправка конверсии. Триггер: ваше событие конверсии (отправка формы, клик по кнопке, просмотр thank-you-страницы). Замените level1 на level2 / level3 под нужную цель.

html
<!-- Adexium — отправка на вашем триггере конверсии -->
<script>
  (function () {
    var t = window.TGAdsTracker;
    if (t && t.clickId) {
      t.trackConversion('level1');
      return;
    }
    // фолбэк, если пиксель не успел загрузиться на этой странице
    var id = ('; ' + document.cookie).split('; adx_click_id=').pop().split(';')[0];
    if (id) {
      new Image().src = 'https://go.atechspace.live/conversion?click_id='
        + encodeURIComponent(id) + '&event_type=level1';
    }
  })();
</script>

После добавления обоих тегов опубликуйте контейнер GTM. Путь через API пикселя предпочтителен: он дедуплицирует повторные срабатывания и передаёт телеметрию качества трафика, описанную выше.

Проверка интеграции ​

  1. Откройте лендинг с тестовым идентификатором клика: https://yourwebsite.com/landing?click_id=test-123
  2. Откройте DevTools браузера → вкладка Network, фильтр по conversion.
  3. Выполните целевое действие — вы должны увидеть запрос к go.atechspace.live/conversion с click_id=test-123 и вашим event_type.
  4. Конверсии появятся в статистике личного кабинета Adexium в течение нескольких минут.

TIP

Дедупликация сохраняется в localStorage. При повторном тестировании с тем же идентификатором клика используйте новое значение click_id или очистите данные сайта в DevTools.

Поддержка ​

Вопросы по интеграции? Напишите нам: @AdexiumSupportBot.