Сторонние трекеры

  1. Справка
  2. Руководство
  3. Отслеживание
  4. Сторонние трекеры
На этой странице

Если вы ведёте трафик через трекер, ему нужно знать, что стало с каждым лидом. Связка строится так: трекер передаёт в сеть идентификатор своего клика, а сеть возвращает его постбеком, когда лид меняет фазу.

На этой странице сторона сети описана точно: какие поля потока заполнить, какой сайт скачать, каким должен быть постбек. Сторона трекера дана кратко. Меню и названия настроек в трекерах меняются, поэтому актуальные названия смотрите в документации самого трекера. Готовые варианты есть для AlterCPA Lite / One / Red, Keitaro и Binom. Любой другой трекер подключается по той же схеме, см. Другой трекер.

Как устроена связка#

  1. Трекер ведёт посетителя на ссылку вашего потока и подставляет в неё свой макрос, то есть идентификатор клика. Если сайт лежит в самом трекере, макрос стоит в скрытом поле формы.
  2. Сеть сохраняет значение в метке клика и хранит его вместе с лидом.
  3. Когда лид меняет фазу, сеть вызывает ваш постбек и подставляет сохранённое значение макросом метки, например {subid}. По этому значению трекер находит свой клик и записывает конверсию.

Идентификатор клика кладите в одну метку и в постбеке возвращайте её же макросом. Какая метка у какого трекера, показывает таблица.

Трекер Метка Что вписать в поле потока Скрытое поле в форме сайта Макрос в постбеке
AlterCPA Lite / Red / One SubID 1 (sub1) {click} sub1 = {click} {sub1}
Keitaro SubID (subid) {subid} subid = {subid} {subid}
Binom SubID (subid) {clickid} subid = {clickid} {subid}

Куда каждый трекер кладёт идентификатор своего клика. Макросы в фигурных скобках в полях и скрытых полях заменяет трекер, а в постбеке — сеть.

SubID — основная метка: по ней в кабинете можно искать лиды и клики (Лиды и клики) и считать статистику (Сводная статистика). Для SubID 1 — SubID 5 фильтров и отчётов нет, они нужны только для обмена с трекером.

Остальные данные трекера (кампанию, источник, креатив) можно положить в свободные поля SubID 1 — SubID 5: сеть сохранит их и вернёт макросами {sub1} — {sub5}. Что такое метки и как их передавать, написано на странице Метки и пиксели.

Этот способ подходит, когда лендинг лежит в сети, а трекер только ведёт на него трафик. В трекере вы указываете ссылку потока как адрес оффера. Агентство собирает ссылку не в потоке, а в генераторе: Агентствам.

  1. Откройте поток. В меню Потоки выберите Потоки по офферам и нажмите на название потока.

  2. Впишите макрос трекера. В разделе Постбек и трекинг впишите макрос в поле метки из таблицы выше: например, {clickid} в поле SubID для Binom или {click} в поле SubID 1 для AlterCPA Lite / One / Red. Значение сохраняется само, а ссылка потока вверху страницы обновляется.

  3. Скопируйте ссылку потока. В ней уже стоит параметр с вашим макросом, например sub1={click}. Ссылка меняется при правке настроек, поэтому копируйте её после последнего изменения (Ссылка и название).

  4. Вставьте ссылку в трекер. Укажите её как адрес оффера. Где это сделать, написано в документации трекера.

Блок «Постбек и трекинг» потока с макросами Binom123
Рис. 1. Блок «Постбек и трекинг»: 1 — постбек трекера, 2 — SubID с макросом идентификатора клика, 3 — SubID 1 и SubID 2 с другими макросами трекера.
Нет нужного поля

Поле SubID обычно есть, а SubID 1 — SubID 5 показываются, только если их разрешает оффер или сеть. Если нужного поля нет (например, SubID 1 для AlterCPA Red), допишите параметр к ссылке в трекере вручную: &sub1={click}, а если в ссылке ещё нет знака ?, то ?sub1={click}. Сеть читает метки из адреса независимо от полей потока.

Готовый сайт в трекере#

Если лендинг или прелендинг лежит в самом трекере, скачайте сайт, подготовленный под него: в формы такого сайта добавится скрытое поле с макросом трекера. Само скачивание описано в разделе Скачивание готовых сайтов. Агентство скачивает сайт на странице оффера: Агентствам.

  1. Нажмите значок скачивания. В настройках потока он стоит у каждого сайта, для которого сеть подготовила архив.

  2. Выберите трекер. В окне Скачать укажите в списке Трекер свой трекер и в списке Страна страну для цен. Пока выбран трекер, галочка Встроить трекер и клоаку недоступна. Она включает встроенную проверку посетителя сети, и к сторонним трекерам не относится.

  3. Нажмите Скачать. Браузер сохранит архив site-<ID сайта>.zip.

  4. Загрузите архив в трекер. Как добавить в трекер сайт, написано в документации трекера. Макрос в странице заменяет трекер в момент показа. Если положить архив на обычный хостинг, макросы останутся в страницах как есть, и в сеть уйдёт сама запись макроса вместо идентификатора клика.

Названия вариантов списка Трекер:

Трекер Вариант в списке Что добавляется в формы
AlterCPA Lite / Red / One AlterCPA Red sub1 = {click}
Keitaro Keitaro (subid) subid = {subid}
Keitaro Keitaro (utm_term) utm_term = {subid}
Keitaro Keitaro (utm_medium) utm_medium = {subid}
Binom Binom (clickid) subid = {clickid}
Binom Binom (clickid+campaign) subid = {clickid}, utm_campaign = {campaign}

Варианты списка «Трекер» окна «Скачать». Вариант — любой — ничего не добавляет, кроме случая из раздела Другой трекер.

У прелендинга под Keitaro и Binom ссылки на следующую страницу тоже ведут на макрос трекера. Полная таблица вариантов с этими ссылками есть в описании функции offer/download.

Ключ API лежит в архиве

В лендинге из архива есть файл api.php, а в нём ваш ключ API открытым текстом. Загружая архив в трекер, вы кладёте ключ на его сервер. Не загружайте архив в трекер, которому не доверяете. Если архив мог попасть в чужие руки, сбросьте ключ API.

Лендинг из архива отправляет заказы через API, поэтому вам должно быть доступно право Может добавлять заказы по API (подробнее в разделе Скачивание готовых сайтов). После смены настроек потока скачайте сайт заново и обновите его в трекере.

Свой сайт#

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

HTML
<input type="hidden" name="subid" value="{subid}" />

Форма должна уходить в сеть вместе с этим полем. Файл api.php из архива передаёт сети все поля формы. Если вы отправляете лиды сами, передавайте метку параметром subid (для AlterCPA Red — sub1) в функции leads/add.

Постбек#

Постбек возвращает трекеру фазы лидов. Адрес вписывается в поле Постбек раздела Постбек и трекинг потока или в глобальный постбек: пункт Постбек меню Потоки (у агентства он в меню Трафик), если сеть его показывает. Адрес потока заменяет глобальный на отмеченных в потоке фазах, подробнее в разделе Основной постбек. Флажки Ожидает, Холд, Принят, Отмена и Треш выбирают фазы лида, при которых сеть вызывает адрес. По умолчанию отмечены все пять, трекерам обычно нужны все. У агентства флажков нет: на его странице Постбек свой адрес для каждой фазы и общий адрес Глобальный, см. Агентствам. Порядок работы постбеков описан на странице Постбеки.

В примерах ниже используются эти макросы:

Макрос Что подставляет сеть
{subid}, {sub1} Значение метки SubID или SubID 1 лида: идентификатор клика, который передал трекер
{utm_term}, {utm_medium} Значения одноимённых UTM-меток лида
{stage} Фаза лида словом: wait, hold, approve, cancel или trash
{id} Номер лида в сети
{cash} Вознаграждение за лид в любой фазе
{paid} Вознаграждение только у принятого лида (approve), у остальных 0
{currency} Код валюты вознаграждения
{goal} Символьный код цели. Пусто, если у лида её нет

Макросы, которые используют примеры постбеков. Полный список — в разделе Макросы.

Адрес должен меняться вместе с фазой

Основной постбек не отправляется повторно, если после подстановки макросов адрес остался тем же (Защита от повторов). Поэтому в адресе должен стоять {stage}: без него трекер получит только первое событие лида.

Если у лида нет метки, например лид пришёл не через трекер, макрос подставится пустым, и трекер ничего с таким постбеком не сделает.

AlterCPA Red / One / Lite#

В трекере AlterCPA Red / One / Lite есть готовый шаблон интеграции с AlterCPA Pro / Cloud, вы можете использовать его.

Идентификатор клика Red, макрос {click}, кладётся в SubID 1. Для готового сайта выберите в списке Трекер вариант AlterCPA Red.

Пример постбека:

https://track.meow.pro/postbacks/meow1234?click={sub1}&status={stage}&uid={id}&price={cash}&currency={currency}&goal={goal}

Вместо track.meow.pro укажите адрес вашего трекера, вместо meow1234 — ваш ключ из настроек трекера. Параметры адреса принимает трекер. Сеть подставляет в них свои значения: идентификатор клика (click), фазу лида (status), номер лида в сети (uid), вознаграждение (price), его валюту (currency) и код цели (goal).

Keitaro#

В Keitaro есть готовый шаблон партнёрской сети AlterCPA со всеми настройками, вы можете использовать его.

Идентификатор клика Keitaro, макрос {subid}, кладётся в SubID. Для готового сайта выберите в списке Трекер вариант Keitaro (subid). Варианты Keitaro (utm_term) и Keitaro (utm_medium) кладут идентификатор в UTM-метку. Выбирайте их, если хотите вернуть идентификатор в постбеке этой меткой: тогда вместо {subid} пишите {utm_term} или {utm_medium}. Эти метки нужны и для статистики, поэтому по умолчанию берите SubID.

Пример постбека:

https://track.meow.pro/meow1234/postback?subid={subid}&tid={id}&payout={cash}&status={stage}&sale_status=approve&reject_status=cancel,trash&lead_status=wait,hold

