Tellmetric
Инструкция

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

Вступление — это лид, депозит — это выручка. Многие Telegram-воронки передают первое и теряют второе: к моменту оплаты браузерной сессии, которую можно было бы измерить, уже нет. В этом руководстве рассказываем, как сохранить атрибуцию депозита к исходному клику.

Почему депозиты сложно атрибутировать

В интернет-магазине покупку фиксирует пиксель на странице подтверждения. В Telegram-воронке такой страницы нет. Депозит может быть записан в бэк-офисе брокера, у платёжного провайдера, в счёте в Stars внутри бота или в таблице, которую ведёт отдел продаж, и обычно он происходит намного позже клика по объявлению. Если id клика не сохранялся на всём пути, депозит невозможно отнести к кампании, которая его принесла.

Этот разрыв сказывается и на оптимизации. Кампания, которая передаёт только вступления, учит рекламную платформу искать людей, которые вступают. Кто-то из них внесёт депозит, многие — нет, и платформа никак не может отличить одних от других. Именно передача депозита с его суммой позволяет кампании оптимизироваться на выручку, а не на число участников.

Что нужно фиксировать

  • Id клика, выданный в момент редиректа, вместе с кампанией, группой объявлений и креативом.
  • Аккаунт Telegram, который позже вступил в группу или написал сообщение, связанный с этим id клика.
  • Сам депозит: сумму, валюту, id транзакции и время.
  • Любой идентификатор, известный платёжной системе, — например, email или номер телефона — в хешированном виде для сопоставления.

У каждого пункта свой источник. Клик известен только в момент редиректа, аккаунт Telegram — только боту, а депозит — только платёжной системе. Отслеживание депозитов — это работа по удержанию этих трёх записей связанными.

Четыре способа передать депозит

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

  • Постбэк-URL. Стандартный серверный формат партнёрских трекеров, таких как Keitaro, RedTrack и Voluum: clickid, status, payout, currency и txid. Подходит любой платформе или трекеру, которые хранят id клика Tellmetric и умеют вызывать URL при депозите.
  • API событий. POST-запрос на /track/event с вашего бэкенда, авторизованный вашим секретным ключом. Вместо id клика можно передать id пользователя Telegram, внёсшего депозит; тогда депозит атрибутируется клику, стоящему за последним запуском бота этим человеком за предыдущие 30 дней.
  • Готовая форма. Если у вас нет платформы, способной отправить постбэк, клиент может подтвердить депозит через форму Tellmetric. Когда трекинговая ссылка ведёт на форму, id клика добавляется автоматически, и заявка засчитывается нужному объявлению.
  • Telegram Stars. Платёж в Stars (звёздах), полученный вашим ботом, записывается как покупка, если payload счёта содержит id клика. Перед отправкой суммы в Stars пересчитываются в доллары США, поскольку рекламные платформы принимают только валюты ISO.

Настройка пошагово

  1. Поставьте трекинговую ссылку за каждым объявлением, чтобы каждый клик получал собственный id ещё до того, как посетитель попадёт в Telegram.
  2. Отправляйте посетителя в Telegram через эту ссылку. Бот записывает вступление или первое сообщение на этот id клика.
  3. Создайте секретный ключ на странице Connections (подключения). Ваша платформа передаёт его в заголовке Authorization: Bearer или как api_key в URL, если не умеет задавать заголовки.
  4. Передайте источнику депозитов (трекеру, CRM или платёжному шлюзу) постбэк-URL, где id клика, статус, выплату, валюту и id транзакции подставляют его собственные макросы, или вызывайте API событий со своего бэкенда.
  5. Добавьте в постбэк email или номер телефона клиента, если они есть у вашей платформы. Tellmetric хеширует их перед сохранением.
  6. Отправьте тестовый депозит и проверьте ответ: в нём указано, удалось ли сопоставить клик и какие идентификаторы несёт событие.
  7. Получив постбэк, Tellmetric находит клик, наследует его идентификаторы и отправляет в рекламную платформу событие Purchase с суммой и валютой.
  8. Id транзакции входит в event id, поэтому повторный постбэк по тому же депозиту игнорируется, а второй депозит того же человека учитывается.

Условный пример

Последовательность ниже условная. 3 марта объявление в Meta приводит посетителя на трекинговую ссылку. Ссылка выдаёт id клика c_8Xk…, сохраняет fbclid и UTM-кампанию и открывает бота. В тот же день посетитель вступает в VIP-группу, и Tellmetric передаёт это как регистрацию. 14 марта система брокера вызывает /postback?clickid=c_8Xk…&status=dep&payout=200&currency=EUR&txid=90412. Tellmetric находит клик, добавляет хешированный id Telegram и хешированный email клиента и отправляет в Meta событие Purchase на 200 € под исходной кампанией. Депозит корректно атрибутирован через одиннадцать дней после клика.

Первые депозиты, повторные депозиты и возвраты

Не все депозиты равноценны. Первый депозит означает нового клиента; последующие показывают, насколько ценным этот клиент становится. В грамматике постбэка они различаются так: status=ftd — первый депозит, status=dep — любой депозит. Оба отправляются в Meta как Purchase со своей суммой, а исходный статус сохраняется в событии.

