Audiencia por producto
Clientes que compraron un producto en una ventana — emparejados por patrón de nombre o por SKU — la audiencia que el constructor QON no expresa, porque no tiene ninguna columna de ítem, SKU, categoría o marca. Responde "quién compró maleta por encima de $500 este semestre", "compradores de estos SKUs", en una sola llamada en vez de paginar cientos de miles de líneas de ítem y agrupar del lado del cliente.
Empareja por productNameLike (lista de patrones, OR entre ellos, sin
distinguir mayúsculas ni acentos, contains) y/o skuRefId (exacto). Al menos
uno es obligatorio. Acota por precio unitario (unitPriceMin/unitPriceMax) y
por piezas (minQuantity, neto de cancelación).
price es el precio unitario, neto de descuento — así que unitPriceMin/
Max filtran el unitario directo, no price/quantity. Eso separa un
producto real de un regalo promocional de 1 centavo en la misma familia. value
es SUM(price × cantidad neta) — lo gastado en los ítems que emparejaron, en
centavos.
Por fila: pieces (cantidad neta comprada), value, lastDate y
matchedPatterns — cuáles de tus patrones de productNameLike emparejó el
cliente, para mostrar por qué cada uno está en la audiencia. La ventana y el
lastDate están en la zona horaria de la org. 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" 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).
Emparejar por nombre hereda el desorden de la nomenclatura del POS.
category/categoryRefId vienen vacíos o inconsistentes en algunas orgs (Cloe
incluida), así que el nombre es la clave confiable hoy — pero arrastra grafías
heredadas y patrones de referencia externa. Amplía productNameLike ante la duda,
y lee matchedPatterns para ver qué atrapó de verdad.
Try-it values populated from environment ACME (Demo)
Autenticación
Token
Send your user token in the x-guper-authorization header.