Skip to Content
Документация для разработчиковУстановка для вебСерверное отслеживание (рекомендуется)
💡

Эта функция доступна только на тарифных планах Business и выше .

Мощная платформа атрибуции Revroute позволяет понять, насколько эффективно ваши ссылки конвертируются в реальных пользователей и доход.

В этом руководстве мы узнаем, как отслеживать события конверсий с Revroute, используя серверное отслеживание.

📝

Рекомендуемый способ отслеживания конверсий в Revroute — серверное отслеживание, которое более надёжно, чем клиентское отслеживание.

Шаг 1: Включите отслеживание конверсий для ваших ссылок

Сначала включите отслеживание конверсий для ссылок: без него клик не связывается с последующими событиями лида и продажи.

💡

Для ссылок партнёрской программы шаг можно пропустить — RevRoute включает отслеживание конверсий у них автоматически.

Для всего воркспейса. Откройте Настройки → Аналитика и включите переключатель Отслеживание конверсий в шапке страницы — он управляет настройкой на уровне воркспейса. Отслеживание включится у всех ссылок, созданных после этого.

Для отдельной ссылки. Откройте конструктор ссылки и включите переключатель Отслеживание конверсий — внутри конструктора он же дёргается горячей клавишей C.

Через API. Передайте trackConversion: true при создании или обновлении ссылки (по умолчанию — false):

curl -X POST "https://api.revroute.ru/links" \
  -H "Authorization: Bearer dub_xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "trackConversion": true
  }'

Шаг 2: Установите скрипт Revroute Analytics

Далее необходимо установить скрипт Revroute Analytics.

Этот скрипт обнаруживает параметр запроса rr_id и сохраняет его как first-party cookie, который будет использоваться для атрибуции последующих событий конверсий исходной ссылке.

Клиентский скрипт RevRoute отдаётся с нашего домена — npm-пакеты ставить не нужно. Скрипт находит в URL параметр rr_id, сохраняет его в first-party cookie rr_id на вашем домене (90 дней) и по нему связывает будущие конверсии с исходной ссылкой.

Вставьте тег в секцию <head> каждой страницы сайта:

<script defer src="https://app.revroute.ru/analytics/script.js"></script>

В Next.js (App Router) — через next/script в корневом layout:

import Script from "next/script";
 
export default function RootLayout({ children }) {
  return (
    <html lang="ru">
      <body>{children}</body>
      <Script defer src="https://app.revroute.ru/analytics/script.js" />
    </html>
  );
}
💡

Варианты скрипта (site visit, outbound domains, клиентские конверсии) и все его атрибуты data-* описаны в разделе Варианты скрипта.

📝

Проверить установку можно двумя способами:

  1. Откройте консоль браузера и введите _revRouteAnalytics — если скрипт установлен, в консоли появится объект.
  2. Добавьте к адресу сайта параметр ?rr_id=test и убедитесь, что в браузере появился cookie rr_id.

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

  • тег скрипта стоит в секции <head> страницы;
  • кеш CDN сброшен, если сайт отдаётся через CDN.

Шаг 3: Подготовьте серверные вызовы

События конверсий отправляются с вашего бэкенда обычными HTTP-запросами к REST API RevRoute — отдельный SDK для этого не нужен, подойдёт любой HTTP-клиент вашего языка:

Запросы авторизуются секретным ключом (dub_*) в заголовке Authorization — как получить ключ и где его хранить, описано в разделе «API: аутентификация». Секретный ключ нельзя отдавать в браузер: для клиентских вызовов есть отдельный publishable key.

⚠️

Держите секретный ключ в переменных окружения или менеджере секретов. Утечка ключа даёт доступ ко всем ресурсам воркспейса.

Шаг 4: Отслеживайте события конверсий

Теперь самое интересное — отслеживание событий конверсий.

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

Первое событие, которое нужно отслеживать — это событие lead. Оно происходит, когда пользователь выполняет действие, указывающее на интерес к вашему продукту или услуге. Это может быть:

  • Регистрация аккаунта
  • Добавление товара в корзину
  • Подписка на рассылку

Наиболее распространённое событие лида — Sign Up, которое происходит при регистрации пользователя. В зависимости от используемого фреймворка аутентификации, вот несколько примеров отправки событий лида Sign Up:

Clerk

Better Auth

NextAuth.js

Supabase

Auth0

Appwrite

Своего фреймворка в списке нет? Отправьте событие обычным HTTP-запросом — подойдёт любой язык, см. Track lead.

Событие лида служит источником истины для идентификации клиента и определения ссылки, по которой он пришёл. Это означает, что все последующие действия клиента (например, повышение тарифа, покупка продукта) будут автоматически атрибутированы исходной ссылке.

Отслеживание событий продаж

Второе событие, которое нужно отправить — это событие sale. Оно происходит, когда пользователь покупает ваш продукт или услугу. Это может быть:

  • Подписка на платный план
  • Расширение использования (переход с одного плана на другой)
  • Покупка продукта

Отправляйте события продаж с бэкенда после успешной оплаты через эндпоинт API POST /track/sale. Чаще всего track/sale вызывают из обработчика webhook’а биллинга (например, payment.succeeded от ЮКассы или ваш собственный внутренний webhook).

💡

Хотите отслеживать продажи без предварительного события лида? Передайте clickId напрямую вместе с данными клиента при вызове track/sale — полный список полей см. в API Reference.

Шаг 5: Просмотрите ваши конверсии

После включения отслеживания конверсий для ваших ссылок все отслеженные конверсии будут отображаться в дашборде аналитики . Мы предоставляем 3 различных представления для анализа ваших конверсий:

  • График по времени — клики, лиды и продажи в динамике: Аналитика .
  • Воронка — конверсия и отвал на каждом шаге (клики → лиды → продажи): Аналитика в режиме воронки .
  • Поток событий — каждое событие конверсии по всем ссылкам воркспейса в реальном времени: События .
Last updated on
Клиентское отслеживаниеAppwrite