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

Como comprador de anúncios (DSPs e anunciantes), talvez você tenha interesse em participar de um leilão de anúncios da API 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 API Protected Audience, você pode alcançar seus clientes identificados em outros sites de maneira que preserve a privacidade.

Em um leilão da API 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 a lógica de geração de lances na função JavaScript generateBid(), e o arquivo é hospedado no seu servidor. Quando você adiciona um usuário a um grupo de interesse, o local desse arquivo é transmitido 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 sua função generateBid() para cada grupo de interesse em um ambiente isolado seguro, que tem comunicação limitada com o contexto externo. Quando generateBid() é executado, o navegador transmite sinais para a função como argumentos. Esses indicadores contêm várias informações de diferentes fontes, como dados próprios do editor, dados do vendedor, dados 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 conveniência do vendedor.

generateBid()

A seguir, descrevemos os argumentos da função generateBid() e a 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 em 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: