Entrar

Audiencia por recurrencia de compra

GET https://{organization}.myguper.com/api/order/report/purchase-frequency/{dateStart}/{dateEnd}

Clientes que compraron N veces en una ventana, con un piso de valor por compra opcional — la audiencia que el constructor QON no expresa, porque su RFM es vitalicio (sin ventana) y no tiene noción de día de compra. Responde "quién compró 3+ veces por encima de $X este semestre", "recompradores de valor alto", "gastó más de $Y desde enero", en una sola llamada en vez de paginar pedidos y agregar del lado del cliente.

Una ocurrencia es un pedido (groupBy=order) o un día de compra (groupBy=purchase_day), donde los tickets del mismo día se suman — la caja parte una compra en varios tickets, así que el día, no el pedido, es la unidad que la campaña quiere. En Cloe 2026 esto es 14% de la audiencia.

valueMode define el piso: all = cada ocurrencia ≥ valueMin (recurrencia de valor alto); any = al menos una; sum = el total de la ventana. valueMin en centavos, inclusivo. minOccurrences es el mínimo de pedidos/días.

Por fila: occurrences (conteo), value (total de la ventana), minValue/maxValue (menor/mayor ocurrencia) y lastDate — el diagnóstico que te deja mostrar por qué entró cada cliente. Valores en centavos; la ventana y el día salen de order_date en la zona horaria de la org, como el reporte de ventas. Las filas se paginan (e/p); total es el tamaño de la audiencia.

Es solo el lado de order — client (id) + métricas. Nombre, correo, teléfono, última tienda y grupo de tienda viven en register; también los filtros de "excluir estas listas de experimento" y "debe tener contacto". Enriquece y filtra con las operaciones de register, y cierra el ciclo con register.audience-list.person.create (que recibe los ids de los clientes) — sin CSV en medio.

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 Inicio de la ventana (YYYY-MM-DD), inclusivo. Cortado de order_date en la zona horaria de la org.
dateEnd * string Fin de la ventana (YYYY-MM-DD), inclusivo.

Parámetros de query

Name Type Description
groupBy string La unidad de la ocurrencia. `order` = un pedido, una ocurrencia. `purchase_day` = un día, sumando los tickets del mismo día. Default: `order`.
minOccurrences integer Mínimo de pedidos/días. Default 1.
valueMin integer Piso de valor por ocurrencia, en centavos (inclusivo). 0 = sin piso. Default 0.
valueMode string Cómo aplica `valueMin`: `all` = cada ocurrencia ≥ valueMin; `any` = al menos una; `sum` = el total de la ventana ≥ valueMin. Default: `all`.
status string Estatus del pedido contado. Default `completed` (solo venta liquidada cuenta en una audiencia de valor). `all` = todo excepto cancelado.
e integer Registros por página (1-1000). Default 100.
p integer Número de página.

Respuestas

{
  "meta": {
    "unit": "cents", "timezone": "America/Mexico_City",
    "groupBy": "purchase_day",
    "filters": { "minOccurrences": 2, "valueMin": 300000, "valueMode": "all", "status": "completed" },
    "notes": { "occurrence": "...", "valueMode": "...", "scope": "..." }
  },
  "rows": [
    { "client": 363050, "occurrences": 11, "value": 546004833,
      "minValue": 2512579, "maxValue": 166735504, "lastDate": "2026-08-25" }
  ],
  "total": 1339,
  "pagination": { "entries": 100, "currentPage": 1, "totalPages": 14, "isInitial": true, "isEnd": false }
}

Relacionados

Copied to clipboard