TG-атрибуция продаж

Воронка заканчивается не только на OnlyFans — часть трафика уходит прямыми редиректами в Telegram-бот продаж, и этот бот приносит собственные деньги. TG-атрибуция отвечает на тот же вопрос, что и Атрибуция для OnlyFans, но для бота: какой из ваших доменов привёл каждого платящего Telegram-покупателя и сколько он заплатил?

Нюанс: в бота попадают через обычный редирект, поэтому большинство фанатов приходят без трекинг-метки. Поэтому TEASE разрешает каждого фаната слоями — точный матч там, где он есть, расчётный матч по стране и времени для основной массы и честная «органика» в остатке — и ставит на каждую строку бейдж точности, чтобы расчёт никогда не выдавался за факт.

Ментальная модель

Каждый Telegram-фанат разрешается ровно к одному kind:

Как работает матч по стране и времени

Когда фанат впервые пишет боту, TEASE смотрит на 5 минут назад от этого первого сообщения — на человеческие клики, которые вели в сторону Telegram (прямые Telegram-редиректы по гео и Telegram-кнопки лендингов) из той же страны. Побеждает ближайший клик, предшествующий первому сообщению, — его домен становится источником фаната. Нет подходящего клика в окне (или у фаната нет страны) → фанат остаётся organic.

Две честные линзы

Отчёт намеренно совмещает два окна — ровно так же, как отчитывается сам бот:

• Выручка (деньги) — каждая продажа внутри окна, датированная продажей и атрибутированная к источнику заплатившего фаната. Старый фанат (первое сообщение задолго до окна), заплативший сегодня, считается сегодня. Это питает summary.payers, summary.revenue_net_cents, деньги лидерборда, countries и выручку/плательщиков в тренде.
• Привлечение (воронка) — когорта прихода: фанаты, чьё первое сообщение попало в окно, проведённые по шагам пришло → написали 5+ сообщений → заплатили (в периоде). Это питает summary.fans, funnel, пофаночные fans / msg5plus / nonpayers источников и приходы в тренде.

Чтение отчёта

GET /api/admin/tg-attribution возвращает весь отчёт одним чтением в рамках вашего аккаунта. Все денежные значения — целые центы (net); ответы ненадолго кэшируются на сервере.

curl "https://app.tease.link/api/admin/tg-attribution?period_from=1751328000&period_to=0" \
  -H "Authorization: Bearer $TEASE_API_KEY"

const res = await fetch(
  'https://app.tease.link/api/admin/tg-attribution?period_from=1751328000&period_to=0',
  { headers: { Authorization: `Bearer ${process.env.TEASE_API_KEY}` } },
);
const report = await res.json();

import os, requests

res = requests.get(
    "https://app.tease.link/api/admin/tg-attribution",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    params={"period_from": 1751328000, "period_to": 0},
)
report = res.json()

Query-параметры

Ответ

{
  "summary": { "fans": 214, "payers": 57, "revenue_net_cents": 331900, "msg5plus": 122 },
  "funnel": { "arrived": 214, "msg5plus": 122, "payers": 31 },
  "leaderboard": [
    {
      "domain_source": "вашдомен.com",
      "source_label": "Main IG",
      "source_icon": "instagram",
      "kind": "tg_match",
      "fans": 96,
      "spenders": 24,
      "msg5plus": 61,
      "revenue_net_cents": 182400,
      "pct": 55.0,
      "countries": [
        { "country": "DE", "revenue_net_cents": 96100 },
        { "country": "AE", "revenue_net_cents": 51200 }
      ],
      "users": [
        { "fan_id": "7093412885", "username": "fan_handle", "country": "DE",
          "revenue_net_cents": 44900, "first_ts": 1752537600 }
      ],
      "nonpayers": [
        { "fan_id": "7093412901", "username": "quiet_fan", "country": "DE",
          "message_count": 18, "first_ts": 1752882000 }
      ]
    }
  ],
  "organic": {
    "domain_source": "", "source_label": "Органика (TG)", "source_icon": "",
    "kind": "organic", "fans": 84, "spenders": 21, "msg5plus": 40,
    "revenue_net_cents": 101800, "pct": 30.7,
    "countries": [], "users": [], "nonpayers": []
  },
  "countries": [
    { "country": "DE", "fans": 41, "spenders": 12,
      "revenue_net_cents": 121300, "msg10plus": 9 }
  ],
  "trend": [
    { "date": "2026-07-18", "arrivals": 24, "payers": 6, "revenue_net_cents": 21500 }
  ],
  "trend_unit": "day"
}

Поля верхнего уровня

Поля строки источника

Поля строки страны

Карточка одного фаната

GET /api/admin/tg-fan/{user_id} открывает одного Telegram-фаната — идентичность, разрешённый источник с бейджем точности, пожизненные итоги, ряд net по дням, список транзакций и купленный контент. Возвращает 404, когда фанат неизвестен (или не ваш — чтение изолировано по аккаунту).

curl "https://app.tease.link/api/admin/tg-fan/7093412885" \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "fan_id": "7093412885",
  "username": "fan_handle",
  "name": "Alex",
  "country": "DE",
  "origin": {
    "kind": "tg_match",
    "label": "TG-трафик вашдомен.com",
    "source": "вашдомен.com",
    "domain": "вашдомен.com",
    "country": "DE",
    "precision": "approx"
  },
  "total_net_cents": 44900,
  "purchases": 6,
  "message_count": 132,
  "closeness_level": "warm",
  "closeness_score": 62,
  "first_ts": 1752537600,
  "last_ts": 1753142400,
  "last_purchase_ts": 1753056000,
  "blocked": false,
  "summary_text": "…",
  "preferred_name": "Alex",
  "conversion": 3,
  "paywall_triggers": 2,
  "active_hours": [20, 21, 22],
  "by_day": [ { "day": "2026-07-18", "net_cents": 9900 } ],
  "transactions": [
    { "ts": 1753056000, "net_cents": 9900, "gross_cents": 12900, "kind": "content" }
  ],
  "purchased": [
    {
      "content_id": "c_412", "net_cents": 19800, "count": 2, "last_ts": 1753056000,
      "sale_type": "content", "description": "…", "tags": ["…"],
      "level": 2, "level_label": "…", "media_count": 4,
      "media_types": { "video": 1, "photo": 3 }, "in_catalog": true
    }
  ]
}

Поля карточки

В панели

Этот же отчёт — режим «Telegram» на дашборде: воронка, тренд «Приход и оплаты», лидерборд «Источники» (чип фаната открывает карточку выше) и «Страны». На каждой строке источника и в каждой карточке — бейдж точности, так что «точно» vs «расчёт» всегда виден рядом с деньгами.

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

Дальнейшие шаги

• Атрибуция — лидерборд выручки OnlyFans, который этот отчёт зеркалит.
• Маршрутизация воронки — какие страны и домены отправляют трафик в Telegram.
• Лендинги — гео-сегменты и прямые редиректы, ведущие фанатов в Telegram.