सुरक्षित ऑडियंस में प्रोग्रामैटिक बिडिंग के साथ Topics का इस्तेमाल करना

Protected Audience की बिडिंग और नीलामी की प्रोसेस के इनपुट के तौर पर, Topics की मदद से अपनी पसंद के विषयों को इस्तेमाल करने का तरीका जानें. सुरक्षित ऑडियंस के पास ऐसे कई पॉइंट होते हैं जहां खरीदार और सेलर, बिडिंग और नीलामी की प्रोसेस में पहले पक्ष के सिग्नल भेज सकते हैं. Topics की मदद से मिलने वाले सिग्नल का इस्तेमाल, बिडिंग और विज्ञापन चुनने की प्रोसेस के दौरान उपलब्ध डेटा को बेहतर बनाने के लिए किया जा सकता है. साथ ही, इसका इस्तेमाल मौजूदा उपयोगकर्ताओं की दिलचस्पियों के बारे में जानकारी देकर किया जा सकता है, जिससे विज्ञापन इन्वेंट्री की वैल्यू बढ़ सकती है.

इस गाइड को पढ़ने से पहले, पक्का करें कि आपको Topics और Protected Audience, दोनों के बारे में जानकारी हो.

विषय पाएं

Topics API को कॉल करते समय, कॉलर को उन विषयों के नाम दिखेंगे जिन्हें उन्होंने उस ब्राउज़र के लिए पहले देखा था.

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

इस मामले में: 310 "खेल/साइकल चलाना" को मैप करता है.

इन उदाहरणों में दिखाया गया है कि विषय की वैल्यू का इस्तेमाल सीधे तौर पर किया जा रहा है. हालांकि, पूरी तरह लागू करने पर, उन्हें प्रोसेस किया जा सकता है या दूसरे डेटा के साथ जोड़ा जा सकता है.

शर्तों के साथ एक रुचि समूह तय करने के लिए विषयों का इस्तेमाल करें

नतीजे मिलने वाले विषय का इस्तेमाल, किसी उपयोगकर्ता को एक इंटरेस्ट ग्रुप में जोड़ने के लिए सीधे तौर पर किया जा सकता है.

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

किसी इंटरेस्ट ग्रुप को खरीदारों के विषय उपलब्ध कराना

इंटरेस्ट ग्रुप बनाते समय, मौजूदा विषयों या उनसे प्रोसेस किए गए डेटा को userBiddingSignals में शामिल किया जा सकता है. इससे खरीदार को बिड करते समय विषयों का इस्तेमाल करने की सुविधा मिलती है.

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

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

नीलामी में सेलर के विषय उपलब्ध कराना

नीलामी को कॉन्फ़िगर करते समय, सेलर को दिखने वाले मौजूदा विषयों या उनसे प्रोसेस किए गए डेटा को auctionSignals, sellerSignals या perBuyerSignals के कॉम्बिनेशन में शामिल किया जा सकता है. इससे खरीदार, बिड करते समय विषयों का इस्तेमाल कर सकता है और सेलर, बिड को स्कोर करते समय विषयों का इस्तेमाल कर सकता है.

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

बोलियां बनाते समय विषयों का उपयोग करें

फिर खरीदार के generateBid() फ़ंक्शन को कॉल करने पर, पास किए गए रिकॉर्ड किए गए विषयों का इस्तेमाल बिडिंग में मदद करने के लिए, सिग्नल में दिए गए किसी भी अन्य डेटा की तरह किया जा सकता है. उदाहरण के लिए, इस custom-bikes इंटरेस्ट ग्रुप के साथ ज़्यादा बिड करने के लिए, बिडिंग करने वाला "खेल/साइकल" विषय की मौजूदगी का इस्तेमाल कर सकता है.

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

बोलियों को स्कोर करते समय विषयों का इस्तेमाल करें

बिडिंग के बाद, जब सेलर के scoreAd() फ़ंक्शन को कॉल किया जाता है, तब रिकॉर्ड किए गए विषयों का इस्तेमाल, नीलामी के कॉन्फ़िगरेशन से पास किए जाने वाले किसी भी अन्य डेटा की तरह किया जा सकता है. उदाहरण के लिए, हो सकता है कि सेलर, उन विज्ञापनों के लिए बिडिंग को ज़्यादा अहमियत देना चाहे जो पता लगाए गए विषयों से मेल खाते हों.

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