Ir al contenido

Deals (PMP, Preferred, PG)

Última actualización:

Lo que aprenderás

  • Tipos de deal y su regla de precio (at).
  • Ciclo de vida con comprador Shareflow Ads vs DSP externo.
  • Reserva de capacidad de Programmatic Guaranteed y forecast.

Antes de empezar

Rol
Superadministrador · Administrador · Gerente
Permiso
programmatic.write
Licencia
private_marketplace o programmatic_guaranteed (add-on)

Ruta: /programmatic/deals. API: api/ProgrammaticDeals (GET, GET options, POST forecast, POST, PUT {id}, PUT {id}/toggle-status, DELETE {id} = archivar, GET {id}/performance).

DealType Precio Comportamiento
pmp CPM mínimo subasta privada entre seats invitados
preferred CPM fijo (at = 3) primera opción para un seat
guaranteed CPM fijo (at = 3) must-bid, capacidad reservada

at del deal es override opcional; null hereda el at de la subasta abierta. DealId es único en la plataforma (pmp.deals[].id, bid.dealid).

  1. Usuariopending_acceptanceel publisher ofrece al BuyerSeatCode
  2. Terceroaccepted | changes_requestedel comprador acepta o pide cambios (BuyerChangeRequest)
  3. Sistemaactiveal crear la campaña ligada al deal
Comprador Shareflow Ads (DSPPartnerId = null).
  • DSP externo (BuyerStatus = external): la aceptación ocurre fuera del API; el publisher activa con toggle-status.
  • Editar un término aceptado incrementa TermsVersion, vuelve a pending_acceptance y libera la reserva PG. Con campaña activada no se revisa: archivar y ofrecer otro.
  • Deals del lado comprador: piloto por cuenta (BuyerSeat.DealsEnabledAt).
  • Un deal privado cierra el mercado abierto sólo en las pantallas que nombra (ActiveDealSet.ForScreen). InventoryIdsJson ilegible = ninguna pantalla.
  • Un deal privado sin inventario no se puede guardar.
  • Reserva SlotsPerLoop por vuelta dentro de ProgrammaticReservedSlots de cada pantalla (ProgrammaticDealReservations).
  • Forecast (POST forecast) = loops en horario × slots × audiencia por play (AudienceEstimator); mismo cálculo al ofrecer, crear y aceptar.
  • Dos PG no comparten reserva con vuelos solapados. Pantalla sin reserva programática → no cabe.

SupplyFeePolicy.ForSaleType: PMP/preferred → PrivateMarketplaceTakeRatePercent; guaranteed → ProgrammaticGuaranteedTakeRatePercent; null hereda la de subasta abierta. El deal congela SupplyFeePercent al crearse.

Pendiente: pacing contractual y make-good de PG.