एट्रिब्यूशन रिपोर्टिंग को डीबग करने के बारे में तीन में से पहला लेख. जानें कि डीबग करना क्यों ज़रूरी है और टेस्टिंग में डीबग रिपोर्ट का इस्तेमाल कब करना चाहिए.
आपको डीबग रिपोर्ट की ज़रूरत क्यों है
अगर एट्रिब्यूशन रिपोर्टिंग एपीआई की जांच की जा रही है, तो आपको यह देखना चाहिए कि आपका इंटिग्रेशन सही तरीके से काम कर रहा है या नहीं. साथ ही, कुकी पर आधारित लागू करने के तरीके और एट्रिब्यूशन रिपोर्टिंग लागू करने के तरीके के बीच मेज़रमेंट के नतीजों में अंतर को समझना चाहिए. इसके अलावा, अपने इंटिग्रेशन से जुड़ी किसी भी समस्या को हल करना चाहिए.
इन टास्क को पूरा करने के लिए, डीबग रिपोर्ट की ज़रूरत होती है. इसलिए, हमारा सुझाव है कि आप इन्हें सेट अप करें.
शब्दावली
डीबग रिपोर्ट के मुख्य पहलू
डीबग रिपोर्ट के दो टाइप
डीबग रिपोर्ट दो तरह की होती हैं. दोनों का इस्तेमाल करें, क्योंकि ये अलग-अलग इस्तेमाल के उदाहरणों को पूरा करते हैं.
सफलता की डीबग रिपोर्ट
सफलता की डीबग रिपोर्ट, एट्रिब्यूशन रिपोर्ट के जनरेट होने की जानकारी ट्रैक करती हैं. ये सीधे तौर पर किसी एट्रिब्यूशन रिपोर्ट से जुड़े होते हैं.
सफलता की डीबग रिपोर्ट, Chrome 101 (अप्रैल 2022) से उपलब्ध हैं.
ज़्यादा जानकारी वाली डीबग रिपोर्ट
ज़्यादा जानकारी वाली डीबग रिपोर्ट से, आपको सोर्स और ट्रिगर इवेंट के बारे में ज़्यादा जानकारी मिलती है. इससे, यह पक्का किया जा सकता है कि सोर्स रजिस्टर हो गए हैं या नहीं. इसके अलावा, यह भी पता लगाया जा सकता है कि रिपोर्ट मौजूद क्यों नहीं हैं और वे क्यों मौजूद नहीं हैं (सोर्स या ट्रिगर इवेंट में गड़बड़ी, रिपोर्ट भेजने या जनरेट करने में गड़बड़ी). ज़्यादा जानकारी वाली डीबग रिपोर्ट से पता चलता है कि:
- ऐसे मामले जिनमें ब्राउज़र ने किसी सोर्स को रजिस्टर कर लिया.
- ऐसे मामले जिनमें ब्राउज़र ने किसी सोर्स या ट्रिगर इवेंट को रजिस्टर नहीं किया — इसका मतलब है कि वह एट्रिब्यूशन रिपोर्ट जनरेट नहीं करेगा.
- ऐसे मामले जिनमें किसी वजह से एट्रिब्यूशन रिपोर्ट जनरेट या भेजी नहीं जा सकती.
ज़्यादा जानकारी वाली डीबग रिपोर्ट में एक type फ़ील्ड शामिल होता है. इसमें, सोर्स रजिस्ट्रेशन के पूरा होने या सोर्स, ट्रिगर या एट्रिब्यूशन रिपोर्ट जनरेट न होने की वजह के बारे में बताया जाता है.
ज़्यादा जानकारी वाली डीबग रिपोर्ट, Chrome 109 (जनवरी 2023) से उपलब्ध हैं. हालांकि, सोर्स रजिस्टर होने की जानकारी देने वाली ज़्यादा जानकारी वाली डीबग रिपोर्ट, Chrome 112 में बाद में जोड़ी गई हैं.
दूसरा चरण: डीबग रिपोर्ट सेट अप करना में, रिपोर्ट के उदाहरण देखें.
डीबग रिपोर्ट, कुकी पर आधारित होती हैं
डीबग रिपोर्ट का इस्तेमाल करने के लिए, रिपोर्टिंग ऑरिजिन को कुकी सेट करनी होगी.
अगर रिपोर्ट पाने के लिए कॉन्फ़िगर किया गया ऑरिजिन तीसरे पक्ष का है, तो यह कुकी तीसरे पक्ष की कुकी होगी. इसका मतलब है कि डीबग रिपोर्ट सिर्फ़ तब जनरेट होती हैं, जब उपयोगकर्ता के ब्राउज़र में तीसरे पक्ष की कुकी इस्तेमाल करने की अनुमति हो.
डीबग रिपोर्ट तुरंत भेजी जाती हैं
ब्राउज़र, डीबग रिपोर्ट को रिपोर्टिंग ऑरिजिन पर तुरंत भेज देता है. यह एट्रिब्यूशन रिपोर्ट से अलग है, जिन्हें देर से भेजा जाता है.
काम करने वाली डीबग रिपोर्ट, एट्रिब्यूशन रिपोर्ट जनरेट होने के साथ ही जनरेट और भेजी जाती हैं. इसका मतलब है कि ट्रिगर रजिस्टर होने पर.
सोर्स या ट्रिगर के रजिस्टर होने पर, ज़्यादा जानकारी वाली डीबग रिपोर्ट तुरंत भेजी जाती हैं.
डीबग रिपोर्ट में अलग-अलग एंडपॉइंट पाथ होते हैं
एट्रिब्यूशन रिपोर्ट की तरह ही, सभी डीबग रिपोर्ट रिपोर्टिंग ऑरिजिन को भेजी जाती हैं. डीबग रिपोर्ट, रिपोर्टिंग ऑरिजिन के तीन अलग-अलग एंडपॉइंट पर भेजी जाती हैं:
- इवेंट-लेवल पर, सफलता डीबग रिपोर्ट के लिए एंडपॉइंट
- सफल डीबग रिपोर्ट के लिए एंडपॉइंट, जिसे एग्रीगेट किया जा सकता है
- ज़्यादा जानकारी वाली डीबग रिपोर्ट, इवेंट-लेवल, और एग्रीगेट की जा सकने वाली रिपोर्ट के लिए एंडपॉइंट.
ज़्यादा जानने के लिए, दूसरा चरण: डीबग रिपोर्ट सेट अप करना लेख पढ़ें.
उपयोग के उदाहरण
रीयल-टाइम में इंटिग्रेशन की बुनियादी जांच
एट्रिब्यूशन रिपोर्ट के उलट, डीबग रिपोर्ट आपके एंडपॉइंट पर तुरंत भेजी जाती हैं. एट्रिब्यूशन रिपोर्ट को उपयोगकर्ता की निजता को सुरक्षित रखने के लिए देर से भेजा जाता है. डीबग रिपोर्ट का इस्तेमाल, रीयल-टाइम सिग्नल के तौर पर करें. इससे आपको यह पता चलेगा कि Attribution Reporting API के साथ आपका इंटिग्रेशन काम कर रहा है या नहीं.
तीसरा चरण: गड़बड़ी को ठीक करने के लिए निर्देशों वाली किताब में, ऐसा करने का तरीका जानें.
नुकसान का विश्लेषण
तीसरे पक्ष की कुकी के मुकाबले, एट्रिब्यूशन रिपोर्टिंग एपीआई में निजता की सुरक्षा के लिए पहले से सुविधाएं मौजूद होती हैं. इन सुविधाओं को उपयोगिता और निजता के बीच संतुलन बनाने के लिए डिज़ाइन किया गया है. इसका मतलब है कि हो सकता है कि Attribution Reporting API की मदद से, उतना मेज़रमेंट डेटा इकट्ठा न किया जा सके जितना कुकी की मदद से इकट्ठा किया जा सकता है. तीसरे पक्ष की कुकी की मदद से ट्रैक किए जा सकने वाले सभी कन्वर्ज़न, एट्रिब्यूशन रिपोर्ट जनरेट नहीं करेंगे.
एक उदाहरण: इवेंट-लेवल की रिपोर्ट के लिए, हर इंप्रेशन के लिए ज़्यादा से ज़्यादा एक कन्वर्ज़न रजिस्टर किया जा सकता है. इसका मतलब है कि किसी दिए गए विज्ञापन इंप्रेशन के लिए, आपको सिर्फ़ एक एट्रिब्यूशन रिपोर्ट मिलेगी. भले ही, उपयोगकर्ता कितनी ही बार ग्राहक में बदले.
कुकी पर आधारित मेज़रमेंट के नतीजों और Attribution Reporting API से मिलने वाले नतीजों के बीच के अंतर को समझने के लिए, डीबग रिपोर्ट का इस्तेमाल करें. यह पता लगाएं कि कौनसे कन्वर्ज़न रिपोर्ट किए गए हैं, कितने कन्वर्ज़न रिपोर्ट नहीं किए गए हैं, और खास तौर पर कौनसे कन्वर्ज़न और क्यों नहीं किए गए हैं.
तीसरा चरण: गड़बड़ी को डीबग करने के बारे में जानकारी में, नुकसान का विश्लेषण करने का तरीका जानें.
समस्या का हल
निजता या संसाधनों की सुरक्षा से जुड़ी वजहों से होने वाला नुकसान तो लाज़मी है, लेकिन अन्य वजहों से होने वाला नुकसान अनजाने में हो सकता है. लागू करने के दौरान गलत कॉन्फ़िगरेशन या ब्राउज़र में मौजूद गड़बड़ियों की वजह से, रिपोर्ट मौजूद नहीं हो सकतीं.
डीबग रिपोर्ट का इस्तेमाल करके, लागू करने से जुड़ी समस्या का पता लगाया जा सकता है और उसे ठीक किया जा सकता है. इसके अलावा, ब्राउज़र टीम को किसी संभावित गड़बड़ी की शिकायत भी की जा सकती है. ऐसा करने का तरीका जानने के लिए, तीसरा चरण: गड़बड़ी को ठीक करने के बारे में जानकारी लेख पढ़ें.
बेहतर कॉन्फ़िगरेशन की जांच
Attribution Reporting API की कुछ सुविधाओं की मदद से, एपीआई के व्यवहार को पसंद के मुताबिक बनाया जा सकता है. फ़िल्टर करने के नियम, डुप्लीकेट कॉपी हटाने के नियम, और प्राथमिकता वाले नियम कुछ उदाहरण हैं.
इन सुविधाओं का इस्तेमाल करते समय, डीबग रिपोर्ट का इस्तेमाल करके देखें कि आपका लॉजिक, एट्रिब्यूशन रिपोर्ट के इंतज़ार किए बिना, प्रोडक्शन में सही तरीके से काम कर रहा है या नहीं. तीसरा चरण: गड़बड़ी को ठीक करने के लिए निर्देशों वाली किताब में, ऐसा करने का तरीका जानें.
एग्रीगेट की जा सकने वाली रिपोर्ट की मदद से स्थानीय टेस्टिंग
एग्रीगेट की जा सकने वाली एट्रिब्यूशन रिपोर्ट एन्क्रिप्ट (सुरक्षित) होती हैं. वहीं, एग्रीगेट की जा सकने वाली डीबग रिपोर्ट में एन्क्रिप्ट नहीं किया गया पेलोड शामिल होता है.
एग्रीगेट की जा सकने वाली रिपोर्ट के कॉन्टेंट की पुष्टि करने के लिए, एग्रीगेट की जा सकने वाली डीबग रिपोर्ट का इस्तेमाल करें. साथ ही, जांच के लिए लोकल एग्रीगेशन टूल की मदद से खास जानकारी वाली रिपोर्ट जनरेट करें.
Aggregation Service की रिपोर्ट फिर से प्रोसेस करना
डीबग मोड का इस्तेमाल करने का एक और फ़ायदा यह है कि इससे रिपोर्ट को फिर से प्रोसेस किया जा सकता है. इसलिए, रिपोर्ट को एक से ज़्यादा बार प्रोसेस करने के लिए, पक्का करें कि डीबग रिपोर्ट चालू हों. रिपोर्ट को फिर से प्रोसेस करने की ज़रूरत तब पड़ सकती है, जब:
- एग्रीगेशन सेवा को डीबग करने की कोशिश की जा रही है.
- अलग-अलग बैचिंग की रणनीतियों के साथ प्रयोग करना.
- अलग-अलग एप्सिलॉन वैल्यू के साथ प्रयोग करना.
डेटा वापस पाएं
हमारा सुझाव है कि विज्ञापन टेक्नोलॉजी डीबग रिपोर्ट पाने के लिए, डीबग मोड चालू करें, ताकि वे अपना रिपोर्टिंग डेटा वापस पा सकें. यह एग्रीगेशन सेवा से जुड़ी समस्याओं के मामलों में मददगार होता है. जैसे, सेवाएं उपलब्ध न होना या काम न करना. इनकी वजह से, खास जानकारी वाली रिपोर्ट जनरेट नहीं हो पाती.