Вместо track.meow.pro укажите адрес вашего трекера, вместо meow1234 — ключ постбека из настроек трекера. Параметры sale_status, reject_status и lead_status относятся к Keitaro: они сообщают ему, какие значения {stage} считать продажей, отказом и заявкой.

Binom#

Идентификатор клика Binom, макрос {clickid}, кладётся в SubID. Для готового сайта выберите в списке Трекер вариант Binom (clickid). Вариант Binom (clickid+campaign) дополнительно кладёт в метку utm_campaign значение макроса {campaign}.

Пример постбека:

https://track.meow.pro/click.php?cnv_id={subid}&payout={paid}&cnv_status={stage}&cnv_currency={currency}

Вместо track.meow.pro укажите адрес вашего трекера.

Binom нужно сообщить, какая выплата соответствует каждой фазе лида. Для этого в дополнительных настройках постбека («Advanced Settings») в блоке «Status payout relation» оставьте выплату только у принятого лида:

Фаза Выплата
wait 0
hold 0
approve {payout}
cancel 0
trash 0

Соотношение фаз лида и выплаты в Binom. {payout} в этой таблице записывается для Binom, сеть его здесь не подставляет.

Если вы заводите в Binom шаблон партнёрской сети, укажите в нём:

  • Name: AlterCPA
  • Offer URL template: {offer_url}&subid={clickid}
  • Postback URL: cnv_id={subid}&payout={paid}&cnv_status={stage}&cnv_currency={currency}.

Шаблон сам добавляет &subid={clickid} к адресу оффера, поэтому поле SubID в потоке при нём можно не заполнять.

Проверка связки#

  1. Сделайте клик через трекер. Пройдите по ссылке трекера, которую вы настроили, или откройте тестовый клик в самом трекере.

  2. Найдите клик в сети. Откройте Обзор кликов и найдите свежий клик вашего потока. В колонке UTM метка SI — это SubID. Дополнительные SubID 1 — SubID 5 в списке не показаны, они есть в окне подробностей клика: его открывает кнопка в первой колонке строки. Нужная метка должна быть равна идентификатору клика в трекере.

  3. Создайте лид. Оформите заказ на сайте или отправьте тестовый лид по API с тем же значением subid (Тестовый лид). Форма ручной отправки лида в кабинете SubID не спрашивает, для проверки связки она не подходит.

  4. Откройте журнал постбеков. В нём должна появиться строка с адресом, где вместо макросов подставлены значения, и с ответом трекера (Журнал постбеков).

Если конверсия в трекере не появилась, проверьте по порядку:

  • В клике SubID выглядит как макрос (например, {click}): трафик пришёл не через трекер, либо трекер не заменил макрос. Сеть записывает то, что пришло в ссылке.
  • В клике SubID пуст: в ссылке потока нет параметра с макросом. Впишите макрос в поле потока и скопируйте ссылку заново.
  • В журнале нет строки: в потоке и в глобальном постбеке не задан адрес, либо не отмечен флажок нужной фазы.
  • В адресе из журнала пустой subid= или click=: у лида нет метки. Для сайта в трекере проверьте, что скрытое поле попало в форму и форма отправляется вместе с ним.
  • Трекер получил запрос, но не засчитал его: сверьте имена параметров и соответствие фаз лида статусам трекера.
  • Приходит только первая фаза: в адресе нет {stage}.

Агентствам#

У агентства нет потоков, поэтому ссылку оно собирает в Генераторе ссылок, а не в настройках потока. Макрос идентификатора клика трекера вписывается в поле Макрос ID клика (метка extu), макрос источника или вебмастера в поле Макрос ID вебмастера (метка exts). Сеть возвращает их в постбеке макросами {extu} и {exts} (Метки для агентств). В примерах постбека ниже замените {subid} или {sub1} на {extu}. Сеть оставляет в значении только латинские буквы, цифры и знаки -, _ и ., остальное отбрасывает.

Можно взять и поле SubID, как вебмастер: оно есть в генераторе, поэтому варианты Keitaro и Binom из таблицы выше работают и для агентства, а в постбеке остаётся {subid}. Полей SubID 1 — SubID 5 в генераторе нет, поэтому для AlterCPA Red допишите к готовой ссылке &sub1={click}.

Постбек агентство задаёт в меню Трафик › Постбек: пять полей, по одному на каждую фазу, и общее поле Глобальный (Постбеки агентства). Готовый сайт агентство скачивает на странице оффера, без выбора потока (Скачивание готовых сайтов для агентства).

Другой трекер#

Трекер, которого нет на этой странице, подключается так же:

  1. Узнайте в документации трекера макрос идентификатора клика и адрес приёма конверсий.
  2. Впишите макрос в поле SubID потока.
  3. Задайте постбек: адрес приёма конверсий с макросом {subid} и {stage}.

Если трекер использует макрос {subid}, как Keitaro, скрытое поле для готового сайта добавится само: вариант — любой — кладёт в формы subid = {subid}, когда в поле SubID потока стоит именно {subid}. Для других макросов скрытое поле добавьте сами, как в разделе Свой сайт.