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()

विक्रेता का JavaScript decisionLogicUrl में दिया गया है (जो 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>
  }

इस फ़ंक्शन की रिटर्न वैल्यू का इस्तेमालsellerSignals जीतने वाले बिडर का reportWin() फ़ंक्शन.

खरीदार: 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 के बारे में जानकारी देने वाला टूल , सुविधाओं के इस्तेमाल और पाबंदियों के बारे में भी जानकारी देता है.

What's next?

We want to engage in conversations with you to ensure we build an API that works for everyone.

Discuss the API

Like other Privacy Sandbox APIs, this API is documented and discussed publicly.

Experiment with the API

You can experiment and participate in conversation about the Protected Audience API.