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).
Ciclo de vida
Sección titulada «Ciclo de vida»- Usuariopending_acceptanceel publisher ofrece al BuyerSeatCode
- Terceroaccepted | changes_requestedel comprador acepta o pide cambios (BuyerChangeRequest)
- Sistemaactiveal crear la campaña ligada al deal
- DSP externo (
BuyerStatus = external): la aceptación ocurre fuera del API; el publisher activa contoggle-status. - Editar un término aceptado incrementa
TermsVersion, vuelve apending_acceptancey libera la reserva PG. Con campaña activada no se revisa: archivar y ofrecer otro. - Deals del lado comprador: piloto por cuenta (
BuyerSeat.DealsEnabledAt).
Inventario
Sección titulada «Inventario»- Un deal privado cierra el mercado abierto sólo en las pantallas que nombra
(
ActiveDealSet.ForScreen).InventoryIdsJsonilegible = ninguna pantalla. - Un deal privado sin inventario no se puede guardar.
Programmatic Guaranteed
Sección titulada «Programmatic Guaranteed»- Reserva
SlotsPerLooppor vuelta dentro deProgrammaticReservedSlotsde 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.
Supply fee por tipo
Sección titulada «Supply fee por tipo»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.