Атрибуция

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

Результат — это ранжирование выручки по источникам, которое вы можете углублять источник → страна → ссылка → фанат, с разбивкой по типу денег (подписки, ребиллы, PPV, чаевые), помеченное новый-vs-возвращающийся, с конверсией пробный→платный и рассчитанными за вас коэффициентами фан-экономики (ARPPU, APC, APV, ARPNU).

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

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

Обогащение «органики» из переписки

Многие organic-фаны на самом деле оставляют в переписке подсказки о том, откуда пришли — и куда больше. Вкладка «Фаны» (в Раскладке) читает историю диалога локально и одним LLM-проходом (на вашем ключе) на каждого фана достаёт:

• портрет — досье на 13 полей (кто он, что покупает, как заходить);
• страну — по тому, что фан привязывает к себе (место, язык, часовой пояс);
• источник — когда фан на него ссылается (платформа, которую он упоминает, или намёк по формату контента: «your reel» → Instagram).

Нажмите «Запустить разбор» — один раз. Дальше панель ведёт весь прогон сама: движок медленно и безопасно вытягивает историю переписки каждого фана из OnlyFans (начиная с крупнейших плательщиков, по одному небольшому батчу за цикл), а мы строим портрет по мере поступления диалога. Скан рассказывает о себе вживую: строка прогресса и честные шаги — «читаю переписку», «определяю страну и источник», «составляю портрет», — а карточки прибавляются сами, без обновления страницы. Повторно нажимать не нужно. Рядом с кнопкой — значок «?»: там и объяснение, как это работает, и ползунок «сколько разобрать». Вторая кнопка, «Пересканировать всех», заново прогоняет уже собранных фанов улучшенным разбором (без единого обращения к OnlyFans). «Остановить» прекращает дальнейший сбор (уже запущенные батчи завершатся сами). Уверенный источник из переписки (≥ 0.6) заменяет «органику» этого фана в лидерборде; более слабые сигналы всё равно видны на карточке, но не трогают денежный сплит. Страна — самый богатый сигнал из переписки: органик редко прямо называет источник, поэтому источник-из-переписки — это бонус поверх портрета и страны.

Прогон бан-безопасен по устройству: сам сбор — это пассивный, серийный, человечный захват движком (одновременно один поток, само-остановка на любой троттлинг); панель лишь ставит в очередь следующий батч и никогда не гонит OnlyFans напрямую, а портрет — это один локальный LLM-проход по уже собранному тексту. Каждое чтение ограничено вашим аккаунтом.

Честно о точности

Это наш стандарт, и у него есть честный потолок. По живому замеру от 2026-08-01: источник находится у 51,5% разобранных фанов (1 020 из 1 979), страна — у 67,4% (1 333 из 1 979). Почему не у всех: если фан пришёл «органикой» и сам не назвал площадку — источник взять неоткуда (так делает лишь ~1 из 10), таким мы честно оставляем «Органика», а не выдумываем. Фаны, пришедшие по вашей короткой ссылке, имеют точный источник всегда — это факт перехода, а не догадка ИИ. Слишком короткие переписки не дают страну. Точность постоянно растёт: движок собирает больше переписки, а мы дорабатываем сам разбор. Инфографика «Что мы знаем о фанах» над списком показывает текущий охват, а кнопка ⓘ рядом объясняет цифры простым языком.

Фильтры по странам и источникам

Кнопка «Фильтр» над списком раскрывает чипы: страны и тиры (T1/T2) и источники (у каждого своя иконка). Чипы — мультивыбор: отметьте несколько стран и/или источников, и в сетке останутся только эти фаны. Иконка источника видна и на карточке фаната. Рядом — кнопка сортировки (по потраченному или по дате подписки), а узкая строка «Поиск» ищет по нику или логину.

Экспорт всех фанов

Кнопка «Экспорт» (в шапке вкладки «Фаны», справа) открывает окно с описанием архива и кнопкой «Скачать» — ZIP по всем разобранным фанам, для оффлайн-анализа или для вашего ИИ-агента:

• fans.csv — сводка по строке на фана (имя, страна, источник, заработано, теги, портрет);
• fans/<fan_id>.json — по каждому фану {info, portrait, conversation} с полной перепиской;
• methodology.txt — как мы определяем источник/страну/портрет и честно о точности;
• ai-prompt.txt — дословный запрос, который мы отправляем ИИ (полная прозрачность — что просим, то и получаем).

Выборка изолирована по аккаунту — только ваши фаны. Тот же объект по одному фану можно прочитать и по API: GET /api/admin/fans/{fan_id}/full.

Чтение лидерборда

Лидерборд оконно ограничен range, который вы передаёте, и переключателем lifetime (см. Оконность). Читайте его из /api/admin/stats и берите revenue.sources.

curl "https://app.tease.link/api/admin/stats?range=30d" \
  -H "Authorization: Bearer $TEASE_API_KEY"

const res = await fetch(
  'https://app.tease.link/api/admin/stats?range=30d',
  { headers: { Authorization: `Bearer ${process.env.TEASE_API_KEY}` } },
);
const stats = await res.json();
const leaderboard = stats.revenue.sources;

