davepoon/buildwithclaude / plugins/all-skills/skills/second-deposit-igaming
second-deposit-igaming
UnverifiedFinds why casino first-time depositors (FTD) do not make a second deposit, from the operator's back-office exports (deposits, and if available withdrawals, bonuses, bets, players). Assigns each FTD one of 12 reasons, estimates missed second deposits and Sum Dep per reason, computes 24 metrics and builds a list of recent FTDs for CRM with an action by player state and country rules. Use when the user mentions second deposit, STD, FTD to STD, asks why FTDs do not come back or gives casino deposit exports. For industry professionals, 21+.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 27.0 KB |
| examples/export-example.xlsx | binary | 15.6 KB |
| examples/export-queries.sql | other | 8.0 KB |
| examples/mapping-csv-example.json | config | 2.4 KB |
| examples/mapping-example.json | config | 2.5 KB |
| examples/mapping-one-file-example.json | config | 1.4 KB |
| references/data.md | markdown | 15.4 KB |
| references/geo_rules.json | config | 10.3 KB |
| references/geo_rules.md | markdown | 28.3 KB |
| references/scenarios.md | markdown | 27.6 KB |
| scripts/make_demo.py | script | 20.6 KB |
| scripts/make_example.py | script | 32.0 KB |
| scripts/sd_analyze.py | script | 78.0 KB |
| scripts/sd_common.py | script | 25.2 KB |
| scripts/sd_geo.py | script | 6.6 KB |
| scripts/sd_inspect.py | script | 6.4 KB |
| scripts/sd_report.py | script | 122.5 KB |
| scripts/sd_xlsx.py | script | 9.9 KB |
references/scenarios.md
View on GitHub# Причины, показатели, формулы, триггеры
## Причины
Каждый FTD получает одну причину: первый сработавший сигнал в порядке таблицы. Сигналы смотрят на то, что произошло после FTD и до второго депозита (в пределах 7 дней), поэтому у каждой причины есть своя доля вернувшихся.
| Порядок | Причина | Сигнал | Нужны данные |
|---|---|---|---|
| 1 | Много отказов подряд | 3 и больше неудачных попыток депозита за любые 30 минут после FTD | депозиты со статусами |
| 2 | Второй депозит не прошел | попытка депозита после FTD отклонена, брошена или отменена, успешного второго до нее не было | депозиты со статусами |
| 3 | Вывод отклонен | запрос на вывод отклонен раньше второго депозита | выводы со статусом |
| 4 | Запросили документы | проверку личности запросили после FTD и раньше второго депозита | дата запроса документов у игрока |
| 5 | Отыграл бонус и вывел | бонус к FTD и запрос на вывод (выплачен или в обработке) раньше второго депозита | бонусы и выводы |
| 6 | Долгий вывод | вывод выплачен позже чем через 24 часа после запроса (`--slow-withdrawal-hours`) или висит в обработке дольше; если законный срок страны короче, то позже него (Бразилия 2 часа, Колумбия 12) | выводы, лучше со временем выплаты |
| 7 | Выиграл и вывел | запрос на вывод (выплачен или в обработке) раньше второго депозита | выводы |
| 8 | Бонус с тяжелым вейджером | бонус с вейджером от x35 (`--heavy-wager`) начислен в окне от 30 минут до FTD до 6 часов после | бонусы |
| 9 | Сгорел быстро | в первую сессию проиграл не меньше 90% внесенного, а оборот не больше 5 сумм внесенного (`--burn-turnover`) | ставки |
| 10 | Выиграл и не вывел | за 72 часа выигрыш не меньше половины внесенного, вывода не было (проверяется через сутки после FTD) | ставки |
| 11 | Деньги на балансе | за 72 часа поставил меньше, чем внес, вывода не было (проверяется через сутки после FTD) | ставки |
| 12 | FTD не с первой попытки | за 2 часа до FTD была неудачная попытка депозита | депозиты со статусами |
| 13 | Остальные | ни одного сигнала: их доля вторых депозитов и есть норма | |
Первая сессия: 24 часа после FTD по строкам со временем; по дневным строкам день FTD и следующий. 72 часа по дневным строкам: день FTD и три следующих. "Внесенное" это FTD плюс депозиты в том же окне. Кто после неудачной попытки внес другим способом, считается вернувшимся.
Если данных для причины нет, она помечается "нет данных", а игроки попадают в следующую подходящую причину или в "Остальные". Норма тогда ниже, недобор меньше: отчет пишет, что добавить в выгрузку.
## Действия по состоянию игрока
Рекомендация зависит от того, что видно в данных на момент среза.
| Причина | Состояние | Когда | Что делать |
|---|---|---|---|
| Много отказов подряд | | сейчас | личное сообщение или звонок саппорта: помочь оплатить, предложить способ, который проходит в его стране (колонка `suggested_method`) |
| Второй депозит не прошел | | в течение 15 минут | сообщение с другим способом оплаты, который проходит в его стране; без бонуса |
| Много отказов подряд или второй депозит не прошел | отказ по лимиту депозитов | сейчас | другой способ не предлагать, лимит обходить нельзя: объяснить причину и когда лимит обновится; промо на депозит до этого не слать |
| Вывод отклонен | | сейчас | саппорт: почему отклонен и что сделать (документы, другой способ вывода); промо не слать, пока вопрос не решен |
| Запросили документы | | сейчас | помочь пройти проверку: что загрузить, сколько ждать; ускорить ручную проверку; промо не слать |
| Отыграл бонус и вывел | | по цепочке | новых депозитных бонусов не давать; общая коммуникация: турниры, новинки, кешбэк по общим правилам |
| Долгий вывод | в обработке | сейчас | провести вывод и сообщить игроку срок |
| Долгий вывод | выплачен | сейчас, повод через 2-3 дня | извиниться за задержку, следующий вывод провести быстрее, через 2-3 дня повод вернуться |
| Выиграл и вывел | в обработке | сейчас, задача платежей | провести быстро; после выплаты через 2-3 дня повод вернуться |
| Выиграл и вывел | выплачен | через 2-3 дня после выплаты | повод вернуться: турнир или новинки его провайдера; без депозитного бонуса |
| Бонус с тяжелым вейджером | бонус еще отыгрывается | до окончания бонуса | напомнить о прогрессе и сроке; новый оффер после окончания бонуса |
| Бонус с тяжелым вейджером | проигран, истек или статуса нет | в течение 24 часов | оффер без тяжелого вейджера: кешбэк или фриспины с низким вейджером; проверить вейджер первого шага welcome |
| Сгорел быстро | | в течение 24 часов | без давления на депозит: игры с меньшей ставкой и низкой волатильностью, фриспины на минимальной ставке; в продукте подсказка ставки под депозит |
| Выиграл и не вывел | | через 1-2 дня | поздравить и дать повод играть дальше: турнир или новинки его провайдера; бонус не нужен |
| Деньги на балансе | | сейчас | напомнить про баланс и дать повод зайти: турнир, новинка, миссия; бонус не нужен |
| FTD не с первой попытки | | по цепочке | в сообщении о втором депозите кнопка со способом, который прошел; в кассе этот способ первым |
| Остальные | | по цепочке | обычная цепочка второго депозита |
Колонка `state` в `rescue_list.csv` показывает состояние: "вывод в обработке с ...", "вывод выплачен ..." (и "дольше законного срока", если он прошел), статус бонуса, отказ по лимиту (по причине отказа или вероятный по суммам). Колонка `country_rules` дает правила страны игрока, которые касаются его причины: способы оплаты и лимиты при отказе в кассе, законный срок и условия при выводе. Отказ по лимиту узнается по причине отказа из выгрузки (`decline_reasons.limit`) или по суммам игрока, если в стране законный лимит в евро. Игрок, которому отказали из-за блокировки гемблинга в его банке (`decline_reasons.block`), исключается из расчета и списка, как флаг ответственной игры.
## Список для CRM
`rescue_list.csv` (последний срез) и папка `lists/<дата среза>/`: та же таблица `rescue_list.csv`, `actions.csv` (действие, приоритет, сколько игроков, причины, когда, что делать, имя файла), файл на каждое действие (`failed.csv`, `withdrew_paid.csv`, `control.csv` и т.д.), `rescue_list.xlsx` (листы "Действия" и "Список" для Excel) и копия отчета. Повторный запуск за ту же дату перезаписывает папку.
Колонки: `player_id`, `group` (contact или control), `priority`, `reason_code` (причина), `action_code` (действие по состоянию), `send_after_utc`, `snapshot_utc`, `ftd_time`, `ftd_amount`, `currency`, `hours_since_ftd`, `reason`, `state`, `when`, `action` (тексты на языке отчета), `suggested_method`, `country_rules`, `failed_attempts`, `failed_method`, `withdrawal_amount`, `bonus`, `country`, `source`. Время в UTC.
| action_code | Приоритет | send_after_utc |
|---|---|---|
| persist, failed, deposit_limit, wd_rejected, kyc, wd_slow_pending, withdrew_pending | 1 | момент среза |
| wd_slow_paid, burned_fast, heavy_bonus, heavy_active, balance_left | 2 | момент среза |
| won_kept | 3 | не раньше 48 часов после FTD |
| withdrew_paid | 3 | через 2 дня после выплаты |
| bonus_wd, ftd_friction, other | 3 | момент среза (в обычную цепочку) |
| control | пусто | пусто: не писать 7 дней |
Список снимается на момент последней попытки депозита в выгрузке (`snapshot_utc`): в CRM при отправке исключать тех, у кого был депозит после этого момента.
## Формулы
- **STD**: доля FTD с успешным депозитом в течение 7 дней (`--std-days`). В расчет идут FTD старше 7 дней.
- **Полосы размера FTD**: квартили первого депозита. Все сравнения идут внутри полосы, потому что крупные FTD возвращаются чаще.
- **Норма похожих игроков**: STD причины "Остальные" с тем же размером FTD (полоса), источником и страной. Если таких FTD меньше 30, берутся полоса и источник, потом только полоса, потом общая норма "Остальных".
- **Недобор причины**: ожидаемые вторые депозиты (сумма норм полос по игрокам причины) минус фактические, не меньше нуля.
- **Sum Dep вернувшегося**: сумма успешных депозитов за 30 дней после FTD без самого FTD (`--value-days`), среднее по вернувшимся в полосе с обрезкой выше 95-го перцентиля (меньше 20 вернувшихся в полосе: общее среднее).
- **Недобор Sum Dep, вилка**: минимум равен недобору вторых депозитов, умноженному на медианную сумму второго депозита в полосе; максимум равен недобору, умноженному на Sum Dep вернувшегося за 30 дней. В месяц: деленный на длину когорты в днях и умноженный на 30.
- **Контрольная группа**: в списке на сегодня `--control-share` (20%) игроков по хешу ID получают `group=control` и не получают сообщений; один игрок всегда в одной группе. Сервисные случаи (много отказов подряд, вывод отклонен, запросили документы, долгий вывод, вывод в обработке, отказ по лимиту депозитов) всегда `contact`.
- **Журнал и эффект**: `rescue_log.csv` дописывает каждого игрока из списка при первом появлении и отмечает второй депозит, как только он появится в выгрузке. Когда у игрока прошло окно второго депозита, он идет в оценку: доля вторых депозитов у `contact` против `control` по всем и по причинам (от 30 игроков в контрольной группе), z по разнице долей, дополнительные вторые депозиты в месяц и деньги вилкой.
- **Значимость**: z равен разнице ожидаемых и фактических возвратов, деленной на корень из суммы p(1-p). Причина с z меньше 2 помечается "мало данных".
- **Срезы**: способ оплаты FTD, страна, источник, время FTD, бонус к FTD. Сравнение с общим STD игроков с таким же размером FTD. В отчет попадают срезы от 30 FTD (`--min-group`) с z от 2; все срезы с колонкой `significant` лежат в `segments.csv`.
- **Список на сегодня**: FTD за последние 72 часа (`--rescue-hours`) без второго депозита на момент среза, без флагов ответственной игры. Причина считается по уже доступным данным.
- **Способ оплаты после отказа**: лучший по апруву в стране игрока, потом основной для страны тип из правил стран (если у оператора есть такой способ), потом лучший по всем странам. Не предлагаются способ, где был отказ, и типы, запрещенные в стране игрока.
Недобор это верхняя граница: столько стоит разрыв до нормы. Причина показывает, где теряются игроки, но не доказывает, почему. Доказывает тест: действие для случайной половины причины, вторая половина контрольная, сравнить STD через 7 дней.
## Показатели
Все по FTD старше окна второго депозита, без игроков с флагами ответственной игры. Показатель не выводится, если для него нет данных.
| Показатель | Определение |
|---|---|
| FTD в когорте | первые депозиты старше окна второго депозита |
| Второй депозит за 24 ч, 72 ч, 7 дней | доля FTD с успешным вторым депозитом за это время |
| Второй депозит за 30 дней | только FTD старше 30 дней |
| Время до второго депозита | медиана часов от FTD до второго депозита у вернувшихся |
| Второй депозит к первому | медиана суммы второго депозита, деленной на FTD |
| Sum Dep на одного FTD | депозиты за 30 дней после FTD без самого FTD, среднее по всем FTD с обрезкой 95-го перцентиля |
| Sum Dep вернувшегося | то же по вернувшимся за 7 дней |
| Депозитов у вернувшегося | медиана числа депозитов за 30 дней после FTD |
| Апрув депозитов | доля успешных среди всех попыток: успешных, отклоненных, брошенных |
| Апрув первой попытки после FTD | доля FTD, у которых первая попытка после FTD прошла |
| FTD не с первой попытки | доля FTD с неудачной попыткой за 2 часа до FTD |
| Отказ до второго депозита | доля FTD с неудачной попыткой до второго депозита |
| Вывод до второго депозита | доля FTD с запросом на вывод раньше второго депозита |
| Отклоненные выводы | доля отклоненных среди всех запросов на вывод |
| Время выплаты | медиана часов от запроса до выплаты |
| Долгие выводы | доля долгих среди выводов до второго депозита |
| Запросили документы | доля FTD с запросом проверки раньше второго депозита |
| FTD с бонусом, FTD с тяжелым бонусом | доля FTD с бонусом в окне от 30 минут до FTD до 6 часов после; с вейджером от x35 |
| Без единой ставки | доля FTD без ставок за 72 часа |
| Оборот и проигрыш первой сессии | медианы оборота в суммах внесенного и проигрыша в долях внесенного |
| Второй депозит по неделям FTD | STD по неделям с понедельника, последние 8 недель, в каждой от 20 FTD |
## Триггеры в CRM
`rescue_list.csv` можно импортировать как сегмент сразу. Чтобы реагировать без ручного запуска, те же сигналы ставятся триггерами:
1. 3 неудачные попытки депозита за 30 минут: сразу задача саппорту, личное сообщение или звонок.
2. Депозит отклонен, брошен или отменен, успешного второго нет: через 5-15 минут сообщение с другим способом оплаты. Если причина отказа лимит депозитов: без другого способа, объяснение лимита.
3. Вывод отклонен: сразу сообщение саппорта с причиной и шагами.
4. Запросили документы: сообщение с тем, что загрузить и сколько ждать.
5. Вывод в обработке дольше 24 часов или законного срока страны, если он короче (Бразилия 2 часа): задача платежам и сообщение игроку со сроком.
6. Вывод выплачен, второго депозита нет: через 2-3 дня турнир или новинки любимого провайдера.
7. Бонус от x35 к FTD проигран или истек: в течение 24 часов оффер с низким вейджером.
8. Баланс ниже 10% от FTD в первые 24 часа при обороте меньше 5 депозитов: подборка игр с низкой ставкой, без давления на депозит.
9. Через 24 часа после FTD ставок меньше, чем внесено, или выигрыш на балансе: напоминание о балансе, повод зайти.
Во всех триггерах исключать игроков с самоисключением, лимитами, признаками риска и блокировкой гемблинга в банке.
## Поля summary.json
- `overall`: `ftd`, `std_rate`, `norm_rate`, `median_hours_to_std`, `value_per_returner`, `lost_month` и `gap_players_month` (недобор Sum Dep и вторых депозитов в месяц).
- `metrics`: показатели из таблицы выше по ключам (`std_24h`, `approval_all`, `withdraw_rejected_rate` и т.д.); доли от 0 до 1, суммы в валюте отчета, время в часах.
- `weekly[]`: `week` (понедельник), `n`, `rate`.
- `scenarios[]`: `key`, `n`, `share`, `rate`, `expected_rate` (норма для игроков причины), `gap_players_total` (за всю когорту), `gap_players_month`, `lost_total`, `lost_month`, `z`, `available`, `stats` (медианы: `turnover_x`, `loss_share`, `bet_share`, `session_min`, `attempts`, `methods`, `withdrawal_x`, `withdraw_hours`, `win_x`, `bonuses`, `median_ftd`).
- `segments[]`: только значимые срезы: `dim`, `group`, `n`, `rate`, `expected_rate`, `gap_players_month`, `lost_month`, `z`.
- `mode`: `full` или `list`. В режиме списка есть `baseline` (когда и по какой когорте собрана база) и `history` (STD и норма причин из базы).
- `overall.lost_month_min` и `lost_month`, у причин `lost_month_min` и `lost_month`: вилка недобора. `norm_levels`: сколько FTD получили норму по размеру, источнику и стране, по размеру и источнику, только по размеру.
- `rescue`: `total`, `contact`, `control`, `by_scenario`, `excluded_rg`, `ftd_in_window`, `with_second_deposit`, `snapshot`, `ftd_amount_sum`, `deposit_limit` (отказы по лимиту в списке), `banned_skipped` (подсказок, где пропущен запрещенный в стране способ), `with_geo_note`, `list_dir` (папка списка по дате), `actions` (игроков по каждому `action_code`).
- `readiness`: `reasons_ok`, `reasons_total`, `missing` (что добавить в выгрузку: причины по каждому недостающему файлу или полю), `mode`, `ftd`, `mature_ftd`, `days`, `profile`, `country_share`, `untyped_methods`, `rg_flags`.
- `files_used`: какие файлы взяты, если у файла стоит `latest`.
- `geo_rules`: `countries[]` (страны игроков с правилами: `code`, `ftd`, `share`, `slow_h` порог долгого вывода и правила из `geo_rules.json`), `no_rules` (страны без правил), `applied` (`limit_reason`, `limit_amount`, `bank_block`, `slow_by_law`, `over_legal`, `banned_skipped`, `with_geo_note`), `banned_in_data` (попытки депозита запрещенными в стране типами), `eur` (есть ли курс к EUR для лимитов по суммам), `default_slow_h`.
- `effect`: `contact`, `control`, `rate_contact`, `rate_control`, `uplift`, `z`, `extra_month`, `money_month_min`, `money_month_max`, `period`, `by_scenario`. Пусто, пока у игроков из журнала не прошло окно.
- `bonus_names[]`: `name`, `wager`, `heavy`, `count`. `deposit_statuses`: попытки депозита по статусам.
- `caveats` и `quality`: оговорки и что не разобралось.
## Профиль проекта и правила стран
- **Профиль** (`profile.json`) собирает полный запуск: проценты второго депозита за 24 часа, 72 часа, 7 и 30 дней, кривые возврата (доля вернувшихся к 6, 12, 24, 48, 72 часам и к концу окна) по всем, у нормы и по каждой причине от 30 FTD, норму, додепы (`redeposit`: сумма второго депозита, второй к первому, часы до второго, депозитов у вернувшегося, Sum Dep вернувшегося и на одного FTD), полосы FTD, апрув по странам и способам оплаты, время выплаты, историю причин.
- **Прогноз по списку** из профиля: для игрока, который не вернулся за h часов, шанс второго депозита до конца окна равен (F(конец) - F(h)) / (1 - F(h)) по кривой его причины; у нормы так же по кривой нормы. Сумма по списку дает ожидаемые возвраты без действий и недобор до нормы, деньги вилкой: минимум по сумме второго депозита, максимум по Sum Dep вернувшегося.
- **Без истории** профиля нет, и чужих цифр скилл не подставляет: надежных публичных бенчмарков второго депозита нет ни по одной стране. Причины и действия работают с первого дня, норма, прогноз и деньги появляются с 8-го дня, когда у первых FTD пройдет 7 дней и их наберется 50. Пока FTD старше окна меньше 300, цифры профиля уже ваши, но шумные.
- **Правила стран** (`geo_rules.json`): законный срок выплаты, запрещенные способы оплаты, законные лимиты депозитов, блокировки гемблинга в банках, платежи со счета на имя игрока. Что из них берет расчет и официальные источники: `geo_rules.md`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |