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