import os, requests

res = requests.get(
    "https://app.tease.link/api/admin/stats",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    params={"range": "30d"},
)
leaderboard = res.json()["revenue"]["sources"]

Query-параметры

Ответ — revenue.sources

{
  "sources": [
    {
      "domain_source": "ig-main",
      "source_label": "Main IG",
      "channel": "instagram",
      "subs": 312,
      "spenders": 188,
      "revenue_net_cents": 421550,
      "revenue_gross_cents": 502430,
      "pct": 0.41,
      "new_fans": 240,
      "returning_fans": 72,
      "trial_subs": 96,
      "trial_to_paid": 51,
      "funnel": { "new": 205, "old": 37, "ftl": 96, "paid": 112, "paid_after": 74, "ftl_paid": 38, "entered": 250 },
      "by_kind": [
        { "kind": "subscription", "net_cents": 184200, "count": 240 },
        { "kind": "rebill",       "net_cents": 96100,  "count": 130 },
        { "kind": "ppv",          "net_cents": 121050, "count": 410 },
        { "kind": "tips",         "net_cents": 20200,  "count": 88 }
      ],
      "countries": [
        { "country": "US", "subs": 140, "spenders": 92, "revenue_net_cents": 210400, "revenue_gross_cents": 248900 },
        { "country": "GB", "subs": 51,  "spenders": 33, "revenue_net_cents": 74100,  "revenue_gross_cents": 88200 }
      ],
      "links": [
        { "link_ref": "lnk_8fq2", "subs": 201, "spenders": 130, "revenue_net_cents": 290300, "revenue_gross_cents": 345100 }
      ]
    }
  ],
  "organic": {
    "domain_source": "__organic__", "channel": "", "subs": 410, "spenders": 260,
    "revenue_net_cents": 318900, "revenue_gross_cents": 379400, "pct": 0.31,
    "new_fans": 410, "returning_fans": 0, "trial_subs": 0, "trial_to_paid": 0,
    "funnel": { "new": 0, "old": 0, "ftl": 0, "paid": 0, "paid_after": 0, "ftl_paid": 0, "entered": 0 },
    "by_kind": [], "countries": [], "links": []
  },
  "pending": {
    "domain_source": "__pending__", "channel": "", "subs": 88, "spenders": 0,
    "revenue_net_cents": 0, "revenue_gross_cents": 0, "pct": 0.0,
    "new_fans": 88, "returning_fans": 0, "trial_subs": 88, "trial_to_paid": 0,
    "funnel": { "new": 0, "old": 0, "ftl": 0, "paid": 0, "paid_after": 0, "ftl_paid": 0, "entered": 0 },
    "by_kind": [], "countries": [], "links": []
  },
  "total_net_cents": 1025840,
  "total_gross_cents": 1221230,
  "by_kind": [
    { "kind": "subscription", "net_cents": 402100, "count": 590 },
    { "kind": "rebill",       "net_cents": 221400, "count": 318 },
    { "kind": "ppv",          "net_cents": 351900, "count": 1204 },
    { "kind": "tips",         "net_cents": 50440,  "count": 210 },
    { "kind": "other",        "net_cents": 0,      "count": 0 }
  ],
  "coverage": { "attributed_subs": 740, "organic_subs": 410, "pending_subs": 88, "trial_unknown_subs": 88 },
  "trial_subs": 184,
  "trial_to_paid": 97,
  "reconciliation": {
    "balanced": true,
    "sources_net_cents": 706940,
    "organic_net_cents": 318900,
    "pending_net_cents": 0,
    "total_net_cents": 1025840
  },
  "since": "2026-06-01"
}

Поля лидерборда

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

Каждая запись в sources (и строки organic / pending) имеет такую форму:

Воронка Full Attribution

Каждая строка реального источника, organic и pending всегда несёт один и тот же обязательный объект funnel. Он считает события журнала входов вместе с live-переподписками в запрошенном окне; его расчёт не меняет деньги строки, lifecycle-поля или сверку. Для preset либо custom-границы, равной времени запроса или зажатой до него, верхний край этой воронки открыт: расчёт берёт свой текущий момент и принимает время входа/возврата строго раньше этого момента плюс один час. Это допуск погрешности часов поставщика, а не точная граница to_ts + 3600. Историческая custom-граница раньше времени запроса остаётся точной.

new_fans и funnel.new отвечают на разные вопросы и могут различаться. new_fans — это lifecycle-дополнение returning_fans среди всех назначенных строке subs. funnel.new — оконная ступень: вход обязан попасть в эффективное окно входов этого запроса, а раньше часового допуска перед нижней границей у фана не должно быть транзакций. Lifecycle-поле использует фиксированный tracking anchor аккаунта, поэтому ни одно из двух полей не является подмножеством другого; если окно пересекает anchor, больше может быть любое из них.

Деньги по типу

by_kind появляется на двух уровнях — глобально (revenue.sources.by_kind) и для источника (row.by_kind) — и каждый раз использует те же упорядоченные ключи:

Каждая запись — это { "kind", "net_cents", "count" }. Внутри любой корзины Σ net_cents сверяется с revenue_net_cents этой корзины, так что график «подписки vs PPV» никогда не расходится с заголовком.

