एट्रिब्यूशन रिपोर्टिंग को डीबग करने से जुड़े तीन चरणों में से पहला हिस्सा. जानें कि डीबग करना क्यों ज़रूरी है और जांच में डीबग रिपोर्ट को कब इस्तेमाल करना चाहिए.
आपको डीबग रिपोर्ट की ज़रूरत क्यों है
अगर Attribution Reporting API की टेस्टिंग की जा रही है, तो आपको यह जांच करनी चाहिए कि आपका इंटिग्रेशन ठीक से काम कर रहा है या नहीं. साथ ही, आपको कुकी के आधार पर लागू करने और एट्रिब्यूशन रिपोर्टिंग लागू करने के बीच के मेज़रमेंट के नतीजों में अंतर को समझना चाहिए. साथ ही, इंटिग्रेशन से जुड़ी किसी भी समस्या को हल करना चाहिए.
इन टास्क को पूरा करने के लिए, डीबग रिपोर्ट ज़रूरी हैं. इसलिए, हमारा सुझाव है कि आप इन्हें सेट अप करें.
शब्दावली
डीबग रिपोर्ट के मुख्य पहलू
दो तरह की डीबग रिपोर्ट
दो तरह की डीबग रिपोर्ट उपलब्ध होती हैं. दोनों का इस्तेमाल करें, क्योंकि ये अलग-अलग इस्तेमाल के उदाहरणों को पूरा करते हैं.
डीबग रिपोर्ट सफल रही
समस्या वाली डीबग रिपोर्ट एट्रिब्यूशन रिपोर्ट बनने के सफल तरीके को ट्रैक करती हैं. वे सीधे किसी एट्रिब्यूशन रिपोर्ट से जुड़े होते हैं.
काम की डीबग रिपोर्ट, 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 की कुछ सुविधाओं की मदद से, एपीआई के काम करने के तरीके को पसंद के मुताबिक बनाया जा सकता है. फ़िल्टर करने के नियम, डुप्लीकेट कॉपी हटाने के नियम, और प्राथमिकता के नियम इसके कुछ उदाहरण हैं.
इन सुविधाओं का इस्तेमाल करते समय, डीबग रिपोर्ट का इस्तेमाल करें. इससे यह जांच की जा सकेगी कि आपका लॉजिक, एट्रिब्यूशन रिपोर्ट का इंतज़ार किए बिना प्रोडक्शन में सही तरीके से काम कर रहा है या नहीं. ऐसा करने का तरीका जानने के लिए, तीसरा चरण: कुकबुक को डीबग करना पढ़ें.
एग्रीगेट की जा सकने वाली रिपोर्ट के साथ लोकल टेस्टिंग
एग्रीगेट की जा सकने वाली एट्रिब्यूशन रिपोर्ट को एन्क्रिप्ट (सुरक्षित) किया जाता है, जबकि एग्रीगेट की जा सकने वाली डीबग रिपोर्ट में, एन्क्रिप्ट (सुरक्षित) नहीं किया गया पेलोड शामिल होता है.
एग्रीगेट करने लायक रिपोर्ट के कॉन्टेंट की पुष्टि करने के लिए, एग्रीगेट की जा सकने वाली डीबग रिपोर्ट इस्तेमाल करें. साथ ही, टेस्टिंग के लिए लोकल एग्रीगेशन टूल से खास जानकारी वाली रिपोर्ट जनरेट करें.
एग्रीगेशन सेवा की रिपोर्ट को फिर से प्रोसेस किया जा रहा है
डीबग मोड का इस्तेमाल करने का एक और फ़ायदा यह है कि इससे रिपोर्ट को फिर से प्रोसेस किया जा सकता है. इसलिए, रिपोर्ट को एक से ज़्यादा बार प्रोसेस करने के लिए, पक्का करें कि डीबग रिपोर्ट चालू हो. इन मामलों में रिपोर्ट को फिर से प्रोसेस किया जा सकता है:
- एग्रीगेशन सेवा को डीबग करने की कोशिश की जा रही है.
- प्रयोग के लिए अलग-अलग तरीके अपनाए जा रहे हैं.
- अलग-अलग एप्सिलॉन वैल्यू के साथ प्रयोग करना.
डेटा वापस पाएं
हमारा सुझाव है कि विज्ञापन टेक्नोलॉजी, डीबग मोड को चालू करें, ताकि उन्हें डीबग रिपोर्ट मिल सकें. इससे वे अपना रिपोर्टिंग डेटा वापस पा सकते हैं. यह एग्रीगेशन सेवा से जुड़ी समस्याओं, जैसे कि उपलब्ध नहीं है या जवाब न देने वाली सेवाओं जैसी समस्याओं के लिए काम का है. इन समस्याओं की वजह से, खास जानकारी वाली रिपोर्ट जनरेट नहीं हो पाएगी.