Entrar

Embudo de las campañas de notificación: personas alcanzadas, quién compró y la conversión

GET https://{organization}.myguper.com/api/loyalty/report/notifications/{dateStart}/{dateEnd}

El embudo de las campañas que solo mandan mensaje: cuántas personas alcanzó el mensaje y cuántas de ellas compraron. Es el denominador que ningún otro reporte tiene — order.report.sales dice cuánto generó el mensaje, no a qué costo de alcance.

Solo campaña con type = notification. Esa es la regla de la atribución, no una conveniencia: una campaña monetaria o de punto emite card y se atribuye por el canje de ese saldo; el mensaje que dispara es un aviso de cashback, no "el mensaje que trajo al cliente". Sin ese recorte, el 2026-08-14 una organización tenía 24.035 atribuciones por mensaje viniendo de campaña monetaria contra 41 de campaña de notificación — 99,8% indebidas.

⚠️ Dos fechas distintas, y la respuesta las mantiene separadas en vez de juntarlas en una sola tasa:

  • total es la cohorte: mensajes enviados dentro de la ventana (notificationCard.createdAt), y cuántos de esos ya convirtieron, en cualquier fecha. La conversión solo significa algo así — numerador y denominador son la misma gente. Una ventana reciente es inmadura: la mayor parte sigue open, y su conversión sube después.
  • total.result es lo que pasó dentro de la ventana (attributionDate): las atribuciones y los pedidos del período. Es este bloque el que conversa con la facturación influenciada de order.report.sales, que también filtra por la fecha de la venta.

La ventana de atribución de cada mensaje es COALESCE(expiresAt, attributionAt, createdAt + 30 días). ⚠️ attributionAt no es la fecha en que la compra fue atribuida — se graba al nacer el card y está deprecado; contar conversión por él daría 100% siempre. La conversión solo existe en la tabla de atribución.

Los tres cubos converted / open / expired son excluyentes y suman sent, para que la pantalla pueda mostrar en qué situación está cada mensaje.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Send your user token in the x-guper-authorization header. Endpoints that support a Public mode (e.g. acúmulo and resgate previews) accept the same request without the header — Private mode adds customer data and a confirmation token to the response.

Encabezados

Name Type Description
x-guper-authorization * string User token issued by Guper. Omit only on endpoints that explicitly support a Public mode.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Parámetros de ruta

Name Type Description
dateStart * string Start of the period (YYYY-MM-DD), inclusive.
dateEnd * string End of the period (YYYY-MM-DD), inclusive.

Parámetros de query

Name Type Description
groupBy string Adds the breakdowns. `campaign` returns `byCampaign` (one row per campaign, with the cohort numbers and its own `result`); `day` returns `byDay`, where `sent` is counted by the day the message went out and `orders` by the day of the purchase. Omitted, only `total` comes back.
campaign string Restrict to these campaigns. Array (`campaign[]=663`) or comma list. Ids that are not notification campaigns simply bring nothing.

Respuestas

{
  "meta": {
    "unit": "clients",
    "timezone": "America/Sao_Paulo",
    "window": { "start": "2026-09-01", "end": "2026-09-22" },
    "groupBy": ["campaign", "day"]
  },
  "total": {
    "sent": 23964, "clients": 23694,
    "converted": 124, "convertedClients": 124,
    "open": 22889, "expired": 951,
    "conversionRate": 0.0052,
    "result": { "attributions": 139, "orders": 139, "clients": 124 }
  },
  "byCampaign": [
    {
      "campaign": 664, "campaignName": "09-moda-producto-correo-septiembre-2026",
      "sent": 3948, "clients": 3948,
      "converted": 13, "convertedClients": 13,
      "open": 3800, "expired": 135, "conversionRate": 0.0033,
      "result": { "attributions": 14, "orders": 14, "clients": 13 }
    }
  ],
  "byDay": [
    { "day": "2026-09-01", "sent": 1204, "clients": 1204, "attributions": 6, "orders": 6 }
  ]
}

Notas

Por qué la conversión parece baja

La conversión aquí es personas que compraron / personas alcanzadas, y normalmente es una fracción de un por ciento. Ese es el número honesto: una base que compra de cualquier manera va a producir bastante compra dentro de cualquier ventana de 30 días, y contar eso como "influenciado" mide coincidencia, no influencia.

open es la parte que todavía puede convertir. En una ventana que termina hoy él domina — la conversión de un período reciente no es final, y comparar un período fresco contra uno cerrado siempre favorece al cerrado.

Relacionados

Copied to clipboard