Когда тот же человек вносит депозит снова, Tellmetric помечает событие как совершённое вернувшимся клиентом и указывает Meta на первую покупку. Возвраты и чарджбэки можно передавать с status=refund или status=chargeback. Они фиксируются для вашей собственной отчётности, но никогда не отправляются в рекламную платформу как конверсии.

Если в вашем воркспейсе депозиты проходят проверку, каждый депозит ждёт на странице Deposits (депозиты), пока участник команды его не одобрит или не отклонит, и отправляются только одобренные. Уже отправленный депозит нельзя отозвать из рекламной платформы, поэтому ошибочный депозит исправляется записью возврата.

Где обычно всё ломается

  • Депозиты фиксируются только в CRM. Команда видит выручку, а рекламная платформа продолжает оптимизироваться на клики.
  • Одна и та же инвайт-ссылка Telegram для всех кампаний: депозит можно связать с человеком, но не с источником трафика.
  • Покупка передаётся без суммы. Meta её учитывает, но не может строить ставки под выручку.
  • Опора на еженедельную выгрузку. Meta отклоняет события старше семи дней, а запоздавшие события ослабляют оптимизацию.
  • Сопоставление только по имени, которое вписал менеджер по продажам. Рекламные платформы сопоставляют по хешированному email или номеру телефона.
  • Не передаётся id транзакции. Без него второй депозит по тому же клику выглядит как повтор первого и считается дублем.
  • Код валюты, который рекламная платформа не принимает. Используйте трёхбуквенный код ISO, например EUR или USD.

Как Tellmetric атрибутирует депозиты

Tellmetric сохраняет клик за пользователем Telegram на весь цикл продаж. Каким бы путём ни пришёл депозит, он преобразуется в Purchase, дополняется хешированным email, телефоном или external id, если они переданы, дедуплицируется по транзакции и отправляется в Meta на любом тарифе, а в TikTok, Snapchat, Reddit, Spotify и Google Ads — на тарифах Pro и Agency. Возвраты и чарджбэки фиксируются, но никогда не передаются как конверсии.

У Google Ads есть два собственных требования. Депозит можно засчитать объявлению Google, только если посетитель пришёл с идентификатором клика Google, — на практике это значит через лендинг со сниппетом Tellmetric. Кроме того, Google не принимает конверсии по кликам моложе шести часов, поэтому такие депозиты загружаются при одном из следующих запусков.

Депозиты на дашборде

Таблица воронки показывает депозиты и их сумму рядом с кликами, вступлениями и сообщениями по каждой кампании, источнику, объявлению или стране. Если подключить рекламный аккаунт Meta, импортированный расход добавляет в те же строки стоимость депозита и окупаемость рекламных расходов (ROAS). На тарифах Pro и Agency когорты вступлений группируют участников по неделе вступления и суммируют депозиты, которые они вносят после этого, когда бы они их ни вносили, — так видно, сколько выручки уже принесла каждая неделя новых участников. На странице Deposits перечислены все депозиты со статусом проверки, список можно выгрузить в CSV. Как использовать эти цифры, читайте в материале Как измерять ROI рекламы для групп Telegram.

Частые вопросы

Мои депозиты приходят от брокера, который знает только sub-id. Это поддерживается?

Да, если sub-id, который возвращает брокер, — это id клика Tellmetric: попросите брокера передавать его обратно в поле clickid постбэка. Если брокер не может его вернуть, передавайте депозит из своей системы через API событий с id пользователя Telegram, внёсшего депозит.

Можно ли передавать первый депозит отдельно от последующих?

Да. Используйте status=ftd для первого депозита и status=dep для последующих. Оба отправляются в Meta как Purchase, а исходный статус сохраняется в событии.

А как быть с платежами внутри бота?

Платежи в Telegram Stars фиксируются автоматически, если payload счёта содержит id клика, так что постбэк не нужен.

Через какое время после клика может прийти депозит?

Постбэк сопоставляется по id клика, поэтому депозит атрибутируется, когда бы он ни пришёл. При передаче через API событий с id пользователя Telegram человек должен был запустить вашего бота в течение предыдущих 30 дней. В обоих случаях событие должно быстро попасть в Tellmetric, потому что Meta не принимает события старше семи дней.

Учитываются ли депозиты в лимите тарифа?

Нет. Тарифы считаются в отслеживаемых пользователях, то есть в кликах по трекинговым ссылкам. Конверсии, такие как депозиты, никогда не ограничиваются. Если воркспейс превысил месячный лимит, а оплата по факту использования не включена, новые постбэки отклоняются со статусом 402 до следующего месяца или до перехода на более высокий тариф, при этом редиректы продолжают работать. На тарифе Pro с помесячной оплатой оплата по факту использования стоит 2 € за каждые дополнительные 1 000 отслеживаемых пользователей.

Связанные руководства

Отслеживайте конверсии в Telegram из рекламы в Meta

Для тарифа Free карта не нужна. Перейти на Pro можно в любой момент.