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

Protected Audience से जुड़ी बिडिंग और नीलामी की प्रोसेस के इनपुट के तौर पर, Topics से जुड़ी दिलचस्पियों का इस्तेमाल करने का तरीका जानें. Protected Audience में ऐसी कई जगहें हैं जहां खरीदार और सेलर, बिडिंग और नीलामी की प्रोसेस में पहले-पक्ष के सिग्नल पास कर सकते हैं. 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
  //...
}