Ejecuta una subasta basada en el navegador con un solo vendedor

En este documento, encontrarás una descripción general de alto nivel para ejecutar una subasta con Datos de Protected Audience para un solo vendedor, como se usan en la iteración actual de la API de Protected Audience. Una subasta con un solo vendedor puede se lleva a cabo como parte de una subasta más compleja que involucra a varios vendedores. En este caso, la subasta de un solo vendedor se conoce como "subasta de componentes", Puede proporcionar candidatos de anuncios para la "subasta de nivel superior". que tiene varios vendedores participan.

Lee la guía para desarrolladores para conocer el ciclo de vida completo de la API de Protected Audience. y consulta la explicación de la API de Protected Audience para obtener información debate sobre cómo los vendedores realizan subastas integradas en el dispositivo.

Seis etapas de una subasta de anuncios de la API de Protected Audience

Seis etapas de una subasta de anuncios de la API de Protected Audience .
En este diagrama, se describe cada etapa de una subasta de anuncios de la API de Protected Audience.
  1. Un usuario visita un sitio que muestra anuncios.
  2. El código del vendedor ejecuta navigator.runAdAuction(). Esto especifica qué el espacio publicitario está en venta y quién puede ofertar. Los vendedores también deben incluir un guion que califica cada oferta, scoreAd().
  3. El código del comprador invitado se ejecuta para generar una oferta (URL para un anuncio relevante). la creatividad y otros datos. La secuencia de comandos de licitación puede consultar datos en tiempo real como el presupuesto restante de la campaña publicitaria, del presupuesto Servicio de par clave-valor.
  4. El código del vendedor califica cada oferta y selecciona un ganador. Esta lógica usa el el valor de la oferta y otros datos muestran la deseabilidad de una oferta. Anuncios insuperables el ganador contextual se rechaza. El vendedor puede usar sus propios Servicio de par clave-valor para datos en tiempo real.
  5. El anuncio ganador se muestra como un valor opaco, que aparece en un marco vallado. Tanto el vendedor como el publicador no podrá ver este valor.
  6. Se informa la subasta al vendedor y a los compradores ganadores.

Se puede realizar una subasta cuando un usuario navega a una página en la que se muestra un anuncio. Las subastas se pueden publicar de manera anticipada para que la creatividad del anuncio esté lista cuando el anuncio se ve.

Los vendedores inician la subasta de anuncios y asignan una puntuación a los anuncios candidatos según la lógica personalizada proporcionada. como una función scoreAd() y son responsables de informar los resultados del subasta entre sí mismo y al comprador ganador. Los vendedores también pueden aplicar reglas del publicador y filtrar la calidad del anuncio mediante su scoreAd() .

Un vendedor puede referirse a lo siguiente:

  • Publicadores de contenido que actúan por su cuenta para alojar contenido de anuncios en su sitio web
  • Plataformas de proveedores (SSP), que trabajan con el publicador de anuncios y proporcionan otros servicios
  • Secuencias de comandos de terceros, que actúan para que los publicadores habiliten la participación en subastas de anuncios

Requisitos previos para ejecutar una subasta

Un vendedor necesita dos funciones de JavaScript definidas para ejecutar una subasta:

  • scoreAd(), que asigna una puntuación a un anuncio candidato
  • reportResult(), que controla la información del resultado de la subasta al vendedor

Estas secuencias de comandos se deben entregar desde un único extremo que pertenezca al vendedor.

scoreAd()

Un vendedor debe definir una función scoreAd() que se entrega desde un extremo. que poseen. El extremo se especifica en la configuración de la subasta como el decisionLogicUrl La función scoreAd() tiene la siguiente firma:

scoreAd(
  adMetadata,
  bid,
  auctionConfig,
  trustedScoringSignals,
  browserSignals,
  directFromSellerSignals)

