Protected Audience API की नीलामी के नतीजों की रिपोर्ट

Protected Audience API से जुड़ी नीलामी की रिपोर्ट जनरेट करने के लिए, सेलर और खरीदार की गाइड.

इस लेख में, Protected Audience API की नीलामी की जीत से जुड़ी रिपोर्ट जनरेट करने के बारे में तकनीकी जानकारी दी गई है. इसका इस्तेमाल एक्सपेरिमेंट के तौर पर शुरू किए गए Protected Audience API के मौजूदा वर्शन में किया गया है.

Protected Audience API की पूरी लाइफ़साइकल के बारे में जानने के लिए, डेवलपर गाइड पढ़ें. साथ ही, इवेंट-लेवल की रिपोर्टिंग (कुछ समय के लिए) के बारे में गहराई से चर्चा करने के लिए, Protected Audience API की जानकारी देखें.

क्या आप डेवलपर नहीं हैं? Protected Audience API API की खास जानकारी देखें.

Protected Audience API की रिपोर्ट क्या होती है?

Protected Audience API की रिपोर्ट दो तरह की होती हैं:

  • सेलर की रिपोर्ट: इससे सेलर को विज्ञापन नीलामी के विजेता के बारे में जानकारी मिलती है.
  • खरीदार की रिपोर्ट: यह सिर्फ़ जीतने वाले खरीदारों को उपलब्ध होती है, ताकि उन्हें पता चल सके कि उन्होंने नीलामी जीती है.

लंबे समय की योजना यह है कि ब्राउज़र को Private एग्रीगेशन API API का इस्तेमाल करके, सेलर और खरीदारों के लिए नीलामी के नतीजे रिपोर्ट करने दें. कुछ समय के लिए, इवेंट-लेवल पर रिपोर्टिंग उपलब्ध कराने के कुछ समय के लिए, सेलर के लिए reportResult() को लागू करने वाला कोड और जीतने वाली बिडर के लिए reportWin() लागू करने वाला कोड, sendReportTo() फ़ंक्शन को कॉल कर सकता है. इसमें एक तर्क दिया जाता है: नीलामी पूरी होने के बाद फ़ेच किए जाने वाले यूआरएल को दिखाने वाली स्ट्रिंग, जो इवेंट लेवल की जानकारी को रिपोर्ट करने के लिए कोड में बदल देती है.

एपीआई फ़ंक्शन

सेलर: reportResult()

नीलामी के नतीजे की रिपोर्ट करने के लिए, decisionLogicUrl में दिए गए सेलर के JavaScript (जो scoreAd() भी उपलब्ध कराता है) में एक reportResult() फ़ंक्शन शामिल हो सकता है.

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

इस फ़ंक्शन में पास किए जाने वाले आर्ग्युमेंट, ये हैं:

auctionConfig

नीलामी कॉन्फ़िगरेशन ऑब्जेक्ट navigator.runAdAuction() को पास किया गया.

browserSignals

नीलामी के बारे में जानकारी देने वाले ब्राउज़र से बनाया गया ऑब्जेक्ट. उदाहरण के लिए:

  {
    'topWindowHostname': 'publisher.example',
    'interestGroupOwner': 'https://dsp.example',
    'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
    'bid': <bidValue>,
    'desirability': <winningAdScore>
  }

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

खरीदार: reportWin()

जीतने वाली बिडर का JavaScript (जिसमें generateBid() भी दिया गया है) नीलामी के नतीजे बताने के लिए, reportWin() फ़ंक्शन शामिल कर सकती है.

reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
  ...
}

इस फ़ंक्शन में पास किए जाने वाले आर्ग्युमेंट, ये हैं:

auctionSignals और perBuyerSignals

जीतने वाले बिडर के लिए, वही वैल्यू generateBid() को पास की गई हैं.

sellerSignals

reportResult() की रिटर्न वैल्यू, जिससे सेलर को खरीदार को जानकारी भेजने का मौका मिलता है.

browserSignals

नीलामी के बारे में जानकारी देने वाले ब्राउज़र से बनाया गया ऑब्जेक्ट. उदाहरण के लिए:

{
  'topWindowHostname': 'publisher.example',
  'seller': 'https://ssp.example',
  'interestGroupOwner': 'https://dsp.example',
  'interestGroupName': 'custom-bikes',
  'renderUrl': 'https://cdn.example/winning-creative.wbn',
  'bid': <bidValue>
}

कुछ समय के लिए रिपोर्टिंग लागू करना

कुछ समय के लिए, नीलामी की रिपोर्ट बनाने के लिए Chrome में दो तरीके उपलब्ध हैं:

  • forDebuggingOnly.reportAdAuctionLoss()
  • forDebuggingOnly.reportAdAuctionWin()

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

Chrome, डीबग लॉस/जीत की रिपोर्ट सिर्फ़ तब भेजता है, जब नीलामी पूरी हो जाती है. अगर कोई नीलामी रद्द हो जाती है (उदाहरण के लिए, नए नेविगेशन की वजह से), तो कोई रिपोर्ट जनरेट नहीं होगी.

chrome://settings/adPrivacy में विज्ञापन देखने वाले की निजता बनाए रखने से जुड़े सभी एपीआई चालू करने पर, Chrome में ये तरीके डिफ़ॉल्ट रूप से उपलब्ध होते हैं. अगर Protected Audience API को चालू करने के लिए, Chrome को कमांड लाइन फ़्लैग के साथ चलाया जा रहा है, तो आपको BiddingAndScoringDebugReportingAPI फ़्लैग को शामिल करके इन तरीकों को साफ़ तौर पर चालू करना होगा. अगर फ़्लैग चालू नहीं है, तो भी तरीके उपलब्ध होंगे, लेकिन कुछ नहीं करना होगा.

Protected Audience API से जुड़े सभी एपीआई के रेफ़रंस

एपीआई रेफ़रंस गाइड उपलब्ध हैं:

Protected Audience API के बारे में जानकारी देने वाला टूल , सुविधाओं के इस्तेमाल और पाबंदियों के बारे में भी जानकारी देता है.

आगे क्या करना है?

हम आपके साथ मिलकर ऐसा एपीआई बनाना चाहते हैं जो सभी के काम आ सके.

एपीआई पर चर्चा करें

दूसरे प्राइवसी सैंडबॉक्स एपीआई की तरह, इस एपीआई को भी दस्तावेज़ के तौर पर दिखाया जाता है और सार्वजनिक तौर पर इस पर चर्चा की जाती है.

एपीआई के साथ प्रयोग करें

Protected Audience API के बारे में बातचीत में, एक्सपेरिमेंट किया जा सकता है और इसमें हिस्सा लिया जा सकता है.