Поток атрибуции

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

• Этап 1: Отслеживание кликов
• Этап 2: Отслеживание лидов
• Этап 3: Отслеживание продаж

Этап 1: Отслеживание кликов

Когда посетитель переходит по реферальной ссылке партнёра, Revroute фиксирует клик на стороне сервера перед перенаправлением на ваш сайт. Это происходит автоматически и не может быть заблокировано блокировщиками рекламы.

Данные, фиксируемые при клике:

• Уникальный идентификатор клика
• Временная метка
• Географическое местоположение (страна, город, континент)
• Тип устройства (мобильное, десктоп, планшет)
• Браузер и операционная система
• URL реферера
• UTM-параметры
• Был ли клик по QR-коду или короткой ссылке

Клик добавляется к вашему целевому URL в виде query-параметра dub_id:

https://yoursite.com?dub_id=cm3w8x2...

Затем скрипт аналитики Revroute обнаруживает параметр dub_id и сохраняет его как first-party cookie.

// The SDK automatically handles this when installed
// Cookie: dub_id=xyz... (expires in 90 days by default)

Почему first-party cookies?

• Сохраняются при навигации между страницами и сессиями
• Не блокируются блокировщиками рекламы (в отличие от сторонних cookies)
• Соответствуют требованиям конфиденциальности
• Надёжно работают во всех браузерах

Стандартное время жизни cookie — 90 дней, что означает, что конверсии в этом окне атрибутируются к исходному клику. Вы можете настроить это с помощью параметра expiresInDays.

Этап 2: Отслеживание лидов

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

await dub.track.lead({
  clickId: cookies.get("dub_id"), // From the cookie
  eventName: "Sign Up",
  customerExternalId: user.id, // Your user ID
  customerEmail: user.email,
  customerName: user.name,
});

Событие лида автоматически дедуплицируется на основе комбинации customerExternalId + eventName. Записывается только первое событие для каждой комбинации, что предотвращает дублирование атрибуции.

Этап 3: Отслеживание продаж

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

await dub.track.sale({
  customerExternalId: user.id, // Same ID from lead event
  amount: 9900, // Amount in cents ($99.00)
  paymentProcessor: "stripe",
  invoiceId: "inv_123", // For idempotency
});

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

Модели атрибуции

Revroute поддерживает две модели атрибуции:

1. Атрибуция по последнему клику (по умолчанию)
2. Атрибуция по первому клику

Атрибуция по последнему клику (по умолчанию)

Вся заслуга присваивается последней партнёрской ссылке, по которой клиент кликнул перед конверсией.

// include this script tag in your HTML Head tag
<script
  src="https://www.dubcdn.com/analytics/script.js"
  data-attribution-model="last-click" // can be omitted since it's the default
  defer
></script>

Атрибуция по первому клику

Вся заслуга присваивается первому партнёру, который привлёк клиента, независимо от последующих кликов.

// include this script tag in your HTML Head tag
<script
  src="https://www.dubcdn.com/analytics/script.js"
  data-attribution-model="first-click"
  defer
></script>

Когда клиент кликает по нескольким партнёрским ссылкам:

Каждый клик по-прежнему записывается в аналитике, поэтому вы можете видеть полный путь клиента, даже если комиссию получает только один партнёр.

Окно атрибуции

Окно атрибуции — это временной интервал, в течение которого конверсия может быть засчитана клику. В Revroute оно контролируется временем жизни cookie:

// Set a 30-day attribution window
<script
  src="https://www.dubcdn.com/analytics/script.js"
  data-cookie-options='{"expiresInDays": 30}'
></script>

Если клиент конвертируется после истечения срока cookie, событие конверсии не будет атрибутировано к исходному клику.

Кросс-доменная атрибуция

Если путь клиента проходит через несколько доменов, Revroute поддерживает кросс-доменное отслеживание:

• yoursite.com → app.yoursite.com
• app.yoursite.com → checkout.yoursite.com
• yoursite.com → anothersite.com

Подробнее в руководстве по кросс-доменному отслеживанию.

Процесс начисления комиссии партнёру

Когда продажа атрибутирована, Revroute автоматически рассчитывает и записывает комиссию партнёра:

1. Получено событие продажи с customerExternalId
2. Поиск клиента находит связанного лида и исходный клик
3. Партнёр определён по реферальной ссылке клика
4. Комиссия рассчитана на основе правил вознаграждения для группы партнёра
5. Комиссия создана со статусом pending

Прямая атрибуция продаж

Для сценариев без этапа регистрации (например, разовые покупки) можно отслеживать продажи напрямую по идентификатору клика:

await dub.track.sale({
  clickId: cookies.get("dub_id"), // Directly from cookie
  customerExternalId: order.email,
  customerName: order.name,
  customerEmail: order.email,
  amount: 4900,
  invoiceId: order.id,
});

Подробнее о прямом отслеживании продаж.

Отложенное отслеживание лидов

Для продуктов с периодами квалификации (пробные периоды, одобрения) Revroute поддерживает отложенное отслеживание лидов:

// Track initial signup (deferred)
await dub.track.lead({
  clickId: cookies.get("dub_id"),
  eventName: "Sign Up",
  customerExternalId: user.id,
  mode: "deferred", // Creates customer link but defers reward
});
 
// Later, when qualified
await dub.track.lead({
  clickId: "", // Empty - uses existing customer record
  eventName: "Qualified Lead",
  customerExternalId: user.id, // Same customer ID
});

Это гарантирует, что партнёры вознаграждаются только когда клиенты достигают значимого этапа.

Подробнее об отложенном отслеживании лидов.

Устранение неполадок атрибуции

Распространённые проблемы

Проверка атрибуции

1. Проверьте cookie: Просмотрите cookies браузера на наличие dub_id
2. Протестируйте процесс: Перейдите по партнёрской ссылке, зарегистрируйтесь и убедитесь, что лид появился в панели управления
3. Просмотрите аналитику: Проверьте вкладку Events на предмет последовательности клик → лид → продажа