Menggunakan Topik dengan bidding terprogram di Protected Audience

Pelajari cara menggunakan minat dari Topics sebagai input untuk proses bidding dan lelang Protected Audience. Protected Audience memiliki beberapa titik saat pembeli dan penjual dapat meneruskan sinyal pihak pertama ke dalam proses bidding dan lelang. Sinyal yang diberikan oleh Topics dapat digunakan untuk memperkaya data yang tersedia selama proses bidding dan pemilihan iklan dengan informasi tentang minat pengguna saat ini yang meningkatkan potensi nilai inventaris iklan.

Sebelum membaca panduan ini, pastikan Anda telah memahami Topik dan Audiens yang Dilindungi.

Dapatkan topik

Saat memanggil Topics API, pemanggil akan melihat pilihan topik yang sebelumnya mereka amati untuk browser tersebut.

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

Dalam hal ini topik: 310 dipetakan ke "Olahraga/Bersepeda".

Contoh ini menunjukkan nilai topik yang digunakan secara langsung, tetapi penerapan penuh dapat memilih untuk memproses atau menggabungkannya dengan data lain.

Menggunakan topik untuk menentukan grup minat secara bersyarat

Topik yang dihasilkan dapat digunakan secara langsung untuk memilih menambahkan pengguna ke grup minat.

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

Memberikan topik pembeli ke grup minat

Topik saat ini (atau data yang diproses) dapat disertakan dalam userBiddingSignals saat membuat grup minat. Hal ini memungkinkan pembeli menggunakan topik saat melakukan bid.

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

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

Menyediakan topik penjual ke lelang

Topik saat ini yang terlihat oleh penjual (atau data yang diproses dari topik tersebut) dapat disertakan dalam kombinasi auctionSignals, sellerSignals, atau perBuyerSignals saat mengonfigurasi lelang. Hal ini memungkinkan pembeli menggunakan topik saat membuat bid dan penjual menggunakan topik saat menilai bid.

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

Menggunakan topik saat melakukan bid

Kemudian, saat fungsi generateBid() pembeli dipanggil, topik yang dicatat yang diteruskan dapat digunakan (seperti data lain yang diberikan dalam sinyal) untuk membantu bidding. Misalnya, bidder dapat menggunakan tampilan "Olahraga/Bersepeda" topik untuk mengajukan bid lebih tinggi dengan grup minat custom-bikes ini.

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

Gunakan topik saat menilai bid

Setelah melakukan bidding saat fungsi scoreAd() penjual dipanggil, topik yang direkam dapat digunakan seperti data lain yang diteruskan dari konfigurasi lelang. Misalnya, penjual mungkin ingin memberi bobot pada bid yang lebih tinggi untuk iklan yang cocok dengan topik yang terdeteksi.

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
  //...
}