Oferta en una subasta para comprar un espacio publicitario

Como comprador de anuncios (DSP y anunciantes), es posible que te interese participar en una subasta de anuncios de Protected Audience en el sitio del publicador para segmentar un anuncio para el grupo de interés que definiste en el sitio del anunciante. Si participas en la subasta de Protected Audience, podrás llegar a tus clientes identificados en otros sitios de una manera que preserva la privacidad.

En una subasta de Protected Audience, proporcionas la lógica para generar la oferta, y el navegador la calcula con esa lógica. Esto contrasta con otras arquitecturas de subastas en las que envías la oferta directamente en lugar de proporcionar la lógica.

Proporcionas tu lógica de generación de ofertas en la función generateBid() de JavaScript, y el archivo se aloja en tu servidor. Cuando agregas un usuario a un grupo de interés, la ubicación de este archivo se pasa a la configuración del grupo de interés como un biddingLogicUrl.

Durante la subasta, el navegador recupera la lógica de ofertas que especificaste en el campo biddingLogicUrl y ejecuta tu función generateBid() para cada grupo de interés en un entorno aislado seguro que tiene una comunicación limitada con el contexto externo. Cuando se ejecuta generateBid(), el navegador pasa indicadores a la función como argumentos. Estos indicadores contienen diversa información de diferentes fuentes, como los datos de origen del publicador, los datos del vendedor, los datos en tiempo real y mucho más. Puedes usar estos indicadores para calcular la oferta, y el valor se devuelve desde la llamada a generateBid(). Después de que se envían las ofertas, el navegador ejecutará la lógica de puntuación del vendedor en cada oferta para calcular la puntuación de conveniencia del vendedor.

generateBid()

A continuación, se describen los argumentos de la función generateBid() y la estructura de la oferta que devuelve la función:

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals, directFromSellerSignals) {
  return {
    ad: adObject,
    adCost: optionalAdCost,
    bid: bidValue,
    bidCurrency: 'USD',
    render: {
      url: renderURL,
      width: renderWidth,
      height: renderHeight
    },
    adComponents: [
      {url: adComponent1, width: componentWidth1, height: componentHeight1},
      {url: adComponent2, width: componentWidth2, height: componentHeight2},
      // ...
    ],
    allowComponentAuction: false,
    modelingSignals: 123 // 0-4095 integer (12-bits)
  };
}

Argumentos

generateBid() toma los siguientes argumentos:

Indicadores del navegador

El objeto browserSignals tiene las siguientes propiedades:

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  topLevelSeller: 'https://www.top-level-ssp.com',
  requestedSize: {width: 100, height: 200},  /* if specified in auction config */
  joinCount: 3,
  recency: 3600000,
  bidCount: 17,
  prevWinsMs: [[timeDeltaMs1,ad1],[timeDeltaMs2,ad2],...],
  wasmHelper: ...
  dataVersion: 1,
  adComponentsLimit: 40
}

Cómo calcular una oferta

Para calcular un valor de oferta, el código en generateBid() puede usar las propiedades de los parámetros de la función.

Por ejemplo:

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
   //  ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    // ...
  }
}

Devuelve una oferta

generateBid() devuelve un objeto con las siguientes propiedades: