Fare un'offerta in un'asta per acquistare uno spazio pubblicitario

In qualità di acquirente di annunci (DSP e inserzionisti), potresti essere interessato a partecipare a un'asta di annunci Protected Audience sul sito del publisher per scegliere come target un annuncio per il gruppo di interesse che hai definito sul sito dell'inserzionista. Partecipando all'asta Protected Audience, puoi raggiungere i tuoi clienti identificati su altri siti in modo da tutelare la privacy.

In un'asta Protected Audience, fornisci la logica per generare l'offerta e il browser la calcola utilizzando questa logica. Ciò è in contrasto con altre architetture dell'asta in cui invii l'offerta direttamente anziché fornire la logica.

Fornisci la logica di generazione delle offerte nella funzione JavaScript generateBid() e il file è ospitato sul tuo server. Quando aggiungi un utente a un gruppo di interesse, la posizione di questo file viene trasferita nella configurazione del gruppo di interesse come biddingLogicUrl.

Durante l'asta, il browser recupera la logica di offerta specificata nel campo biddingLogicUrl ed esegue la funzione generateBid() per ogni gruppo di interesse in un ambiente isolato sicuro che ha una comunicazione limitata con il contesto esterno. Quando viene eseguito generateBid(), il browser passa i segnali alla funzione come argomenti. Questi indicatori contengono varie informazioni provenienti da diverse fonti, come i dati proprietari del publisher, i dati del venditore, i dati in tempo reale e altro ancora. Puoi utilizzare questi indicatori per calcolare l'offerta e il valore viene restituito dalla chiamata generateBid(). Una volta inviate le offerte, il browser esegue la logica di assegnazione del punteggio del venditore su ciascuna offerta per calcolare il punteggio di desiderabilità del venditore.

generateBid()

Di seguito vengono descritti gli argomenti della funzione generateBid() e la struttura dell'offerta restituita dalla funzione:

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

Argomenti

generateBid() accetta i seguenti argomenti:

Indicatori del browser

L'oggetto browserSignals ha le seguenti proprietà:

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

Calcolare un'offerta

Per calcolare un valore di offerta, il codice in generateBid() può utilizzare le proprietà dei parametri della funzione.

Ad esempio:

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

Restituire un'offerta

generateBid() restituisce un oggetto con le seguenti proprietà: