Acuerdos de Programática garantizada

En los acuerdos de Programática garantizada, negocias con los vendedores la cantidad de impresiones que comprarás a un precio fijo. Si aceptas una propuesta para un acuerdo de Programática garantizada, te comprometes a comprar el inventario del vendedor en función de las condiciones negociadas. Si quieres obtener más información sobre los compromisos y las herramientas para supervisar el cumplimiento, consulta el artículo del Centro de ayuda en el que se describe el framework del ANS de Programática garantizada.

Crear

Los acuerdos de Programática garantizada se crean cuando las negociaciones comienzan con una solicitud de propuesta (RFP). Para iniciar las negociaciones, envía una solicitud de propuesta a un vendedor con buyers.proposals.sendRfp. La RFP debe contener programmaticGuaranteedTerms para que la propuesta resultante sea para un acuerdo de Programática garantizada. Los vendedores también pueden enviarte una RFP, que aparecerá como una propuesta en la API de Marketplace. Una vez creada, puedes encontrar la propuesta del acuerdo con buyers.proposals.list y puede comenzar la negociación entre tú y el vendedor.

Negociar

Una vez que se crea una propuesta para un acuerdo de Programática garantizada, puedes negociar con el vendedor ajustando la propuesta y su acuerdo correspondiente hasta que ambas partes estén satisfechas o la propuesta se cancele. En una negociación exitosa, puedes realizar cualquiera de las siguientes acciones:

  • Consulta los cambios de la propuesta o el acuerdo: Cada vez que se realice un cambio en una propuesta o en su acuerdo correspondiente, se incrementará proposalRevision. Puedes usar esto para detectar cuándo el vendedor aceptó tu propuesta o respondió con una contraoferta.
  • Aplicar un parche a la propuesta o el acuerdo: Modifica tu propuesta o envía una contraoferta al vendedor. Esto aumentará el proposalRevision.
  • Comunicarse con el vendedor: Las propuestas contienen notas que son visibles para los compradores y vendedores. Por ejemplo, puedes agregar una nota para proporcionar contexto sobre un cambio que hiciste en una propuesta o en su acuerdo.

Finaliza y prepárate para la publicación

Cuando estés conforme con una propuesta y su state sea BUYER_ACCEPTANCE_REQUESTED, puedes aceptarla. De esta manera, se finaliza el acuerdo, que comienza a publicarse en el flightStartTime.

Para garantizar que el acuerdo solo comience a publicarse cuando tengas creatividades preparadas, recomendamos que te comuniques con tu administrador técnico de cuentas para inhabilitar este comportamiento predeterminado en tus acuerdos de Programática garantizada y, en su lugar, indicar de forma manual cuando estén listos para publicarse. Este es un flujo de trabajo de ejemplo en el que señalas de forma manual cuándo tus acuerdos de Programática garantizada están listos para publicarse:

  • Negocia la propuesta con el vendedor
  • Usa la API de Real-time Bidding a fin de enviar creatividades para su revisión: Las creatividades que quieras colocar deben revisarse y aprobarse para su uso en acuerdos.
  • Acepta la propuesta: Una vez que se acepta una propuesta, los acuerdos aceptados se reflejan en los acuerdos finalizados.
  • Usa la API de Ofertas en tiempo real para recuperar las creatividades que se enviaron antes y confirmar que están aprobadas para su uso en ofertas de acuerdos de Ofertas en tiempo real: Consulta el dealsPolicyCompliance para verificar que las creatividades están aprobadas y se pueden colocar en respuesta a solicitudes de ofertas de acuerdos entrantes.
    • Si no se aprobó la creatividad, revisa los temas para determinar el motivo del rechazo. Ajusta la creatividad según sea necesario y párala para iniciar la revisión nuevamente hasta que se resuelvan todos los problemas.
  • Agrega todas las creatividades que se usarán para el acuerdo finalizado: Recomendamos agregar creatividades al acuerdo con el que deseas usarlas antes de iniciar la publicación del acuerdo.
  • Indica de forma manual que el acuerdo está listo para publicarse: Una vez que el acuerdo esté listo para publicarse, comenzarás a recibir solicitudes de oferta para el acuerdo en el flightStartTime configurado, que continuará hasta que se alcance su flightEndTime o impressionCap.

Volver a negociar

Una vez que finaliza un acuerdo, tú o el vendedor pueden iniciar la renegociación mediante la modificación de la propuesta o sus acuerdos. Durante la renegociación, el recurso finalizedDeals refleja el acuerdo anterior y continuará entregando en función de eso si es posible. En cambio, el recurso deals refleja el estado actual de la renegociación, que procederá de manera similar a la negociación inicial.

Si tanto tú como el vendedor aceptan el acuerdo renegociado, este reemplazará el acuerdo original finalizado y se publicará según el acuerdo nuevo. De lo contrario, si se cancela, el acuerdo se revertirá a su estado previo a la renegociación.

Establece ofertas para las impresiones en los acuerdos de Programática garantizada

Cuando un acuerdo de Programática garantizada comienza a publicarse, tu integración de Ofertas en tiempo real recibirá solicitudes de ofertas para ese acuerdo y deberá ofertar en función de sus términos; por ejemplo, a un precio específico por una cantidad determinada de impresiones durante un período.

Una solicitud de oferta determinada puede incluir más de un acuerdo de PG. Cuando esto sucede, se espera que respondas por cada ID de acuerdo enviado en la solicitud. Los campos directamente relevantes para los acuerdos de Programática garantizada incluyen los siguientes:

Protocolo de Google Protocolo OpenRTB Descripción
BidRequest.adslot.matching_ad_data.direct_deal.direct_deal_id BidRequest.imp.pmp.deals.id Es el identificador único del acuerdo. Equivale al ID de recurso del acuerdo que muestra la API de Marketplace.
BidRequest.adslot.matching_ad_data.direct_deal.deal_type BidRequest.imp.pmp.deals.ext.deal_type El tipo de subasta, que se establecerá en PROGRAMMATIC_GUARANTEED, o "3" para OpenRTB JSON.
BidRequest.adslot.matching_ad_data.direct_deal.fixed_cpm_micros BidRequest.imp.pmp.deals.bidfloor Será equivalente al CPM del acuerdo que aceptaron el comprador y el vendedor. Aparecería como fixedPrice en la API de Marketplace. En el caso de los acuerdos de Programática garantizada, esto anulará cualquier valor especificado en la respuesta a la oferta.
BidRequest.adslot.matching_ad_data.direct_deal.publisher_blocks_overridden BidRequest.imp.pmp.deals.ext.publisher_blocks_overridden Siempre es true para los acuerdos de Programática garantizada, lo que significa que se permiten las categorías excluidas.
BidRequest.adslot.matching_ad_data.direct_deal.must_bid BidRequest.imp.pmp.deals.ext.must_bid Indica si los compradores deben ofertar en el acuerdo. Por ejemplo, si el acuerdo está adelantado a la programación, el valor se establecerá como Falso y las ofertas serían opcionales. De lo contrario, es necesario establecer ofertas, lo que significa que no realizarlas puede afectar negativamente la publicación de acuerdos y la disponibilidad del inventario.

Cómo detener y reanudar la publicación

Debes usar el método buyers.finalizedDeals.pause para detener un acuerdo de Programática garantizada finalizado si por el momento no puedes ofertar por él. Por ejemplo, puedes hacerlo si tu creatividad se aprobó inicialmente, pero se rechazó y, en consecuencia, se debe volver a enviar. Ten en cuenta que, si bien esto te impedirá recibir solicitudes de ofertas para el acuerdo, aún deberás cumplir con las obligaciones que se negociaron como condiciones del acuerdo.

Para reanudar la entrega del acuerdo finalizado, puedes usar buyers.finalizedDeals.resume.