Метки и пиксели

На этой странице

Для учёта трафика и связи с рекламными сетями в AlterCPA есть три инструмента. Метки: параметры ссылки, которые сохраняются в каждом клике и лиде. По ним вы считаете статистику и связываете лиды с трекерами. Пиксели и счётчики: коды рекламных сетей и систем аналитики, которые система сама вставляет в сайты оффера. Собственный код: ваши вставки в заголовок и подвал сайтов. Всё это задаётся в настройках потока, в блоке Постбек и трекинг (Создание и настройки), или параметрами ссылки.

Метки в ссылке и API#

Метку вы дописываете к ссылке или передаёте в API при отправке лида (leads/add). Платформа записывает её в клик и в лид. Одни метки нужны для статистики и поиска, другие только для обмена данными с трекерами и рекламными сетями. Длина любой метки не больше 250 знаков.

Значения можно задать заранее в настройках потока: они сами попадут в ссылку потока, в том числе в короткую (Виды ссылки). Любую метку можно дописать и вручную, например макросом рекламной сети или трекера: сеть подставит значение при каждом переходе.

Поля меток в настройках потока123
Рис. 1. Поля меток в настройках потока: 1 — UTM-метки и «Покупатель», 2 — SubID, 3 — SubID 1–5 и ERID.

В ссылке работают только имена параметров из таблиц ниже. Сокращения вроде utms или us ссылка не распознаёт: их понимает только API лидов, где у каждой метки больше синонимов (см. таблицу параметров leads/add).

Основные метки

Основные метки видны в статистике. По ним вы ищете лиды и клики (Лиды и клики), группируете отчёты (Иерархические отчёты) и привязываете расходы, загруженные вручную (Расходы).

Метка Параметр в ссылке Что в неё записывать
UTM Source utm_source Название источника трафика.
UTM Campaign utm_campaign Название или идентификатор рекламной кампании.
UTM Content utm_content Название или идентификатор креатива.
UTM Term utm_term Ключевое слово, по которому показано объявление.
UTM Medium utm_medium Название или идентификатор группы объявлений.
Домен utm_domain Домен, на котором произошло событие. В ссылке указывать не нужно: платформа записывает домен, на который пришёл посетитель.
Покупатель customer, также utm_user Идентификатор заказчика рекламы.
SubID subid Произвольная метка, например идентификатор клика вашего трекера или номер заявки.

Основные метки.

Пример ссылки с метками:

https://lk.dalead.pro/catnip-cola-reader-story/?flow=84&l=415&utm_source=instagram&utm_campaign=cola_gb_story&utm_content=reel_b&subid=cat42

В настройках потока всегда есть пять UTM-меток и «Покупатель». SubID и метки для трекеров показываются, если сеть разрешила их для оффера. Метку «Домен» платформа записывает сама.

Агентство собирает ссылку в Генераторе ссылок, и там есть поля UTM-меток и SubID. Полей «Покупатель», SubID 1–5 и ERID в нём нет.

Метки для трекеров

Эти метки нужны для технической стороны интеграции со сторонними трекерами и рекламными сетями: их передают в API и возвращают в постбеках одноимёнными макросами в фигурных скобках, например {uuid} или {sub1}.

Метка Параметр в ссылке Заметки
UUID / ERID uuid, erid, x64 Одна метка под тремя именами. В настройках потока она называется ERID, в карточке лида и клика — UUID.
SubID 1–5 sub1…sub5, также subid1…subid5, sid1…sid5 и xm1…xm5 Пять дополнительных меток. В настройках потока они называются SubID 1…SubID 5.
ID клика рекламной сети clid, fbclid, gclid, gbraid, wbraid, adclid, adsclid, rb_clickid, ttclid, ttlid, msclkid, yclid, bbg, adid, unique_id, uid Любое из этих имён платформа записывает как ID рекламы. Если в ссылке их несколько, сохраняется одно. Если у посетителя есть cookie Facebook _fbc, ID берётся из неё.

Метки для трекеров.

В постбеке ID рекламы возвращается под любым из этих имён: макрос {fbclid} отдаст то же значение, что и {gclid}. Полный список макросов постбека — на странице Постбеки. Фильтр потока ID рекламы блокирует визиты без ID клика: Фильтры и трафикбек.

Ищите по основным меткам

Метки uuid, sub1…sub5 и ID рекламы записываются в клик и лид и видны в их карточках, но по ним нельзя искать лиды и клики, группировать статистику и привязывать расходы. Для статистики используйте основные метки: UTM, «Домен», «Покупатель» и SubID.

