Entrar

Audiência por recorrência de compra

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

Clientes que compraram N vezes numa janela, com um piso de valor por compra opcional — a audiência que o construtor QON não expressa, porque o RFM dele é vitalício (sem janela) e não tem noção de dia de compra. Responde "quem comprou 3+ vezes acima de $X neste semestre", "recompradores de valor alto", "gastou mais de $Y desde janeiro", numa única chamada em vez de paginar pedidos e agregar no cliente.

Uma ocorrência é um pedido (groupBy=order) ou um dia de compra (groupBy=purchase_day), em que os tickets do mesmo dia são somados — o caixa fatia uma compra em vários tickets, então o dia, não o pedido, é a unidade que a campanha quer. Na cloe de 2026 isso é 14% da audiência.

valueMode define o piso: all = toda ocorrência ≥ valueMin (recorrência de valor alto); any = ao menos uma; sum = o total da janela. valueMin em centavos, inclusivo. minOccurrences é o mínimo de pedidos/dias.

Por linha: occurrences (contagem), value (total da janela), minValue/maxValue (menor/maior ocorrência) e lastDate — o diagnóstico que deixa você mostrar por que cada cliente entrou. Valores em centavos; a janela e o dia saem de order_date no fuso da org, como o relatório de vendas. As linhas são paginadas (e/p); total é o tamanho da audiência.

É só o lado de order — client (id) + métricas. Nome, e-mail, telefone, última loja e grupo de loja moram no register; e também os filtros de "excluir estas listas de experimento" e "precisa ter contato". Enriqueça e filtre com as operações do register, e feche o ciclo com register.audience-list.person.create (que recebe os ids dos clientes) — sem CSV no meio.

Try-it values populated from environment ACME (Demo)


Autenticação

Token

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

Cabeçalhos

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 do caminho

Name Type Description
dateStart * string Início da janela (YYYY-MM-DD), inclusivo. Cortado de order_date no fuso da org.
dateEnd * string Fim da janela (YYYY-MM-DD), inclusivo.

Parâmetros de query

Name Type Description
groupBy string A unidade da ocorrência. `order` = um pedido, uma ocorrência. `purchase_day` = um dia, somando os tickets do mesmo dia. Default: `order`.
minOccurrences integer Mínimo de pedidos/dias. Default 1.
valueMin integer Piso de valor por ocorrência, em centavos (inclusivo). 0 = sem piso. Default 0.
valueMode string Como o `valueMin` se aplica: `all` = toda ocorrência ≥ valueMin; `any` = ao menos uma; `sum` = o total da janela ≥ valueMin. Default: `all`.
status string Status do pedido contado. Default `completed` (só venda liquidada conta numa audiência de valor). `all` = tudo exceto cancelado.
e integer Registros por página (1-1000). Default 100.
p integer Número da página.

Respostas

{
  "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