Los parámetros scoreAd() son los siguientes:

  • adMetaData, que son metadatos arbitrarios sobre la creatividad del anuncio que se proporcionados por el comprador. Este es un objeto JSON serializable que los vendedores y los compradores tendrán que definir y acordar la estructura.
  • bid, que es un valor numérico que representa la oferta.
  • auctionConfig, que es la configuración de la subasta que se usa para ejecutarla
  • trustedScoringSignals, que son indicadores leídos en el momento de la subasta desde el servidor de par clave-valor del vendedor. La plataforma usará el renderUrl de la candidato como la clave para esta búsqueda.
  • browserSignals, que es un objeto que construye el navegador, y que incluye lo siguiente: información que el navegador conoce y cuál es la secuencia de comandos de subasta del vendedor que deseas verificar.
  • directFromSellerSignals es un objeto que puede contener los siguientes campos: ** sellerSignals: Es similar a auctionConfig.sellerSignals, pero se pasa usando el Mecanismo directFromSellerSignals. ** auctionSignals: Es similar a auctionConfig.auctionSignals, pero se pasa usando el Mecanismo directFromSellerSignals.

El siguiente es un ejemplo de browserSignals. Ten en cuenta que el renderUrl de la El anuncio candidato está disponible mediante estos indicadores:

{ 'topWindowHostname': 'www.example-publisher.com',
  'interestGroupOwner': 'https://www.example-buyer.com',
  'renderURL': 'https://cdn.com/render_url_of_bid',
  'renderSize': {width: 100, height: 200}, /* if specified in the bid */
  'adComponents': ['https://cdn.com/ad_component_of_bid',
                   'https://cdn.com/next_ad_component_of_bid',
                   ...],
  'biddingDurationMsec': 12,
  'bidCurrency': 'USD', /* bidCurrency returned by generateBid, or '???' if none */
  'dataVersion': 1, /* Data-Version value from the trusted scoring signals server's response */
}

reportResult()

Un vendedor debe definir una función reportResult() que se entrega desde un extremo que posee. El extremo se especifica en la configuración de subasta que el decisionLogicUrl. La función reportResult() tiene lo siguiente: firma:

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

Los parámetros reportResult() son los siguientes:

  • auctionConfig, que es la configuración de la subasta que se usa para ejecutarla
  • browserSignals, que es un objeto que construye el navegador, y que incluye lo siguiente: información que el navegador conoce y cuál es la secuencia de comandos de subasta del vendedor que deseas verificar. Este es el mismo objeto que se pasa a la función scoreAds().

reportResult() muestra signalsForWinner, que es un objeto JSON arbitrario. que se pasa a la función de informes del comprador ganador. Esto debe incluir cualquier información relevante que el vendedor pueda proporcionar sobre la subasta que el comprador necesarios para sus informes.

Ejecuta una subasta de la API de Protected Audience

Hay cuatro pasos principales que debe seguir un vendedor para realizar una subasta. Ten en cuenta que estos En los pasos, se supone que el vendedor tiene configurado un extremo para devolver el código JavaScript necesario. antes mencionadas en esta guía.

  1. Configura la subasta. Este paso incluye la creación de un objeto auctionConfig. Esto permite al vendedor especificar qué comprador debe participar en el y proporcionan cualquier indicador que pueda ser relevante durante la oferta. o la puntuación de anuncios.
  2. Para ejecutar la subasta, llama a navigator.runAdAuction() y pasa el de configuración que creaste en el paso anterior. Esto inicia la cadena de compradores generar ofertas y, luego, calificar. El resultado final de este paso es un anuncio candidato que se puede renderizar para mostrar un anuncio.
  3. Renderiza el anuncio ganador en un marco vallado o iframe.
  4. Informa el resultado de la subasta. Hay una función, navigator.sendReportTo(), que iniciará el informe. El vendedor siempre recibir un informe de los resultados de la subasta. Solo el comprador que ganó la subasta recibirán un informe. Se usa el reportResult() del vendedor que se describió anteriormente de esta guía para informar a su servidor.