Ofertar 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 al grupo de interés que definiste en el sitio del anunciante. Si participas en la subasta de Protected Audience, puedes llegar a tus clientes identificados en otros sitios de una manera que preserva la privacidad.

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

Proporcionas la 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 la función generateBid() para cada grupo de interés en un entorno aislado seguro que está limitado en su comunicación con el contexto externo. Cuando se ejecuta generateBid(), el navegador pasa señales a la función como argumentos. Estos indicadores contienen información variada de distintas fuentes, como datos de origen del publicador, datos del vendedor, datos en tiempo real y mucho más. Puedes usar estos indicadores para calcular la oferta, y la llamada a generateBid() devuelve el valor. Después de que se envíen las ofertas, el navegador ejecutará la lógica de puntuación del vendedor en cada oferta para calcular la puntuación de deseabilidad del vendedor.

generateBid()

A continuación, se describen los argumentos de la función generateBid() y la estructura de la oferta que muestra 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 el valor de una oferta, el código de 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,
    // ...
  }
}

Cómo devolver una oferta

generateBid() muestra un objeto con las siguientes propiedades: