Skip to Content
Документация для разработчиковОтслеживание конверсийОтслеживание лидовОтложенное отслеживание лидов

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

💡

Отслеживание конверсий доступно на тарифе Business и выше .

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

  • зарегистрировался;
  • записался на демо;
  • подписался на рассылку.

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

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

  • Пользователь провёл первую встречу в Granola 
  • Пользователь выполнил первый поисковый запрос в Perplexity 
  • Пользователь надиктовал первые 2 000 слов в Wispr Flow 

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

Схема работы отложенного отслеживания лидов

💡

Отложенное отслеживание лидов особенно полезно для отслеживания квалифицированных лидов (sales-qualified leads, SQL) — как для целей маркетинговой атрибуции, так и для того, чтобы вознаграждать партнёров за квалифицированные лиды (а не просто за регистрации) в RevRoute Partners .

Что нужно до начала

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

💡

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

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

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

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

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

Затем установите на сайт клиентский скрипт RevRoute — он фиксирует клик и сохраняет его идентификатор, без которого события лида не к чему привязать.

Клиентский скрипт 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.

Серверный клиент RevRoute

Примеры ниже используют TypeScript-SDK из npm-пакета dub. В клиенте обязательно указывается serverURL API RevRoute — без него SDK будет обращаться не к нашему API.

npm install dub
import { Dub } from "dub"; export const revroute = new Dub({ token: process.env.REVROUTE_API_KEY, // секретный ключ rr_* из настроек воркспейса serverURL: "https://api.revroute.ru", // обязательно: адрес API RevRoute });
⚠️

Секретный ключ (rr_*) держите в переменных окружения и не отдавайте в браузер. Ключ создаётся в разделе API-ключей .

💡

SDK не обязателен: /track/lead и /track/sale — обычные HTTPS-эндпоинты, их можно вызвать из любого языка (см. Track lead).

Шаг 1: Отслеживание отложенного события лида

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

  • Регистрация аккаунта
  • Бронирование демо-встречи
  • Подписка на рассылку

Для этого нужно установить свойство mode в значение deferred при отслеживании события лида. При этом RevRoute по-прежнему будет отслеживать клиента и идентификатор клика, по которому он пришёл, но отложит создание фактического события лида на последующий запрос.

import { RevRoute } from "dub"; const dub = new RevRoute(); const clickId = req.cookies["rr_id"]; if (clickId) { await dub.track.lead({ clickId: clickId, mode: "deferred", eventName: "Sign Up", customerExternalId: customer.id, customerName: customer.name, customerEmail: customer.email, customerAvatar: customer.avatar, }); // delete the rr_id cookie res.cookies.set("rr_id", "", { expires: new Date(0), }); }

Шаг 2: Отслеживание квалифицированного события лида

Когда пользователь совершает действие, делающее его квалифицированным лидом, вы можете отследить событие квалифицированного лида. Для этого повторите тот же запрос отслеживания лида, что и ранее, но без свойства mode и с установкой свойства clickId в пустую строку.

import { RevRoute } from "dub"; const dub = new RevRoute(); await dub.track.lead({ clickId: "", eventName: "Sign Up", customerExternalId: customer.id, customerName: customer.name, customerEmail: customer.email, customerAvatar: customer.avatar, });

Где смотреть конверсии

После настройки все отслеженные конверсии видны в аналитике воркспейса — в трёх представлениях:

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