विज्ञापन स्लॉट खरीदने के लिए नीलामी में बिड करना

विज्ञापन खरीदार (डीएसपी और विज्ञापन देने वाले) के तौर पर, हो सकता है कि आप पब्लिशर साइट पर Protected Audience विज्ञापन नीलामी में हिस्सा लेना चाहें. ऐसा इसलिए, ताकि आप विज्ञापन को उस इंटरेस्ट ग्रुप को टारगेट कर सकें जिसे आपने विज्ञापन देने वाले की साइट पर तय किया है. Protected Audience नीलामी में हिस्सा लेकर, निजता बनाए रखते हुए अन्य साइटों पर अपने पहचाने गए ग्राहकों तक पहुंचा जा सकता है.

Protected Audience नीलामी में, बिड जनरेट करने के लिए लॉजिक दिया जाता है. इसके बाद, ब्राउज़र उस लॉजिक का इस्तेमाल करके बिड का हिसाब लगाता है. यह नीलामी के अन्य आर्किटेक्चर से अलग है, जहां लॉजिक देने के बजाय सीधे बिड सबमिट की जाती है.

generateBid() JavaScript फ़ंक्शन में बिड जनरेशन लॉजिक दिया जाता है और फ़ाइल को आपके सर्वर पर होस्ट किया जाता है. किसी उपयोगकर्ता को इंटरेस्ट ग्रुप में जोड़ने पर, इस फ़ाइल की जगह को इंटरेस्ट ग्रुप कॉन्फ़िगरेशन में biddingLogicUrl के तौर पर पास किया जाता है.

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

generateBid()

यहां generateBid() फ़ंक्शन के आर्ग्युमेंट और फ़ंक्शन से वापस मिलने वाली बिड के स्ट्रक्चर के बारे में बताया गया है:

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals, directFromSellerSignals) {
  return {
    ad: adObject,
    adCost: optionalAdCost,
    bid: bidValue,
    bidCurrency: 'USD',
    render: {
      url: renderURL,
      width: renderWidth,
      height: renderHeight
    },
    adComponents: [
      {url: adComponent1, width: componentWidth1, height: componentHeight1},
      {url: adComponent2, width: componentWidth2, height: componentHeight2},
      // ...
    ],
    allowComponentAuction: false,
    modelingSignals: 123 // 0-4095 integer (12-bits)
  };
}

तर्क

generateBid() में ये आर्ग्युमेंट इस्तेमाल किए जाते हैं:

ब्राउज़र से मिलने वाले सिग्नल

browserSignals ऑब्जेक्ट में ये प्रॉपर्टी होती हैं:

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  topLevelSeller: 'https://www.top-level-ssp.com',
  requestedSize: {width: 100, height: 200},  /* if specified in auction config */
  joinCount: 3,
  recency: 3600000,
  bidCount: 17,
  prevWinsMs: [[timeDeltaMs1,ad1],[timeDeltaMs2,ad2],...],
  wasmHelper: ...
  dataVersion: 1,
  adComponentsLimit: 40
}

बिड का हिसाब लगाना

बिड वैल्यू का हिसाब लगाने के लिए, generateBid() में मौजूद कोड, फ़ंक्शन के पैरामीटर की प्रॉपर्टी का इस्तेमाल कर सकता है.

उदाहरण के लिए:

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
   //  ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    // ...
  }
}

बिड लौटाना

generateBid(), इन प्रॉपर्टी वाला ऑब्जेक्ट दिखाता है: