Campañas digitales garantizadas
Última actualización:
Lo que aprenderás
- Entidades y endpoints de una venta garantizada.
- Modelo de precio de contrato fijo (no CPM).
- Validación de duración del creativo y horizonte de compilación.
- Métricas de entrega (ritmo, por creativo, pantallas mudas).
Antes de empezar
- Rol
- Superadministrador · Administrador · Gerente · Comercial
- Permiso
- campaigns.write
- Inventario
- digital-only o mixed
Ruta: /ad-server/campaigns. API: api/DigitalCampaignLineItems.
- UsuarioDigitalCampaigncliente CRM, nombre, vuelo
- UsuarioAd setpantallas, LoopShare o RequestedSlots, días, franjas, valor
- SistemaPreviewPOST ad-set/preview → PlanAdSetAsync (sin escritura)
- SistemaReservaPOST ad-set → lock por pantalla, GuaranteedSlotReservation, line items
- SistemaCompilaciónPlayers.PlaylistJson; entrada ≤ 2 h antes del inicio
- Nueva campaña: cliente (
Clientdel CRM), vuelo. Inicio por defecto redondeado al siguiente cuarto de hora. - Ad set: pantallas; forma de venta (
Slot,HalfSlot,HalfLoop,Exclusive) oRequestedSlots; días; franjas no solapadas; valor del contrato. - Preview: por pantalla y franja, slot asignado y estado. Misma función que la reserva.
- Reservar:
pg_advisory_xact_lockpor pantalla (orden ordinal) antes de la primera lectura de disponibilidad. Conflicto concurrente → fallo de la segunda venta. - Creativos: subida o biblioteca.
Duración del creativo
Sección titulada «Duración del creativo»FfmpegCreativeProbe mide la duración al subir (StoredFile.DurationMs). CreativeSlotPolicy
compara con el slot (±250 ms).
| Caso | Playback | CMS |
|---|---|---|
| Más corto | último cuadro fijo hasta fin de slot | requiere AcknowledgeCreativeDurationMismatch |
| Más largo | corte en fin de slot | requiere AcknowledgeCreativeDurationMismatch |
| No medido | — | tratado como desconocido, no compatible |
DigitalCampaignLineItem.DurationMs = slot × 1000 es la duración reservada (presupuesto del player),
no la del archivo.
price_per_play = ContractValue ÷ ContractedPlaysGuaranteedSlotReservation(clave: pantalla, slot, días, franja, fechas) guardaContractValueyContractedPlays, escritos una vez.- Line items derivados:
BookedPlays= vueltas que gana la pieza (ReservationShare, replica la elección del player);PriceFlat = ContractValue × BookedPlays ÷ ContractedPlays. Σ hijos = padre es una aserción. BookedPlaysse congela en la primera compilación; cambiar el loop no reprecia lo vendido.- La redistribución corre sólo si cambia la composición (
AllocationSignature, SHA-256). - La liquidación se detiene en
BookedPlays.
Pieza adicional en una venta existente
Sección titulada «Pieza adicional en una venta existente»| Modo | Prioridad | Rotación | Restricción |
|---|---|---|---|
| Toda la venta | normal | entra en la rotación | — |
| Horario propio | 70 | gana todas las vueltas de su franja | días/horas/fechas dentro de la venta; sin solape con otra pieza de igual prioridad |
El diálogo envía reservationId; sin él, la pieza se une a la única reserva que la cubre.
Entrega
Sección titulada «Entrega»| Métrica | Definición |
|---|---|
| Ritmo | plays verificados ÷ plays esperados a la fecha (proporción de vuelo transcurrido) |
| Por creativo | contratado vs emitido por pieza; contratado null si no hay compromiso |
| Pantallas mudas | por pantalla y motivo: player_offline, scheduled_off, awaiting_device, re_pairing |