Event Sales Provenance

Distribución y origen de marketing de las ventas del evento (#22)

Desglose por dimension: provider (ticketera), distribution (canal del proveedor), purchaseChannel, promoCode (código promocional del pedido: etiqueta, no causalidad) o marketing (fuente → medio → campaña, con level y parent). Claves de proveedor: FEVER, DICE, NEVENT o PROVIDER:<id>. En DICE, canal de distribución y UTM son NOT_SUPPORTED (su API no los da por pedido). Bloques por moneda y, dentro, por proveedor: un slug igual en dos proveedores son dos filas distintas. Cada bloque cumple filas + otros + sin información = total del proveedor (o = parentTotals en niveles medio/campaña); si no, 500 INVARIANT_VIOLATION. Ranking: pedidos DESC, bruto DESC, clave ASC; top filas y el resto en «Otros». search solo selecciona filas en searchMatches (incluidas las que están dentro de «Otros»); no cambia totales, otros ni cuotas. La etiqueta es el valor raw más frecuente (desempate lexicográfico), con todas sus variantes en rawVariants. En marketing, origin distingue lo informado por la ticketera (PROVIDER_PROVENANCE) de lo capturado por Nevent (NEVENT_ATTRIBUTION). No se infiere «directo» desde null ni «paid social» desde «facebook». ticketsTransferred es diagnóstico y no se suma.

get/events/{eventId}/sales-provenance/summary

Request

  • Base URL: http://localhost:8081
  • URL: http://localhost:8081/events/{eventId}/sales-provenance/summary
  • Auth: HTTP bearer

Path parameters

eventIdstring required

Evento; debe pertenecer al ámbito del JWT (si no, 404)

Query parameters

fromstring date required

Primer día (local de tz) de la fecha de compra, inclusivo

tostring date required

Último día (local de tz), inclusivo: el límite es el inicio del día siguiente, exclusivo

tzstring

Zona IANA. Si el cambio de hora salta la medianoche, el día empieza en su primer instante existente

currencystring

ISO 4217 (p. ej. EUR) o NONE para compras sin moneda. Sin él: un bloque por moneda, nunca sumadas

population'SETTLED_SALES' | 'REFUNDED_FULL' | 'REFUNDED_UNREPRESENTABLE' | 'ALL_REPORTED'

Siempre compras activas y nunca registros de audiencia. SETTLED_SALES = liquidadas; REFUNDED_FULL = Fever totalmente cancelada o DICE con todas sus entradas devueltas; REFUNDED_UNREPRESENTABLE = otro REFUNDED (importe devuelto desconocido); ALL_REPORTED = las anteriores más estados no reconocidos, con desglose por estado. En ALL_REPORTED el bruto incluye el bruto informado de las compras reembolsadas por completo: no es ingreso cobrado

dimension'provider' | 'distribution' | 'purchaseChannel' | 'promoCode' | 'marketing'

promoCode = código promocional del pedido (promoCode de DICE, cupón de Fever, cupón nativo). Es una etiqueta del pedido, no demuestra causalidad.

level'source' | 'medium' | 'campaign'

Solo marketing

parentstring

Clave completa (proveedor + origen + ruta) del nivel superior; obligatoria en medium/campaign

topinteger
searchstring

Texto a buscar en etiqueta, valor normalizado y variantes raw (NFKC, minúsculas)

Response

Desglose conciliado

Changes

No recorded changes to this operation across all 1 revision of this API.