Углубление по странам

Каждая строка источника несёт массив countries. Каждая запись разбивает выручку этого источника по стране фаната:

{ "country": "US", "subs": 140, "spenders": 92, "revenue_net_cents": 210400, "revenue_gross_cents": 248900 }

Углубление по ссылкам

Массив links в каждой строке источника атрибутирует выручку вплоть до индивидуальной смарт-ссылки, через которую пришёл фанат:

{ "link_ref": "lnk_8fq2", "subs": 201, "spenders": 130, "revenue_net_cents": 290300, "revenue_gross_cents": 345100 }

Для гео-по-ссылкам матрицы по ссылкам домена читайте выделенную разбивку:

curl "https://app.tease.link/api/admin/domain_links/smartlinks/breakdown?domain=yourbrand.link" \
  -H "Authorization: Bearer $TEASE_API_KEY"

const res = await fetch(
  'https://app.tease.link/api/admin/domain_links/smartlinks/breakdown?domain=yourbrand.link',
  { headers: { Authorization: `Bearer ${process.env.TEASE_API_KEY}` } },
);
const breakdown = await res.json();

res = requests.get(
    "https://app.tease.link/api/admin/domain_links/smartlinks/breakdown",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    params={"domain": "yourbrand.link"},
)
breakdown = res.json()

Это возвращает каждую ссылку с её разбивкой по странам и источникам, так что вы можете сравнить, какая ссылка на домене тянет какие географии. Деньги сверяются с теми же поссылочными итогами, которые вы видите в массиве links лидерборда.

Углубление по фанатам

Три чтения уводят вас от строки источника вниз к индивидуальным фанатам за ней.

curl "https://app.tease.link/api/admin/sources/yourbrand.link/spenders" \
  -H "Authorization: Bearer $TEASE_API_KEY"

curl "https://app.tease.link/api/admin/spenders?range=30d" \
  -H "Authorization: Bearer $TEASE_API_KEY"

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

Новый vs возвращающийся, и пробный → платный

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

• Новый vs возвращающийся — ветка денежной истории использует фиксированный якорь аккаунта funnel_tracking_since, а не выбранное денежное окно. В returning_fans входят фаны с более ранней транзакцией и попавшие в окно live-переподписки, у которых текущее действие of_fans равно return; остальные входят в new_fans. Авторитетна агрегированная строка: legacy-флаги в пофановом drill отражают только ветку денежной истории.
• Пробный → платный — trial_subs — это число фанатов бесплатного пробного периода в корзине; trial_to_paid — сколько из них позже произвели платную выручку. Прочитанные вместе они дают конверсию вашей пробной воронки для этого источника.

Перепись покрытия

coverage — это честная подуровневая перепись — сколько фанатов попало в каждую корзину — чтобы вы могли видеть полноту атрибуции с первого взгляда. Она не двигает деньги, поэтому никогда не влияет на сверку.

Фан-экономика

Коэффициенты экономики возвращаются как выходные данные в двух областях рядом с лидербордом: revenue.fans (область attributed) и revenue.fans_account (область всего аккаунта). Вы их читаете; TEASE их вычисляет.

{
  "scope": "account",
  "arppu_cents": 2240,
  "apc": 3.1,
  "apv_cents": 720,
  "arpnu_cents": 1180,
  "paying_fans": 458,
  "payments": 1420,
  "new_fans": 240,
  "new_paying_fans": 132,
  "new_to_paying_pct": 55.0,
  "cohort_reliable": true,
  "cohort_revenue_cents": 283200,
  "maturing": false
}

Оконность: lifetime vs выбранный период

Атрибуция поддерживает два режима оконности, выбираемых параметром lifetime:

• Выбранный период (по умолчанию, lifetime=false) — вид «новый трафик». Итоги используют точный range или явные from_ts/to_ts; якорь аккаунта не обрезает денежное окно. Поле since — legacy-ярлык якоря, а не фактическая нижняя граница.
• Lifetime (lifetime=true) — вид «за всё время (LTV)». Если полная собственная пара from_ts/to_ts не передана, итоги и сгруппированные агрегаты используют все доходные транзакции допустимых статусов за всё время и игнорируют range; since читается как "lifetime". Оси дневных трендов намеренно ограничены последними 730 днями и укрупняются для длинных периодов. Полная собственная пара имеет приоритет над lifetime.

Оба режима сохраняют инвариант сверки — корзины всегда суммируются в итог для любого окна, которое вы запросили.

Сверка

Объект reconciliation — это ваша проверка целостности лидерборда:

{
  "balanced": true,
  "sources_net_cents": 706940,
  "organic_net_cents": 318900,
  "pending_net_cents": 0,
  "total_net_cents": 1025840
}

FAQ

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

• Смарт-ссылки — создайте отслеживаемые ссылки, к которым разрешаются эти источники.
• TG-атрибуция продаж — тот же вопрос для выручки Telegram-бота.
• Webhooks & CAPI — пересылайте атрибутированные конверсии в Meta и TikTok.
• Справочник API — полная схема /api/admin/stats.