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