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

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

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

बोली जनरेट करने वाला लॉजिक, 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() इन प्रॉपर्टी वाला कोई ऑब्जेक्ट दिखाता है: