Enviar la actividad de los jugadores por API (depósitos, NGR, apuestas)

Cómo una marca de iGaming envía los depósitos, el NGR y las apuestas de cada jugador a RastroAff por API, en lugar de exportar informes del CRM, con ejemplos.

Actualizado el 6 nov 2026

Las comisiones de revshare y de CPA cualificado dependen del valor de cada jugador: depósitos, NGR, apuestas. En lugar de exportar un informe del CRM cada mes, la marca puede enviar estos valores directamente por API, a diario o a final de mes.

La solicitud

Un POST a /api/v1/players/activity, con una clave de API de la cuenta de la marca (anunciante) con permiso de escritura. La clave se crea en el menú API del panel.

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

El cuerpo

Cada fila es un jugador en un periodo. playerId y date son obligatorios; el resto es opcional.

{
  "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: el ID del jugador en el CRM de la marca.
date: AAAA-MM-DD o AAAA-MM. Con period MONTH (por defecto), pasa al día 1 del mes.
clickId: el click ID de RastroAff, que vincula al jugador con el afiliado. Puede venir dentro de otro valor, como una btag.
deposits, depositCount, ngr, ggr, bonuses, withdrawals, chargebacks, wager: números, con punto decimal.
ftdDate, ftdAmount, registeredAt, country, currency (EUR por defecto).

La respuesta

Indica cuántas filas quedaron vinculadas a un afiliado, cuántos jugadores son nuevos y qué filas no tienen afiliado, con el motivo.

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

Reglas

Hasta 5 000 filas por solicitud.
Reenviar el mismo jugador, periodo y moneda sustituye los valores: puedes enviar el mes en curso cada día.
Las filas repetidas en la misma solicitud se suman.
Una vez vinculado a un afiliado, el jugador sigue vinculado: las filas siguientes pueden venir sin clickId.
Las filas no válidas vuelven en errors, con su índice; las demás se guardan.

Después

Los valores entran en el cálculo mensual de comisiones, con revshare por escalones, deducciones del NGR y CPA cualificado. Si prefieres archivos, puedes seguir importando el informe del CRM: consulta valor de los jugadores y revshare.