Ustal stawkę w aukcji, aby kupić boks reklamowy

Jako kupujący reklamy (platformy DSP i reklamodawcy) możesz być zainteresowany udziałem w aukcji reklam z interfejsem Protected Audience API na stronie wydawcy, aby kierować reklamy na grupę zainteresowań zdefiniowaną na stronie reklamodawcy. Uczestnicząc w aukcji Protected Audience, możesz docierać do zidentyfikowanych klientów w innych witrynach w sposób zapewniający ochronę prywatności.

W aukcji Protected Audience podajesz logikę generowania stawki, a przeglądarka oblicza stawkę na podstawie tej logiki. W przeciwieństwie do innych architektur aukcji, w których przesyłasz stawkę bezpośrednio, a nie logikę.

Logikę generowania stawek podajesz w funkcji JavaScript generateBid(), a plik jest hostowany na Twoim serwerze. Gdy dodasz użytkownika do grupy zainteresowań, lokalizacja tego pliku zostanie przekazana do konfiguracji grupy zainteresowań jako biddingLogicUrl.

Podczas aukcji przeglądarka pobiera logikę określania stawek podaną w polu biddingLogicUrl i wykonuje funkcję generateBid() dla każdej grupy zainteresowań w bezpiecznym, odizolowanym środowisku, które ma ograniczoną komunikację z kontekstem zewnętrznym. Gdy funkcja generateBid() jest wykonywana, przeglądarka przekazuje do niej sygnały jako argumenty. Sygnały te zawierają różne informacje z różnych źródeł, np. dane własne wydawcy, dane sprzedawcy, dane w czasie rzeczywistym i inne. Możesz używać tych sygnałów do obliczania stawki, a wartość jest zwracana przez wywołanie generateBid(). Po przesłaniu stawek przeglądarka wykona logikę oceny sprzedawcy dla każdej stawki, aby obliczyć wynik atrakcyjności sprzedawcy.

generateBid()

Poniżej znajdziesz opis argumentów funkcji generateBid() i struktury stawki zwracanej przez tę funkcję:

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)
  };
}

Argumenty

generateBid() przyjmuje te argumenty:

Sygnały przeglądarki

Obiekt browserSignals ma te właściwości:

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

Obliczanie stawki

Aby obliczyć wartość stawki, kod w generateBid() może używać właściwości parametrów funkcji.

Na przykład:

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

Zwracanie stawki

generateBid() zwraca obiekt z tymi właściwościami: