In einer Auktion bieten, um eine Anzeigenfläche zu kaufen

Als Anzeigenkäufer (DSPs und Werbetreibende) möchten Sie möglicherweise an einer Protected Audience-Anzeigenauktion auf der Publisher-Website teilnehmen, um eine Anzeige auf die Interessengruppe auszurichten, die Sie auf der Website des Werbetreibenden definiert haben. Wenn Sie an einer Protected Audience-Auktion teilnehmen, können Sie Ihre identifizierten Kunden datenschutzfreundlich auf anderen Websites erreichen.

Bei einer Protected Audience-Auktion geben Sie die Logik zum Generieren des Gebots an, die der Browser anhand dieser Logik berechnet. Dies steht im Gegensatz zu anderen Auktionsarchitekturen, bei denen Sie das Gebot direkt abgeben und nicht die Logik angeben.

Sie stellen die Logik für die Gebotsgenerierung in der JavaScript-Funktion generateBid() bereit und die Datei wird auf Ihrem Server gehostet. Wenn Sie einen Nutzer zu einer Interessengruppe hinzufügen, wird der Speicherort dieser Datei als biddingLogicUrl an die Interessengruppenkonfiguration übergeben.

Während der Auktion ruft der Browser die im Feld biddingLogicUrl angegebene Gebotslogik ab und führt die Funktion generateBid() für jede Interessengruppe in einer sicheren isolierten Umgebung aus, die durch die Kommunikation mit außenstehenden Kontext eingeschränkt ist. Wenn generateBid() ausgeführt wird, übergibt der Browser Signale als Argumente an die Funktion. Diese Signale enthalten verschiedene Informationen aus verschiedenen Quellen, z. B. selbst erhobene Daten des Publishers, Verkäuferdaten und Echtzeitdaten. Anhand dieser Signale können Sie das Gebot berechnen und der Wert wird vom generateBid()-Aufruf zurückgegeben. Nachdem die Gebote eingereicht wurden, führt der Browser bei jedem Gebot die Bewertungslogik des Verkäufers aus, um die Erwünschtheit des Verkäufers zu berechnen.

generateBid()

Im Folgenden werden die Argumente der generateBid()-Funktion und die Struktur des von der Funktion zurückgegebenen Gebots beschrieben:

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

Argumente

generateBid() verwendet die folgenden Argumente:

Browsersignale

Das browserSignals-Objekt hat die folgenden Eigenschaften:

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

Gebot berechnen

Für die Berechnung eines Gebotswerts kann der Code in generateBid() die Eigenschaften der Parameter der Funktion verwenden.

Beispiel:

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

Gebot zurückgeben

generateBid() gibt ein Objekt mit den folgenden Eigenschaften zurück: