सुरक्षित ऑडियंस के लिए डीबग रिपोर्टिंग

सुरक्षित ऑडियंस की डीबग रिपोर्टिंग की मदद से, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा के डेवलपर रिमोट ऐक्सेस के बारे में एलान कर सकते हैं नीलामी जीतने या हार जाने पर, डिवाइसों से जीईटी अनुरोध पाने वाले यूआरएल. यह इस्तेमाल के इन उदाहरणों को चालू करता है:

  • जीतने और हारने के लिए नीलामी के नतीजों की रिपोर्ट पाएं.
  • जानें कि नीलामियां क्यों नहीं होती हैं. उदाहरण के लिए: समझें कि क्या यह कोई समस्या है बिडिंग या स्कोरिंग स्क्रिप्ट लागू करने या मुख्य लॉजिक से जुड़ी समस्या हो सकती है.
  • JavaScript लॉजिक के अपडेट होने पर आने वाली समस्याओं का पता लगाना

प्राइवसी सैंडबॉक्स में, इवेंट-लेवल की डीबग रिपोर्ट की जांच करने की सुविधा उपलब्ध है डेवलपर प्रीव्यू 9. डीबग रिपोर्टिंग की सुविधा उन सभी डिवाइसों पर काम करती है जिनमें AdId मौजूद है उपलब्ध हैं.

लंबे समय के लिए यह प्लान बनाया गया है कि प्लैटफ़ॉर्म, नीलामी के नतीजों को निजी एग्रीगेशन सेवा. इससे यह पक्का होता है कि तथ्यों के आधार पर की जाने वाली रिपोर्टिंग का इस्तेमाल अलग-अलग उपयोगकर्ताओं की कस्टम ऑडियंस में शामिल होने के लिए नहीं किया जा सकता. ऐप्लिकेशन पर पब्लिश किया जा सकता है. इवेंट-लेवल की रिपोर्टिंग कुछ समय के लिए होती है. यह तब तक होती है, जब तक सही तरीके से रिपोर्टिंग नहीं की जाती फ़्रेमवर्क रिलीज़ किया जाता है.

Chrome के ओरिजनल FLEDGE ऑरिजिन ट्रायल में डीबग रिपोर्टिंग के बारे में ज़्यादा जानें प्रस्ताव.

इस्तेमाल

डीबग रिपोर्टिंग को इन दोनों JavaScript API का इस्तेमाल करके लागू किया जाता है जो यूआरएल स्ट्रिंग तर्क को स्वीकार करते हैं:

  • forDebuggingOnly.reportAdAuctionWin(String url)
  • forDebuggingOnly.reportAdAuctionLoss(String url)

नीचे दिए गए उदाहरण में, जीतने वाली बिड के साथ विज्ञापन नीलामी में हार की जानकारी दी गई है और इंटरनल वैरिएबल. इसके बाद, इस डेटा का इस्तेमाल डीबग करने के लिए किया जा सकता है.

let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);

${winningBid} टेंप्लेट को नीलामी पूरी हो गई है.

विक्रेता अपने scoreAds फ़ंक्शन से वैकल्पिक रूप से rejectReason लौटा सकते हैं:

function scoreAd(ad, bid, auction_config, seller_signals,
                 trusted_scoring_signals, contextual_signal,
                 custom_audience_signal) {
  let score = ...
  return {
    'status': 0,
    'score': score,
    'rejectReason': 'blocked-by-publisher'
  }
}

अगर विक्रेता अस्वीकार किए जाने की वजह सेट नहीं करता है, तो not-available भेजा जाता है आज़माएं.

यूआरएल वैरिएबल

डीबग यूआरएल में जोड़े जा सकने वाले वैरिएबल मिलते-जुलते वर्शन (हालांकि ${topLevelWinningBid} और ${topLevelMadeWinningBid} उपलब्ध नहीं हैं, क्योंकि कॉम्पोनेंट का कोई कॉन्सेप्ट नहीं है नीलामियां होती हैं).

वैरिएबल का नाम जानकारी
winningBid जीतने वाली बिड की वैल्यू.
madeWinningBid एक बूलियन वैल्यू, जिससे पता चलता है कि इस कस्टम का खरीदार है या नहीं इस कस्टम ऑडियंस या किसी अन्य ऑडियंस के ज़रिए बिड जीतने वाली ऑडियंस ने एक ही खरीदार वाली कस्टम ऑडियंस चुनें.
highestScoringOtherBid उस बोली का मान जिसे दूसरी सबसे ज़्यादा राशि के रूप में विक्रेता के ScoreAd स्क्रिप्ट. ध्यान दें कि यह दूसरी सबसे ऊंची बोली नहीं हो सकती वैल्यू सेट की गई है, क्योंकि स्कोर और बिड अलग-अलग हो सकती हैं.
madeHighestScoringOtherBid बूलियन वैल्यू से पता चलता है कि खरीदार इस कस्टम ऑडियंस का इस्तेमाल करता है या नहीं इस कस्टम के आधार पर ${highestScoringOtherBid} बोली लगाई ऑडियंस या अन्य कस्टम ऑडियंस, दोनों में से एक ही खरीदार हो.
rejectReason विक्रेता की ओर से सेट की गई स्ट्रिंग जिसमें बताया जाता है कि उन्होंने बोली. इनमें से कोई भी वैल्यू हो सकती है:

  • not-available
  • invalid-bid
  • bid-below-auction-floor
  • pending-approval-by-exchange
  • disapproved-by-exchange
  • blocked-by-publisher
  • language-exclusions
  • category-exclusions

कंस्ट्रेंट

  • यूआरएल होस्ट, रजिस्टर किए गए प्राइवसी सैंडबॉक्स के डोमेन से मेल खाना चाहिए.
  • यूआरएल में 4,096 से ज़्यादा वर्ण नहीं होने चाहिए. इसमें डोमेन, https:// भी शामिल है प्रीफ़िक्स, और बदला गया नीलामी डेटा.
  • आगे आने वाली रिलीज़ में, डीबग पिंग सिर्फ़ वाई-फ़ाई से कनेक्ट होने पर भेजे जाएंगे.

डिवाइस पर व्यवहार

मोबाइल प्लैटफ़ॉर्म में, मेमोरी और नेटवर्क के इस्तेमाल को सुरक्षित रखना हमारी प्राथमिकता है. इसलिए, डीबग रिपोर्ट अलग-अलग बैच में होती हैं.

यहां दी गई सिस्टम प्रॉपर्टी, बैच रेट और साइज़ को कंट्रोल करती हैं. इन्हें डेवलपमेंट के लिए कम वैल्यू पर सेट किया गया:

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

नीलामी के बाद, डीबग रिपोर्ट में 15 से 60 मिनट लग सकते हैं पूरा हो गया.

डीबग रिपोर्ट के पूरा होने की कोई गारंटी नहीं है. अगर डिवाइस सर्वर को कॉल भेजे जाने से पहले, डिवाइस फिर से चालू होता है या adservices की प्रोसेस बंद हो जाती है, ये इवेंट छोड़ दिए जाते हैं.

हर विज्ञापन टेक्नोलॉजी में, हर नीलामी के लिए रजिस्टर किए गए 75 डीबग यूआरएल की ज़्यादा से ज़्यादा सीमा होती है. यूआरएल तय सीमा पूरी होने के बाद, रजिस्टर करने वाले लोगों को चुपचाप हटा दिया जाता है.

आखिर में, अगर उपयोगकर्ता ने AdId बंद कर दिया है, तो डीबग रिपोर्ट भेजी जाती है. यह डेवलपर प्रीव्यू 9 में लागू नहीं किया गया है, लेकिन इसे आने वाले समय में लागू किया जाएगा वर्शन हैं.

AdTech सर्वर के व्यवहार की सेटिंग

डीबग रिपोर्टिंग के लिए, AdTech सर्वर में ये काम होने चाहिए:

  • डिवाइस उस सर्वर को GET अनुरोध भेजता है जिसे आप forDebuggingOnly.* एपीआई.
  • हर अनुरोध, एक इवेंट-लेवल की डीबग रिपोर्ट को दिखाता है: एक विज्ञापन नीलामी जीतने या नीलामी में नुकसान.
  • हर अनुरोध का कोई मुख्य हिस्सा नहीं होता. सारा डेटा, क्वेरी पैरामीटर में मौजूद होता है.
  • ज़्यादा रिस्पॉन्स वाले पेलोड से परफ़ॉर्मेंस और डेटा के इस्तेमाल पर बुरा असर पड़ सकता है. नज़रअंदाज़ किए जाते हैं.