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