Entrar

RFM por cohorte de adquisición — clientes nuevos / altas por día

GET https://{organization}.myguper.com/api/register/report/rfm-cohort/{dateStart}/{dateEnd}

RFM de clientes agregado por cohorte de adquisición — cuántos clientes se adquirieron en cada mes (o en cada tienda) y cuánto valen a lo largo de su vida — en una sola llamada. Es la base de RFM, agrupada: en vez de paginar cientos de miles de filas por cliente y agrupar del lado del cliente, devuelve el rollup de la cohorte de una vez.

La cohorte se corta por la fecha de la 1ª compra (firstPurchaseDate). Agrupa por month (mes de adquisición), firstStore (tienda de adquisición), o ambos. Por cohorte obtienes clients, lifetimeValue y avgValue (gasto), avgOrders (frecuencia), avgCadenceDays (intervalo de recompra, solo entre clientes con 2+ compras) y avgDaysWithoutPurchase (recencia hoy).

Valores en centavos. El mes se corta en la zona horaria de la organización, así las cohortes coinciden con el reporte de ventas por (mes, tienda). El total reconcilia con la suma de las filas por construcción.

Lee la semántica con atención: la tienda es la tienda de adquisición y lifetimeValue es el gasto lifetime org-wide del cliente (en todas las tiendas), no las ventas de la tienda — "clientes adquiridos en la tienda X y cuánto gastaron en total". Para ventas por tienda usa order.report.sales; no los mezcles.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Send your user token in the x-guper-authorization header.

Encabezados

Name Type Description
x-guper-authorization * string User token issued by Guper.
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 acquisition window (YYYY-MM-DD), inclusive — customers whose first purchase falls on/after this date.
dateEnd * string End of the acquisition window (YYYY-MM-DD), inclusive.

Parámetros de query

Name Type Description
groupBy string How to break the cohorts down. One of `month` (acquisition month), `firstStore` (acquisition store), or a comma list. Default: `month`.

Respuestas

{
  "meta": {
    "unit": "cents", "timezone": "Etc/GMT+6",
    "groupBy": ["month"],
    "window": { "dateStart": "2025-01-01", "dateEnd": "2025-06-30" }
  },
  "rows": [
    { "month": "2025-01", "clients": 16131, "lifetimeValue": 4676422124, "avgValue": 289903,
      "avgOrders": 1.50, "avgCadenceDays": 98.1, "avgDaysWithoutPurchase": 435 },
    { "month": "2025-02", "clients": 8890, "lifetimeValue": 2766238779, "avgValue": 311163,
      "avgOrders": 1.49, "avgCadenceDays": 94.2, "avgDaysWithoutPurchase": 410 }
  ],
  "total": {
    "clients": 74775, "lifetimeValue": 24488794816, "avgValue": 327500,
    "avgOrders": 2.49, "avgCadenceDays": 78, "avgDaysWithoutPurchase": 366
  }
}

Relacionados

Copied to clipboard