Entrar

Reporte de tiempo hasta el canje del cashback: días o semanas hasta usar el saldo (distribución, mediana, p90)

GET https://{organization}.myguper.com/api/loyalty/report/redemption-latency/{dateStart}/{dateEnd}

Distribución del tiempo hasta que una tarjeta de cashback se canjea — cuántos usos de tarjeta ocurrieron el primer día, el segundo día y así sucesivamente (o por semana). Es la distribución, no el promedio: el promedio esconde justo lo que importa, que es la concentración en los primeros días frente a la cola cerca del vencimiento. median y p90 salen de la misma distribución.

basis indica desde dónde corre el reloj:

  • available (por defecto): cuando la tarjeta quedó utilizable (startsAt, después del periodo de espera de la campaña). Úselo para ajustar la vigencia.
  • issued: cuando la tarjeta se emitió. Incluye el periodo de espera.

Los buckets son periodos completos (24 horas o 7 días) entre la base y el débito del checkout; el bucket 0 es el primer día/semana. Solo cuentan canjes liquidados. La granularidad es el uso de tarjeta: un canje que usó dos tarjetas cuenta dos latencias (uses); redemptions es el conteo de canjes distintos en el bucket. share es uses / total (razón).

Mismos filtros que loyalty.report.redemptions: cohort (redemption = débitos en el período, por defecto; issuance = tarjetas emitidas en el período), campaign (lista), originStore, redeemStore. Valores en centavos.

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
buckets string Bucket size. Default `day`.
basis string Where the clock starts: card availability (default) or card issuance.
cohort string Which date the period applies to. `redemption` (default) or `issuance`.
campaign string Only cards of these campaigns. Array or comma list; up to 200 ids.
originStore integer Only cards issued by this store.
redeemStore integer Only redemptions made in this store.
rewardType string Which wallet. Default `monetary`.

Respuestas

{
  "meta": { "unit": "days", "basis": "cardAvailableAt", "cohort": "issuance", "timezone": "Etc/GMT+6" },
  "total": 767,
  "median": 2,
  "p90": 8,
  "rows": [
    { "bucket": 0, "uses": 172, "redemptions": 166, "redeemedValue": 7788667, "share": 0.2243 },
    { "bucket": 1, "uses": 121, "redemptions": 117, "redeemedValue": 4434159, "share": 0.1578 },
    { "bucket": 2, "uses": 100, "redemptions": 100, "redeemedValue": 3856692, "share": 0.1304 }
  ]
}

Relacionados

Copied to clipboard