Отправка активности игроков по API (депозиты, NGR, ставки)

Комиссии по ревшаре и квалифицированному CPA зависят от ценности каждого игрока: депозитов, NGR, ставок. Вместо ежемесячной выгрузки отчёта CRM бренд может отправлять эти данные напрямую по API, ежедневно или в конце месяца.

Запрос

POST на /api/v1/players/activity с API-ключом аккаунта бренда (рекламодателя) с правом записи. Ключ создаётся в меню API панели.

curl -X POST https://rastroaff.com/api/v1/players/activity \
  -H "Authorization: Bearer rst_..." \
  -H "Content-Type: application/json" \
  -d @activity.json

Тело запроса

Каждая строка — один игрок за один период. playerId и date обязательны, остальное — по желанию.

{
  "period": "MONTH",
  "rows": [
    { "playerId": "84731", "clickId": "01JC8Z5K9V3T6W2Q4R7Y1M0N8B", "date": "2026-10",
      "currency": "EUR", "deposits": 150, "depositCount": 3, "ngr": 62.5, "wager": 900 },
    { "playerId": "84732", "date": "2026-10", "deposits": 20, "ggr": 12 }
  ]
}

• playerId: ID игрока в CRM бренда.
• date: ГГГГ-ММ-ДД или ГГГГ-ММ. При period MONTH (по умолчанию) становится 1-м числом месяца.
• clickId: click ID RastroAff, который связывает игрока с партнёром. Может быть внутри другого значения, например btag.
• deposits, depositCount, ngr, ggr, bonuses, withdrawals, chargebacks, wager: числа с точкой.
• ftdDate, ftdAmount, registeredAt, country, currency (по умолчанию EUR).

Ответ

Показывает, сколько строк привязано к партнёру, сколько игроков новых и какие строки остались без партнёра, с причиной.

{ "data": { "importId": "…", "rows": 2, "matched": 1, "newPlayers": 2, "unmatched": 1,
  "errors": [], "unmatchedSample": [{ "index": 1, "externalId": "84732", "clickId": null, "reason": "no_click_id" }] } }

Правила

• До 5 000 строк в запросе.
• Повторная отправка того же игрока, периода и валюты заменяет значения: текущий месяц можно отправлять каждый день.
• Повторяющиеся строки в одном запросе суммируются.
• После привязки к партнёру игрок остаётся привязанным: следующие строки могут приходить без clickId.
• Недопустимые строки возвращаются в errors с индексом, остальные сохраняются.

Дальше

Данные попадают в ежемесячный расчёт комиссий с ревшарой по уровням, вычетами из NGR и квалифицированным CPA. Если удобнее файлы, отчёт CRM по-прежнему можно импортировать: см. ценность игроков и ревшара.