Ir al contenido

Orden de rotación

Última actualización:

Lo que aprenderás

  • Regla de selección del player (n mod RotationCount).
  • Edición del orden y alcance de la recompilación.
  • Piezas excluidas y efecto en BookedPlays/PriceFlat.

Antes de empezar

Rol
Superadministrador · Administrador · Gerente · Comercial
Permiso
campaigns.write
Inventario
digital-only o mixed

En la vuelta n el player emite la pieza con RotationIndex = n mod RotationCount (rotation_eligible), contando desde el ancla de la pantalla. Todas las pantallas de la campaña emiten la misma secuencia en simultáneo.

  1. n mod 3 = 0C
  2. n+1
    n mod 3 = 1A
  3. n+1
    n mod 3 = 2B
Orden C, A, B: RotationIndex 0, 1, 2.
  1. /ad-server/campaigns/{id} → bloque Orden de rotación (rotation-order-panel).
  2. Reordena. El bloque muestra la secuencia (C → A → B → C…).
  3. Guardar → PUT api/DigitalCampaignLineItems/rotation-order con digitalCampaignId y contentIds ordenados. Las piezas no nombradas conservan su orden relativo al final.

Respuesta RotationOrderResult: orden efectivo, posiciones reordenadas, pantallas recompiladas, medios cupos compartidos omitidos.

  • Posición = (pantalla, slot, días, hora de inicio, hora de fin), misma clave que RebalanceRotationAsync. Sólo se reordenan posiciones con > 1 pieza activa.
  • Se recompilan sólo las pantallas cuyo orden cambió. Reenviar el orden vigente es no-op.
Caso Resultado
Pieza con horario propio (prioridad 70) 400
Pieza pausada 400
Id desconocido, vacío o repetido 400
Campaña de otra organización 404
Medio cupo compartido con otro contrato (RotationGroupId ajeno) omitido, contado en la respuesta
  • Reanudar una pieza la coloca al final de su posición. El bloque muestra el aviso «las pantallas no rotan igual»; volver a guardar el orden lo corrige.
  • No hay pesos por pieza: requeriría cambiar la regla n mod count en la flota.