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 tempat 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 sudah memahami Topik dan Audiens yang Dilindungi.

Dapatkan topik

Saat memanggil Topics API, pemanggil akan melihat pilihan topik yang sebelumnya telah 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 topik ini: 310 dipetakan ke "Olahraga/Bersepeda".

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

Menggunakan topik untuk menentukan grup minat secara bersyarat

Topik yang dihasilkan dapat digunakan 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. Ini memungkinkan pembeli menggunakan topik saat membuat 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 dapat dilihat 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 untuk 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 membuat bid

Kemudian saat fungsi generateBid() pembeli dipanggil, topik yang dicatat yang diteruskan dapat digunakan (seperti data lain yang diberikan dalam sinyal) untuk membantu dalam bidding. Misalnya, bidder dapat menggunakan kehadiran topik "Olahraga/Bersepeda" untuk mengajukan bid yang 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.
}

Menggunakan topik saat menilai bid

Setelah melakukan bidding saat fungsi scoreAd() penjual dipanggil, topik yang dicatat dapat digunakan seperti data lain yang diteruskan dari konfigurasi lelang. Misalnya, penjual mungkin ingin mempertimbangkan bid 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
  //...
}