API de Marketplace

Descripción general

La API de Authorized Buyers Marketplace es un conjunto de recursos que los compradores pueden usar para administrar lo siguiente de manera programática:

  • Negociaciones con los publicadores
  • Paquetes de subasta
  • Acceso de los clientes a la IU de Marketplace de Authorized Buyers

En esta guía, se presenta la API de Marketplace y se explica cómo se asignan los recursos de la API de Marketplace a las funciones de Marketplace en la IU de Authorized Buyers.

Ofertantes y compradores

La API de Marketplace es coherente con la estructura de la API de ofertas en tiempo real. Ambas APIs usan bidders y buyers como recursos a nivel raíz para las operaciones del ofertante y el comprador. Puedes usar los mismos nombres de ofertante y comprador en las rutas de recursos para las APIs de Ofertas en tiempo real y de Marketplace.

Clientes y usuarios

Puedes usar la API de Marketplace para crear y administrar clientes y usuarios clientes, y para otorgar de manera programática a agencias o anunciantes acceso a tu pestaña de Marketplace en la IU de Authorized Buyers.

Un Client representa a un cliente, una agencia o un anunciante asociado con tu cuenta de Authorized Buyers.

Un ClientUser representa a una persona específica que tiene acceso a la IU en un Client. Los usuarios cliente no pueden acceder a la API de Marketplace. Los usuarios cliente tienen acceso limitado a la pestaña Marketplace de tu cuenta. Los permisos del usuario del cliente se determinan según el role especificado en su Client superior.

Otros recursos de la API de Marketplace hacen referencia a los clientes por el nombre especificado en el recurso Clients.

Para obtener más información sobre los clientes y los usuarios en la IU de Marketplace de Authorized Buyers, consulta los siguientes artículos del Centro de ayuda:

Planificadores de medios

Un planificador de medios es una agencia o cualquier otra entidad que negocia acuerdos con publicadores de forma independiente y permite que uno o más ofertantes hagan ofertas en nombre de sus acuerdos finalizados. Estos acuerdos pueden ser de subasta privada o preferidos y no podrás verlos ni interactuar con ellos hasta que se finalicen. Luego, aparecerán en la respuesta bidders.finalizedDeals.list.

Para determinar si un planificador de medios negoció un acuerdo finalizado determinado, puedes verificar si se propagó el campo mediaPlanner del acuerdo. Los planificadores de medios establecen una lista de los IDs de licencia específicos de la DSP que son aptos para realizar transacciones en el acuerdo, que se pueden ver con el campo eligibleSeatIds. En las solicitudes de ofertas de ofertas en tiempo real, estos IDs de licencias pueden aparecer en las listas de entidades permitidas o bloqueadas que establece el publicador, lo que determinará si las ofertas se filtran de la subasta. Pueden aparecer en los siguientes campos BidRequest:

  • Protocolo OpenRTB
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Protocolo de RTB de Google
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Paquetes de subasta

Puedes usar la API de Marketplace para suscribir y anular la suscripción de compradores y clientes a los paquetes de subasta, y para ver los paquetes de subasta a los que te suscribiste.

Un objeto AuctionPackage es similar a un paquete de segmentación para el inventario de Marketplace. Por ejemplo, un paquete de subasta podría orientarse a un conjunto de IDs de aplicaciones para dispositivos móviles y URLs que sean relevantes para los intereses comerciales de un comprador.

No puedes crear nuevos paquetes de subasta con la API de Marketplace. Puedes usar la IU de Authorized Buyers Marketplace para crear paquetes de subasta. La API de Marketplace no incluye información de segmentación específica asociada con los paquetes de subasta.

Puedes compartir paquetes de subasta con otros compradores y clientes, y puedes compartir contigo paquetes de subasta creados por Google o por otros compradores.

Consulta Paquetes de subasta para obtener más información.

Perfiles de publicador

Puedes usar la API de Marketplace para ver los perfiles de los publicadores con los que puedes negociar.

Un PublisherProfile representa a un publicador en la API de Marketplace. Otros recursos de la API de Marketplace hacen referencia a los publicadores con el nombre especificado en su PublisherProfile.

Los perfiles de publicador tienen información similar a la de Publicadores en la pestaña Descubrimiento de la IU de Marketplace de Authorized Buyers.

Consulta Cómo descubrir publicadores para obtener más información.

Propuestas y acuerdos

Puedes usar la API de Marketplace para negociar acuerdos con los publicadores. Estas son algunas formas en que puedes usar la API de Marketplace para administrar acuerdos:

Las propuestas representan el estado de negociación más reciente de uno o más acuerdos entre un comprador o cliente y un publicador, y son similares a la pestaña Negotiations de la IU de Authorized Buyers Marketplace.

Los acuerdos representan las condiciones más recientes de un acuerdo que se negocia en una propuesta determinada y se pueden comparar con la lista de acuerdos etiquetados como NEGOTIACIÓN ACTUAL para una propuesta determinada en la IU de Authorized Buyers Marketplace.

Los acuerdos finalizados representan acuerdos que completaron la fase de negociación y están listos para entregarse. Esto incluye los acuerdos que ya se están publicando. Los acuerdos finalizados son similares a la pestaña Acuerdos de la IU de Authorized Buyers Marketplace.

Según el tipo de acuerdo que negocias, el comportamiento puede variar entre los recursos de la API de Marketplace. Por ejemplo, los compradores no pueden iniciar las negociaciones para todos los tipos de acuerdos. Si deseas obtener más información sobre la implementación de la API de Marketplace para las negociaciones, consulta los siguientes recursos:

Para obtener más información sobre las negociaciones en la IU de Marketplace de Authorized Buyers, consulta los siguientes vínculos: