जून 2022 में एट्रिब्यूशन रिपोर्टिंग के अपडेट

Chrome के वर्शन 104 के लिए, एट्रिब्यूशन रिपोर्टिंग प्रपोज़ल में बदलाव किया जा रहा है. इसमें एपीआई के नए तरीके, फ़ंक्शन, और एग्रीगेशन सेवा के अपडेट शामिल किए गए हैं.

ये अपडेट किसके लिए हैं?

ये अपडेट आपके लिए हैं, अगर:

• आपको एपीआई के बारे में पहले से जानकारी है. उदाहरण के लिए, अगर आपने WICG डेटा स्टोर करने की जगह पर चर्चा की है या उसमें हिस्सा लिया है और आपको एपीआई में किए गए बदलावों के बारे में जानना है.
• किसी डेमो में Attribution Reporting API का इस्तेमाल किया जा रहा है या आपको ऑरिजिन ट्रायल में इसकी जांच करनी है.

अगर आपने अभी इस एपीआई का इस्तेमाल शुरू किया है और/या आपने अब तक इसे इस्तेमाल नहीं किया है, तो सीधे एपीआई के बारे में जानकारी वाले पेज पर जाएं.

ध्यान दें: Google Chrome की टीम डेवलपर ऑफ़िस में कामकाज के घंटे होस्ट करेगी. यहां प्राइवसी सैंडबॉक्स टेक्नोलॉजी की जांच और इंटिग्रेशन करने वाले डेवलपर, Chrome के प्राइवसी सैंडबॉक्स में एट्रिब्यूशन रिपोर्टिंग के बारे में ज़्यादा जान सकते हैं.

Attribution Reporting API के अपडेट

Attribution Reporting क्लाइंट-साइड एपीआई में हुए नए बदलावों को दिखाने के लिए, Attribution Reporting के डेमो को अपडेट किया गया है.

ज़्यादातर बदलावों के लिए कार्रवाई की ज़रूरत नहीं होती. जिन कारोबारों को लागू करने के लिए आपको अपडेट की ज़रूरत होती है उन्हें नीचे हाइलाइट किया गया है.

(कार्रवाई ज़रूरी है) रजिस्ट्रेशन के लिए यूनिफ़ाइड हेडर

हेडर को यूनिफ़ाइड कर दिया गया है. अब सोर्स के लिए सिर्फ़ एक हेडर और ट्रिगर के लिए एक-एक हेडर है. इसे JSON फ़ॉर्मैट में फ़ॉर्मैट किया गया है.

• एट्रिब्यूशन सोर्स को रजिस्टर करने के लिए, Attribution-Reporting-Register-Source हेडर की मदद से रजिस्ट्रेशन के अनुरोधों का जवाब दिया जा सकता है.
• ट्रिगर रजिस्ट्रेशन पूरा करने के लिए, Attribution-Reporting-Register-Trigger हेडर सेट करें.

इस बदलाव के लिए कार्रवाई करना ज़रूरी है. ज़्यादा जानकारी के लिए, एपीआई की डेवलपर गाइड देखें.

(कार्रवाई ज़रूरी है) एग्रीगेशन कुंजियां अब डिक्शनरी बन गई हैं

एट्रिब्यूशन सोर्स रजिस्टर करने के लिए, aggregation_keys का इस्तेमाल करना जारी रखें. हालांकि, अब इसे सूची के बजाय JSON डिक्शनरी के तौर पर सेव कर दिया जाएगा.

उदाहरण के लिए:

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

इस बदलाव के लिए कार्रवाई करना ज़रूरी है. ज़्यादा जानकारी के लिए, एपीआई हैंडबुक देखें.

रिपोर्ट जनरेट करना

सिर्फ़ एग्रीगेट की जा सकने वाली रिपोर्ट जनरेट करने का विकल्प चुना जा सकता है, जिन्हें खास जानकारी वाली रिपोर्ट में एग्रीगेट किया जा सकता है. अगर आपके फ़िल्टर किसी भी इवेंट ट्रिगर से मैच नहीं होते हैं, तो इवेंट-लेवल की कोई भी रिपोर्ट जनरेट नहीं होगी.

यूनिफ़ाइड डीबग कुंजी की सेटिंग

डीबग कुंजी अब अलग-अलग हेडर के बजाय, सोर्स और ट्रिगर हेडर में सेट होनी चाहिए. रिपोर्ट को डीबग करने के तरीके के बारे में ज़्यादा जानें.

एट्रिब्यूशन सोर्स रजिस्टर करें

स्क्रिप्ट टैग का इस्तेमाल अब एट्रिब्यूशन सोर्स को रजिस्टर करने के लिए किया जा सकता है. यह सुविधा बिलकुल <img> टैग की तरह ही काम करती है.

ज़्यादा एपीआई अपडेट

एपीआई हैंडबुक में किए गए और बताए गए अन्य बदलावों में ये शामिल हैं:

• सोर्स को JavaScript request API के साथ रजिस्टर किया जा सकता है.
• window.registerSource हटाया गया.
• अब सोर्स को रजिस्टर करते समय, attributionsrc के लिए वैल्यू शामिल करना ज़रूरी नहीं है.
• सोर्स के रजिस्ट्रेशन के अनुरोधों में Attribution-Reporting-Eligible हेडर जोड़ा गया.
• encodeURIComponent में मामूली बदलाव हुआ है.
• एग्रीगेट की जा सकने वाली रिपोर्ट के shared_info फ़ील्ड से निजता बजट कुंजी को हटा दिया गया.

एग्रीगेशन सेवा के लिए सहायता

Chrome 104 में, हम एग्रीगेटेड रिपोर्ट में मौजूद कुछ जानकारी के फ़ॉर्मैट को अपडेट करना चाहते हैं. फ़िलहाल, हम एग्रीगेशन सेवा में इस बदलाव के लिए काम कर रहे हैं. बदलावों के शिप होने के बाद, इस दस्तावेज़ के साथ-साथ बदलाव लॉग को भी अपडेट किया जाएगा.

हमने खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, सलाह और रणनीतियों वाला एक दस्तावेज़ इकट्ठा किया है. इसमें कई अहम जानकारी शामिल होती है. जैसे:

• खास जानकारी वाली रिपोर्ट जनरेट करने के दौरान, ग़ैर-ज़रूरी डेटा के बारे में खास जानकारी
• डाइमेंशन, कुंजियों, और वैल्यू की पूरी जानकारी
• एग्रीगेशन की कुंजियां अपने-आप लागू होती हैं. इसमें, कुंजी के स्ट्रक्चर का मैप भी शामिल है
• एग्रीगेट की जा सकने वाली वैल्यू और योगदान के बजट के असर
• Epsilon के साथ प्रयोग करने के लिए गाइड

अपडेट के बारे में ज़्यादा पढ़ें

• आपको एपीआई के बारे में क्या पता होना चाहिए लेख पढ़ें.
• एट्रिब्यूशन रिपोर्टिंग के साथ प्रयोग: खास जानकारी वाली रिपोर्ट के लिए रणनीति और सलाह पढ़ें.

हेडर इमेज Unsplash पर डायना पोलेखीना ने ली है.