Audiência por produto — quantos clientes compraram um produto ou categoria
Clientes que compraram um produto numa janela — casados por padrão de nome ou por SKU — a audiência que o construtor QON não expressa, porque ele não tem nenhuma coluna de item, SKU, categoria ou marca. Responde "quem comprou mala acima de $500 neste semestre", "compradores destes SKUs", numa única chamada em vez de paginar centenas de milhares de linhas de item e agrupar no cliente.
Casa por productNameLike (lista de padrões, OR entre eles, case e acento
insensível, contains) e/ou skuRefId (exato). Ao menos um é obrigatório.
Restrinja por preço unitário (unitPriceMin/unitPriceMax) e por peças
(minQuantity, líquido de cancelamento).
price é o preço unitário, líquido de desconto — então unitPriceMin/Max
filtram o unitário direto, não price/quantity. É isso que separa um produto
de verdade de um brinde promocional de 1 centavo na mesma família. value é
SUM(price × qtd líquida) — o gasto nos itens que casaram, em centavos.
Por linha: pieces (quantidade líquida comprada), value, lastDate e
matchedPatterns — quais dos seus padrões de productNameLike o cliente
casou, pra você mostrar por que cada um está na audiência. A janela e o
lastDate são no fuso da org. 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" 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).
Casar por nome herda a bagunça da nomenclatura do PDV.
category/categoryRefId vêm vazios ou inconsistentes em algumas orgs (cloe
incluída), então o nome é a chave confiável hoje — mas carrega grafias legadas e
padrões de referência externa. Alargue o productNameLike na dúvida, e leia o
matchedPatterns pra ver o que de fato pegou.
Try-it values populated from environment ACME (Demo)
Autenticação
Token
Send your user token in the x-guper-authorization header.