Topics mit programmatischen Geboten in Protected Audience verwenden

Hier erfahren Sie, wie Sie Interessen aus Topics als Input für Protected Audience-Gebote und den Auktionsprozess verwenden können. Bei Protected Audience gibt es mehrere Punkte, an denen Käufer und Verkäufer möglicherweise eigene Signale in den Gebots- und Auktionsprozess übergeben. Die von Topics bereitgestellten Signale können verwendet werden, um die während der Gebots- und Anzeigenauswahl verfügbaren Daten mit Informationen zu aktuellen Nutzerinteressen zu ergänzen, um den potenziellen Wert des Anzeigeninventars zu erhöhen.

Bevor Sie diesen Leitfaden lesen, sollten Sie sich mit Topics und Protected Audience vertraut machen.

Themen abrufen

Beim Aufrufen der Topics API sieht der Aufrufer eine Auswahl der Themen, die er zuvor für diesen Browser beobachtet hat.

const currentTopics = await document.browsingTopics();
// Example result
[
  {
    "configVersion": "chrome.2",
    "modelVersion": "4",
    "taxonomyVersion": "2",
    "topic": 310,
    "version": "chrome.2:2:4"
  }
]

In diesem Fall ist das Thema 310 „Sport/Radfahren“ zugeordnet.

Diese Beispiele zeigen, wie die Themenwerte direkt verwendet werden. Bei einer vollständigen Implementierung können sie jedoch verarbeitet oder mit anderen Daten kombiniert werden.

Interessengruppen mithilfe von Themen bedingt definieren

Das daraus resultierende Thema kann direkt verwendet werden, um einen Nutzer zu einer Interessengruppe hinzuzufügen.

if (currentTopics[0].topic === 310) { // Interest in "Sports/Cycling"
  const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  }
}

Käuferthemen für eine Interessengruppe bereitstellen

Die aktuellen Themen (oder die daraus verarbeiteten Daten) können beim Erstellen der Interessengruppe in die userBiddingSignals aufgenommen werden. So kann der Käufer Themen für Gebote verwenden.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  userBiddingSignals: {
    topics: currentTopics,
    ....
  },
  ...
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

Verkäuferthemen für eine Auktion bereitstellen

Die aktuellen für den Verkäufer sichtbaren Themen oder die daraus verarbeiteten Daten können bei der Konfiguration der Auktion in einer Kombination aus auctionSignals, sellerSignals oder perBuyerSignals enthalten sein. So können sowohl der Käufer bei der Abgabe von Geboten Themen verwenden als auch der Verkäufer Themen für die Gebotsbewertung verwenden.

const myAuctionConfig = {
  seller: 'https://ssp.example',
  auctionSignals: {
    topics: currentTopics,
  },
  sellerSignals: {
    topics: currentTopics,
  },
  perBuyerSignals: {
    'https://dsp.example': {
      topics: currentTopics,
      // ...
    },
    // ...
  },
  // ...
};
const result = await navigator.runAdAuction(myAuctionConfig);

Themen beim Festlegen von Geboten verwenden

Wenn dann die generateBid()-Funktion des Käufers aufgerufen wird, können die übergebenen erfassten Themen wie alle anderen in den Signalen bereitgestellten Daten für Gebote verwendet werden. Der Bieter könnte z. B. das Vorhandensein der Spalte „Sport/Radfahren“ verwenden. Thema, um mit dieser Interessengruppe "custom-bikes" ein höheres Gebot abzugeben.

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  const topics = interestGroup.userBiddingSignals.topics;
  // Use the topic values in the bidding logic.
}

Themen beim Ermitteln von Geboten verwenden

Nachdem die scoreAd()-Funktion des Verkäufers aufgerufen wird, können die erfassten Themen wie alle anderen Daten verwendet werden, die bei der Auktionskonfiguration übergeben werden. Beispielsweise möchte der Verkäufer Gebote für Anzeigen, die mit erkannten Themen übereinstimmen, höher gewichten.

scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals, directFromSellerSignals) {
  const sellerTopics = actionConfig.auctionSignals.topics;
  // or corresponding key in sellerSignals
  // use the topics values to score the ads
  //...
}