Ir al contenido

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.

  1. UsuarioDigitalCampaigncliente CRM, nombre, vuelo
  2. UsuarioAd setpantallas, LoopShare o RequestedSlots, días, franjas, valor
  3. SistemaPreviewPOST ad-set/preview → PlanAdSetAsync (sin escritura)
  4. SistemaReservaPOST ad-set → lock por pantalla, GuaranteedSlotReservation, line items
  5. SistemaCompilaciónPlayers.PlaylistJson; entrada ≤ 2 h antes del inicio
Secuencia de una venta garantizada.
  1. Nueva campaña: cliente (Client del CRM), vuelo. Inicio por defecto redondeado al siguiente cuarto de hora.
  2. Ad set: pantallas; forma de venta (Slot, HalfSlot, HalfLoop, Exclusive) o RequestedSlots; días; franjas no solapadas; valor del contrato.
  3. Preview: por pantalla y franja, slot asignado y estado. Misma función que la reserva.
  4. Reservar: pg_advisory_xact_lock por pantalla (orden ordinal) antes de la primera lectura de disponibilidad. Conflicto concurrente → fallo de la segunda venta.
  5. Creativos: subida o biblioteca.

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 ÷ ContractedPlays
  • GuaranteedSlotReservation (clave: pantalla, slot, días, franja, fechas) guarda ContractValue y ContractedPlays, 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.
  • BookedPlays se 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.
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.

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