SouthGamesSouthGames/Docs
Iniciar Sesion

Push

Metricas de entrega de notificaciones push.

Resumen de push

GET/api/v1/metrics/push/summary

Entregas de notificaciones en un rango (enviadas, destinatarios, entregadas, fallidas, clicks, descartes) con tasas de entrega y click, y serie diaria. Respaldado por el rollup nocturno (~24h de retraso).

ParametroTipoDescripcion
curl "https://southgames.ai/api/v1/metrics/push/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" },
  "granularity": "day",
  "freshness": "daily-rollup",
  "totals": {
    "sends": 24,
    "recipients": 48000,
    "delivered": 46500,
    "failed": 1500,
    "clicks": 5200,
    "dismisses": 800,
    "deliveryRate": 96,
    "clickRate": 11
  },
  "series": [
    { "date": "2026-06-14", "sends": 2, "recipients": 4000, "delivered": 3900, "failed": 100, "clicks": 450, "dismisses": 60 }
  ]
}

Los contadores se agregan sobre los envios que se completaron ese dia (completedAt). deliveryRate = delivered / recipients; clickRate = clicks / delivered.