Lance em um leilão para comprar um espaço de anúncio

Como um comprador de anúncios (DSPs e anunciantes), talvez você tenha interesse em participar de um leilão de anúncios com Protected Audience no site do editor para segmentar um anúncio ao grupo de interesse definido no site do anunciante. Ao participar do leilão da Protected Audience, você alcança os clientes identificados em outros sites sem comprometer a privacidade.

Em um leilão com Protected Audience, você fornece a lógica para gerar o lance, e o navegador calcula o lance usando essa lógica. Isso é diferente de outras arquiteturas de leilão, em que você envia o lance diretamente, em vez de fornecer a lógica.

Você fornece sua lógica de geração de lances na função JavaScript generateBid(), e o arquivo fica hospedado no seu servidor. Quando você adiciona um usuário a um grupo de interesse, a localização desse arquivo é transmitida para a configuração do grupo de interesse como um biddingLogicUrl.

Durante o leilão, o navegador busca sua lógica de lances especificada no campo biddingLogicUrl e executa a função generateBid() para cada grupo de interesse em um ambiente isolado seguro, limitado na comunicação com contexto externo. Quando generateBid() é executado, o navegador transmite os indicadores para a função como argumentos. Esses indicadores contêm várias informações de diferentes fontes, como dados próprios do editor, do vendedor, em tempo real e muito mais. Você pode usar esses indicadores para calcular o lance, e o valor é retornado da chamada generateBid(). Depois que os lances são enviados, o navegador executa a lógica de pontuação do vendedor em cada lance para calcular a pontuação de atratividade do vendedor.

generateBid()

Veja a seguir a descrição dos argumentos da função generateBid() e da estrutura do lance retornado por ela:

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() usa os seguintes argumentos:

Indicadores do navegador

O objeto browserSignals tem as seguintes propriedades:

{
  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
}

Calcular um lance

Para calcular um valor de lance, o código no generateBid() pode usar as propriedades dos parâmetros da função.

Exemplo:

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

Retornar um lance

generateBid() retorna um objeto com as seguintes propriedades: