Campanas

Metricas de campanas y sesiones de juego.

Metricas de campanas respaldadas por los agregados de sesiones (sessionAggregates) — lectura barata y en vivo.

Resumen del periodo

GET/api/v1/metrics/campaigns/summary

Totales de sesiones, victorias, jugadores unicos y codigos canjeados en un rango, con tendencia vs el periodo anterior y desglose por juego y campana.

Parametro	Tipo	Descripcion

curl "https://southgames.ai/api/v1/metrics/campaigns/summary?from=2026-05-17&to=2026-06-16" \
  -H "Authorization: Bearer sg_live_xxx" \
  -H "X-Org-Id: mi-empresa"

{
  "range": { "from": "2026-05-17T00:00:00.000Z", "to": "2026-06-16T00:00:00.000Z" },
  "totals": { "sessions": 12840, "wins": 5136, "winRate": 40, "uniquePlayers": 3120, "codesRedeemed": 412 },
  "trend": { "sessions": 12, "wins": 8, "winRate": -3, "uniquePlayers": 15, "codesRedeemed": 22 },
  "byGameType": [
    { "gameType": "spin_wheel", "count": 9000 },
    { "gameType": "scratch_card", "count": 3840 }
  ],
  "byCampaign": [
    { "campaignId": "camp_abc", "sessions": 8000, "wins": 3200, "winRate": 40 }
  ]
}

Los valores de trend son el cambio porcentual vs el periodo anterior de igual duracion (null cuando no es calculable).

Serie temporal

GET/api/v1/metrics/campaigns/timeseries

Serie diaria de sesiones. Buckets en dias UTC. Acepta filtros opcionales por campana o tipo de juego (en cuyo caso uniquePlayers no esta disponible por dia).

Parametro	Tipo	Descripcion

{
  "range": { "from": "2026-06-14T00:00:00.000Z", "to": "2026-06-16T00:00:00.000Z" },
  "granularity": "day",
  "bucketTimezone": "UTC",
  "filter": { "campaignId": null, "gameType": null },
  "series": [
    { "date": "2026-06-14", "sessions": 420, "wins": 168, "uniquePlayers": 210, "winRate": 40 },
    { "date": "2026-06-15", "sessions": 510, "wins": 199, "uniquePlayers": 260, "winRate": 39 }
  ]
}

Detalle de una campana

GET/api/v1/metrics/campaigns/detail

Estadisticas historicas (all-time) de una campana: jugadas, victorias, jugadores unicos y codigos. Espeja campaign.getStats.

Parametro	Tipo	Descripcion

{
  "campaignId": "camp_abc",
  "totalPlays": 8000,
  "wins": 3200,
  "losses": 4800,
  "winRate": 40,
  "uniquePlayers": 2100,
  "codesGenerated": 5000,
  "codesRedeemed": 412
}