Метки для агентств

Если вы работаете как агентство, у вас есть две дополнительные метки для вашей нумерации лидов и источников трафика:

  • extu — идентификатор лида или клика на вашей стороне, например в вашей CRM или трекере. В кабинете это «ID заказа в агентстве», в отчётах — «Лид агентства».
  • exts — идентификатор вашего источника или вебмастера. В кабинете это «ID вебмастера в агентстве», в отчётах — «Веб агентства».

Задавать их не обязательно, но стоит: лид можно найти по вашему идентификатору в leads/list (фильтр uid для extu, фильтр src для exts), а в постбеке платформа возвращает их макросами {extu} и {exts} (Макросы для агентств).

Где их взять и где они видны:

  • В ссылке их ставит Генератор ссылок: значения для extu и exts вы пишете в полях Макрос ID клика и Макрос ID вебмастера. Сама ссылка ещё несёт exti — идентификатор вашего агентства в сети.
  • В API это параметры extu и exts функции leads/add. Значение auto или пустое для extu просит платформу выдать порядковый номер.
  • В списках лидов и кликов это поля фильтра (Лиды и клики), а в статистике — отчёт Внешние метки и срезы «Лид агентства» и «Веб агентства» (Статистика для агентств).

Рекламные сети и системы аналитики#

Пиксели и счётчики вставляются в сайты автоматически. На каждую страницу сайта попадает код посещения, а на страницу «Спасибо» — ещё и код конверсии. Если сайт отправил заказ с ошибкой, пиксели на «Спасибо» не загружаются.

Идентификатор пикселя можно записать в настройках потока, а можно передать в ссылке параметром (Счётчики в ссылке). Параметр в ссылке главнее поля потока: так удобно менять пиксель, не трогая поток. Платформа запоминает идентификатор в cookie посетителя на 30 дней, чтобы страница «Спасибо», на которую он попадает уже без параметров, отправила конверсию в тот же пиксель. Один идентификатор действует на всех страницах: на прелендинге, лендинге и «Спасибо».

Поля пикселей и счётчиков в настройках потока123
Рис. 2. Поля пикселей и счётчиков: 1 — Facebook и событие конверсии, 2 — Google, 3 — остальные счётчики.

Какие системы доступны, зависит от сети и оффера: в настройках потока есть только те поля, которые сеть разрешила для этого оффера. Нет поля — значит, сеть не разрешила эту систему для оффера.

Агентство

В кабинете агентства потоков нет, поэтому нет и полей пикселей и счётчиков. Идентификаторы пикселей агентство дописывает к ссылке из Генератора ссылок вручную, параметрами из раздела Счётчики в ссылке, например &fb=512907843120457. В окне скачивания готового сайта три галочки: Пиксели не нужны совсем, Пиксели без JavaScript и Пиксели только на "Спасибо" (Скачивание готовых сайтов для агентства). Идентификаторы пикселей такой сайт тоже берёт из параметров ссылки.

Где работают пиксели:

  • на сайтах оффера, которые сеть показывает со своих адресов: все системы из таблицы ниже.
  • на сайтах, скачанных из потока. Что добавляет и убирает окно скачивания, написано в разделе Скачивание готовых сайтов.
  • в офферах, которые подключают ваш код через iframe, пиксели загружаются в нём: Произвольный код в iframe.
Система Поле потока Параметр На страницах сайта На странице «Спасибо»
Facebook Facebook, Событие конверсии FB fb, fbe PageView, через 30 секунд на странице — ViewContent PageView и событие конверсии, по умолчанию Lead
Google Analytics / Tag Manager Google Analytics / Tag Manager, Конверсия Google Analytics ga, gad Подключение счётчика Подключение счётчика. Для Analytics с заданной конверсией ещё событие conversion
VK VK ретаргет vk Посещение страницы Посещение и событие lead
Яндекс.Метрика Яндекс.Метрика mtrk Счётчик Счётчик
Mail Target Mail Target mt pageView pageView и itemView с типом purchase
Tik-Tok Tik-Tok tt page page и SubmitForm
Likee Likee lki page_view page_view и form

События пикселей на сайтах оффера.

Если в таблице для системы на странице «Спасибо» нет события конверсии (Яндекс.Метрика, Tag Manager), настройте цель в самой системе, например по наличию слова success в адресе страницы. По умолчанию адрес страницы «Спасибо» его содержит.

Facebook

В поле Facebook впишите числовой идентификатор пикселя, например 512907843120457. Несколько пикселей укажите через запятую: каждый будет инициализирован на странице.

Список Событие конверсии FB задаёт событие для страницы «Спасибо», по умолчанию Lead. Это выбор из стандартных событий Facebook, а не поле ввода: AddPaymentInfo, AddToCart, AddToWishlist, CompleteRegistration, Contact, CustomizeProduct, Donate, FindLocation, InitiateCheckout, Lead, Purchase, Schedule, Search, StartTrial, SubmitApplication, Subscribe, ViewContent. Идентификатор пикселя сюда вписать нельзя. В ссылке событие передают параметром fbe. Если нужен Lead, параметр не добавляется.

Серверный пиксель Facebook Conversion API

Серверные события не зависят от браузера посетителя: платформа сама отправляет их в Facebook, когда лид поступает и когда его этап меняется. Блок Facebook Conversion API есть в настройках потока, если сеть разрешила его для оффера.

Блок «Facebook Conversion API» в настройках потока1234
Рис. 3. Блок «Facebook Conversion API»: 1 — ID пикселя, 2 — события по этапам, 3 — токен, 4 — режим работы и прокси.

Поля блока:

  • ID пикселя — числовой идентификатор. Можно указать только один пиксель.
  • Событие: новый, Событие: холд, Событие: аппрув — событие, которое уйдёт, когда лид получает этап «Ожидает», «Холд» или «Принят» (фазы лида). Вариант «не отправлять» отключает этап. На этапы «Отмена» и «Треш» события не уходят.
  • API токен пикселя — токен доступа к Conversion API. Без него и без ID пикселя ничего не отправляется.
  • Режим работы — сколько данных передавать:
    • «Только ID клика» — ID клика Facebook плюс технические данные: номер лида, IP-адрес, браузер и страна посетителя. Если у лида нет ID клика, событие не уходит.
    • «ID клика и данные лида» — дополнительно имя, фамилия, e-mail и телефон из лида, в виде хэшей SHA-256. Без ID клика событие тоже не уходит.
    • «Данные лида даже без ID клика» — то же, но событие отправляется и для лида без ID клика: идентификатор платформа создаёт сама.
  • Прокси для запроса — прокси, через который уходит запрос, в формате протокол://логин:пароль@хост:порт, например http://user:pass@1.2.3.4:56.

Для событий Purchase, StartTrial и Subscribe платформа добавляет сумму заказа и её валюту.

Чтобы получить токен, нужен доступ к вашему пикселю в Facebook. Обычный токен Facebook не подходит, нужен специальный токен Conversion API:

  1. Откройте Events Manager и нажмите «Подключить источник данных».

  2. Отметьте «Интернет» и нажмите «Подключить».

  3. Введите название нового источника данных.

  4. Добавьте адрес сайта или отметьте «У меня нет сайта».

  5. Выберите самостоятельную настройку и способ подключения «Пиксель Meta и Conversions API», нажмите «Далее».

  6. Выберите ручную настройку Conversions API и нажмите «Продолжить».

  7. Нажмите «Продолжить», проверьте настройки и нажмите «Подтвердить настройку».

  8. В пункте «Реализуйте API самостоятельно» откройте «Руководство по реализации».

  9. На открывшейся странице нажмите «Сгенерировать маркер доступа» и вставьте токен в поле API токен пикселя.

Каждая отправка записывается в журнал постбеков вместе с ответом Facebook. Если в ответе ошибка авторизации (OAuth), токен неверный или отозван: создайте новый по инструкции выше.

Google Analytics и Tag Manager

В поле Google Analytics / Tag Manager впишите идентификатор вида AW-123456789, GTM-ABC1234 или G-ABC1234567. Идентификаторы с началом GTM и G- подключаются как Tag Manager, остальные — как Analytics или Ads (gtag).

Поле Конверсия Google Analytics нужно только для Analytics. В настройках конверсии вы увидите код вида AW-123456789/AbC-dE12345: нужная часть стоит после косой черты, в примере это AbC-dE12345. Впишите её в поле, и на странице «Спасибо» уйдёт событие conversion. Для Tag Manager это поле не действует: конверсию настраивают в самом контейнере.

VK

Пиксель аудиторий VK ставится на все страницы. На странице «Спасибо» дополнительно срабатывает событие lead. В поле VK ретаргет впишите идентификатор пикселя, например VK-RTRG-12345-abcd.

Яндекс.Метрика

Счётчик подключается на все страницы с картой кликов, отслеживанием ссылок, точным показателем отказов и Вебвизором. Цели платформа не отправляет: настройте их в самой Метрике по адресу страницы, лучше всего по слову success. В поле Яндекс.Метрика впишите номер счётчика, например 12345678.

Mail Target

Счётчик отправляет pageView на всех страницах, а на «Спасибо» ещё и itemView с типом purchase. В поле Mail Target впишите номер счётчика.

Tik-Tok

Пиксель ставится на все страницы и отправляет page. На странице «Спасибо» на сайтах оффера добавляется событие SubmitForm. В поле Tik-Tok впишите идентификатор пикселя.

Likee

Пиксель отправляет page_view на всех страницах, а на «Спасибо» ещё и form. В поле Likee впишите идентификатор пикселя.

Счётчики в ссылке#

Идентификаторы можно передать параметрами ссылки. В обычной ссылке потока платформа сама добавляет все заполненные поля. В остальных видах ссылки пиксели не пишутся: платформа берёт их из потока при переходе.

Параметр Что передаёт
fb Идентификаторы пикселей Facebook, несколько через запятую.
fbe Событие конверсии Facebook, если нужно не Lead.
ga Идентификатор Google Analytics или Tag Manager.
gad Идентификатор события конверсии Google.
vk Идентификатор пикселя VK.
mtrk Номер счётчика Яндекс.Метрики.
mt Номер счётчика Mail Target.
tt Идентификатор пикселя Tik-Tok.
lki Идентификатор пикселя Likee.

Параметры ссылки для пикселей и счётчиков.

Произвольный код на сайтах#

Некоторые офферы разрешают вставлять в свои сайты собственный код для нестандартных систем отслеживания. Поля Произвольный HTML-код для заголовка сайтов и Произвольный HTML-код для подвала сайтов есть в настройках потока, если оффер это допускает. Код заголовка вставляется в конец тега head, код подвала — в конец body. Один и тот же код стоит на всех страницах сайта, включая «Спасибо». Вставки на PHP платформа при сохранении удаляет.

В коде можно использовать макросы, они заменяются значениями текущего посетителя: {utm_source}, {utm_campaign}, {utm_content}, {utm_term}, {utm_medium}, {customer}, {subid}, {uuid}, {erid}, {sub1}…{sub5}, {uid} (ID рекламы), {fb}, {fbe}, {ga}, {gad}, {vk}, {mtrk}, {mt}, {tt} и {lki}. Макросы работают на сайтах, которые сеть показывает со своих адресов. В скачанном из потока архиве код вставляется как есть, и макросы в нём не заменяются.

Чтобы код сработал только на странице «Спасибо», проверьте адрес страницы:

HTML
<script type="text/javascript">
  if (window.location.href.includes("success")) {
    // Ваш код конверсии
  }
</script>

Есть и другой способ: содержимое блока <!--site-->…<!--/site--> показывается только на основных страницах, а <!--thanks-->…<!--/thanks--> — только на «Спасибо». Например:

HTML
<!--site-->Это показываем только на сайте!<!--/site-->
<!--thanks-->Это показываем только на Спасибо!<!--/thanks-->
А это показываем на всех страницах.

Произвольный код в iframe#

Некоторые внешние офферы показывают на своих страницах iframe с вашим кодом. Какие поля вы видите в настройках потока, определяет оффер:

  • одно поле Трекинг-код для всех страниц сайта.
  • два поля, Трекинг-код для основных страниц и Трекинг-код для страницы Спасибо: разный код для сайта и для конверсии.
  • ни одного поля кода: оффер принимает только пиксели и счётчики потока, описанные выше.

Вставки на PHP платформа при сохранении удаляет. Если оффер поддерживает системные пиксели, то пиксели и счётчики из полей потока загружаются в этот же iframe, вместе с вашим кодом. Tik-Tok при этом отправляет только page, без события SubmitForm.

В коде можно использовать макросы: {utm_source}, {utm_campaign}, {utm_content}, {utm_term}, {utm_medium}, {subid}, {uuid}, {sub1}…{sub5}, {fb}, {ga}, {vk}, {mtrk}, {mt}, {tt} и {lki}, а на странице «Спасибо» ещё {fbe} и {gad}. Значения {uuid}, {sub1}…{sub5} и UTM-меток платформа берёт из параметров адреса iframe, который формирует оффер: если оффер их не передаёт, макрос пуст. Идентификаторы пикселей и {subid} берутся из настроек потока, пока адрес iframe не задаёт своих.