सभी उपयोगकर्ताओं के लिए एग्रीगेट किए गए विज्ञापन कन्वर्ज़न को मेज़र करें. ऐसा, किसी व्यक्ति का डेटा ज़ाहिर किए बिना किया जाता है. इसे पहले एग्रीगेट रिपोर्ट कहा जाता था.
लागू करने की स्थिति
- Chrome प्लैटफ़ॉर्म की स्थिति
- इस एपीआई का इस्तेमाल करें और उससे जुड़े प्रयोग करें.
- एपीआई में हुए बदलावों को ट्रैक करें.
एट्रिब्यूशन रिपोर्टिंग की खास जानकारी वाली रिपोर्ट क्या है?
एट्रिब्यूशन रिपोर्टिंग एपीआई की मदद से, यह मेज़र किया जा सकता है कि विज्ञापन पर क्लिक या व्यू करने से, विज्ञापन देने वाले की साइट पर बिक्री या साइन-अप जैसा कोई कन्वर्ज़न कब हुआ. यह एपीआई, तीसरे पक्ष की कुकी या ऐसे तरीकों पर भरोसा नहीं करता जिनका इस्तेमाल, सभी साइटों पर अलग-अलग उपयोगकर्ताओं की पहचान करने के लिए किया जा सकता है.
यह एपीआई दो तरह की रिपोर्ट उपलब्ध कराता है. इवेंट-लेवल की रिपोर्ट, Chrome में टेस्टिंग के लिए पहले से ही उपलब्ध हैं. ये किसी खास विज्ञापन पर मिले क्लिक या व्यू को कम जानकारी वाले कन्वर्ज़न डेटा से जोड़ती हैं. ब्राउज़र, विज्ञापन टेक्नोलॉजी कंपनियों को कई दिनों तक रिपोर्ट भेजने में देरी करता है, ताकि अलग-अलग साइटों पर आपकी पहचान से जुड़ी जानकारी को जोड़ने से रोका जा सके.
खास जानकारी वाली रिपोर्ट (पहले इसे एग्रीगेट रिपोर्ट कहा जाता था) को उपयोगकर्ताओं के ग्रुप के लिए इकट्ठा किया जाता है, ताकि इसे किसी व्यक्ति से नहीं जोड़ा जा सके. खास जानकारी वाली रिपोर्ट में, खरीदारी की वैल्यू और कार्ट के कॉन्टेंट जैसे ज़्यादा जानकारी वाले कन्वर्ज़न डेटा के साथ-साथ, क्लिक और व्यू डेटा की सुविधा भी मिलती है. इन रिपोर्ट में, इवेंट-लेवल की रिपोर्ट की तरह देरी नहीं होती.
अगर आपने अब तक ऐसा नहीं किया है, तो हमारा सुझाव है कि इस लेख के बाकी हिस्से को पढ़ने से पहले, एट्रिब्यूशन रिपोर्टिंग की सामान्य जानकारी पढ़ें.
हमें खास जानकारी वाली रिपोर्ट की ज़रूरत क्यों है?

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

अलग-अलग रिपोर्ट में, अलग-अलग साइटों पर उपयोगकर्ता के व्यवहार की जानकारी हो सकती है. इसलिए, एग्रीगेशन सेवा को इस जानकारी को निजी के तौर पर इस्तेमाल करना चाहिए. इस सेवा से यह पक्का किया जा सकेगा कि कोई भी दूसरी इकाई, एट्रिब्यूशन की अनक्रिप्ट की गई अलग-अलग रिपोर्ट को ऐक्सेस न कर सके. इसके अलावा, सेवा को खुद से ऐसी कोई कार्रवाई नहीं करनी चाहिए जिससे उपयोगकर्ता की निजता का उल्लंघन हो.
यह पक्का करने के लिए कि एग्रीगेशन सेवा असल में सुरक्षित है, सेवा में तकनीकी और संगठन से जुड़ी ऐसी सुरक्षाएं होनी चाहिए जिनकी पुष्टि उपभोक्ता ऑडिट से की जा सके. सुरक्षा के ये उपाय इनके लिए काम के हैं:
- अलग-अलग उपयोगकर्ताओं को उनके निजी डेटा का ऐक्सेस सिर्फ़ एक साथ दिया जा सकता है, न कि किसी एक इकाई को
- विज्ञापन टेक्नोलॉजी विशेषज्ञ, जो पुष्टि कर सकते हैं कि एग्रीगेशन की प्रोसेस में मान्य डेटा का इस्तेमाल किया जाता है और इसे सही तरीके से मॉनिटर किया जा सकता है
एग्रीगेशन सेवा की मदद से रिपोर्ट जनरेट करना
शुरुआती डिज़ाइन में, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली हर कंपनी को, एग्रीगेशन सेवा का अपना इंस्टेंस चलाने के लिए कहा जाता है. यह इंस्टेंस, ज़रूरी सुरक्षा सुविधाओं के साथ काम करने वाली क्लाउड सेवा पर डिप्लॉय किए गए ट्रस्टेड एक्ज़ीक्यूशन एनवायरमेंट (टीईई) में चलाया जाता है.
एग्रीगेशन सेवा में, टीईई का कोड ही रॉ रिपोर्ट का ऐक्सेस रखता है. इस कोड की सुरक्षा, सुरक्षा से जुड़े शोधकर्ता, निजता के पैरोकार, और विज्ञापन टेक्नोलॉजी के विशेषज्ञों की ओर से ऑडिट की जाएगी. कोऑर्डिनेटर, पुष्टि करता है कि टीईई में वही सॉफ़्टवेयर चल रहा है जिसे अनुमति मिली है और डेटा सुरक्षित है.
कोऑर्डिनेटर की कई ज़िम्मेदारियां होती हैं:
- अनुमति वाली बाइनरी इमेज की सूची बनाए रखें. ये इमेज, एग्रीगेशन सेवा के सॉफ़्टवेयर बिल्ड के क्रिप्टोग्राफ़िक हैश हैं. Google इन्हें समय-समय पर रिलीज़ करेगा. इसे फिर से बनाया जा सकता है, ताकि कोई भी पक्ष पुष्टि कर सके कि इमेज, एग्रीगेशन सेवा के बिल्ड से मेल खाती हैं.
- पासकोड मैनेज करने वाला सिस्टम चलाना. एग्रीगेट की जा सकने वाली रिपोर्ट को एन्क्रिप्ट (सुरक्षित) करने के लिए, उपयोगकर्ता के डिवाइस पर Chrome के लिए एन्क्रिप्शन पासकोड ज़रूरी हैं. एग्रीगेशन सेवा का कोड, बाइनरी इमेज से मेल खाता है, यह साबित करने के लिए डिक्रिप्ट करने की कुंजियां ज़रूरी हैं.
- एग्रीगेट की जा सकने वाली रिपोर्ट को ट्रैक करें, ताकि समरी रिपोर्ट के लिए एग्रीगेशन में फिर से इस्तेमाल न किया जा सके. ऐसा करने से, व्यक्तिगत पहचान से जुड़ी जानकारी (पीआईआई) ज़ाहिर हो सकती है.
अब तक पूरा हो चुके ऑरिजिन ट्रायल में, एग्रीगेशन सेवा की जांच उपलब्ध कराने के लिए, Google ने कोऑर्डिनेटर की भूमिका निभाई. आने वाले समय में, हम एक या उससे ज़्यादा स्वतंत्र इकाइयों की पहचान करने पर काम कर रहे हैं, जो इस भूमिका को शेयर कर सकती हैं.
कौनसी जानकारी कैप्चर की जाती है?
खास जानकारी वाली रिपोर्ट में, विज्ञापन साइड और कन्वर्ज़न डेटा के साथ-साथ इकट्ठा किए गए डेटा का कॉम्बिनेशन मिलता है.
उदाहरण के लिए, विज्ञापन टेक्नोलॉजी की सेवा देने वाली कोई कंपनी news.example
पर विज्ञापन कैंपेन चलाती है. इसमें, कन्वर्ज़न से पता चलता है कि किसी उपयोगकर्ता ने shoes.example
पर जूतों के विज्ञापन पर क्लिक करके, जूतों की खरीदारी पूरी की. विज्ञापन टेक्नोलॉजी को आईडी 1234567
वाले इस विज्ञापन कैंपेन की खास जानकारी वाली रिपोर्ट मिलती है. इसमें बताया गया है कि 12 जनवरी, 2022 को shoes.example पर 518 कन्वर्ज़न हुए. साथ ही, कुल 38,174 डॉलर खर्च हुए. 60% कन्वर्ज़न, प्रॉडक्ट SKU 9872
वाले नीले स्नीकर खरीदने वाले उपयोगकर्ताओं से मिले. वहीं, 40% कन्वर्ज़न, प्रॉडक्ट SKU 2643
वाले पीले सैंडल खरीदने वाले उपयोगकर्ताओं से मिले. कैंपेन आईडी, विज्ञापन साइड का ज़्यादा जानकारी वाला डेटा होता है, जबकि प्रॉडक्ट SKU, ज़्यादा जानकारी वाला कन्वर्ज़न डेटा होता है. कन्वर्ज़न की संख्या और कुल खर्च, एग्रीगेट किया गया डेटा होता है.
कन्वर्ज़न, विज्ञापन देने वाली कंपनी या विज्ञापन टेक्नोलॉजी कंपनी तय करती है. साथ ही, ये अलग-अलग विज्ञापन कैंपेन के लिए अलग-अलग हो सकते हैं. एक कैंपेन, विज्ञापन पर क्लिक करने के बाद, विज्ञापन में दिखाए गए आइटम को खरीदने वाले उपयोगकर्ताओं की संख्या को मेज़र कर सकता है. किसी दूसरे कैंपेन से यह मेज़र किया जा सकता है कि विज्ञापन के कितने व्यू से विज्ञापन देने वाले की साइट पर विज़िट हुईं.
एग्रीगेशन से पहले ब्राउज़र डेटा को कैसे कैप्चर किया जाता है?
खास जानकारी वाली रिपोर्ट, लोगों के ग्रुप के डेटा से बनी होती हैं. इसलिए, एक व्यक्ति के ब्राउज़र ऐक्शन से शुरू करते हैं.
- कोई उपयोगकर्ता पब्लिशर साइट पर जाता है और किसी विज्ञापन को देखता है या उस पर क्लिक करता है. इसे एट्रिब्यूशन सोर्स इवेंट भी कहा जाता है.
कुछ मिनट या दिनों के बाद, उपयोगकर्ता ग्राहक में बदल जाता है. इसे एट्रिब्यूशन ट्रिगर इवेंट भी कहा जाता है. उदाहरण के लिए, कन्वर्ज़न को प्रॉडक्ट की खरीदारी के तौर पर परिभाषित किया जा सकता है.
ब्राउज़र सॉफ़्टवेयर, विज्ञापन पर क्लिक या व्यू को कन्वर्ज़न इवेंट से मैच करता है. इस मैच के आधार पर, ब्राउज़र एक ऐसी रिपोर्ट बनाता है जिसे इकट्ठा किया जा सकता है. इसमें विज्ञापन टेक्नोलॉजी की सेवा देने वाली कंपनी का बनाया गया खास लॉजिक शामिल होता है.
ब्राउज़र इस डेटा को एन्क्रिप्ट (सुरक्षित) करता है और थोड़ी देर बाद, इकट्ठा करने के लिए विज्ञापन टेक्नोलॉजी सर्वर को भेजता है. एग्रीगेट की जा सकने वाली इन रिपोर्ट से एग्रीगेट की गई अहम जानकारी ऐक्सेस करने के लिए, विज्ञापन टेक्नोलॉजी सर्वर को एग्रीगेशन सेवा पर भरोसा करना होगा.
फ़िल्टर करने वाले आईडी
एट्रिब्यूशन रिपोर्टिंग एपीआई और एग्रीगेशन सेवा, अलग-अलग कैडेंस पर मेज़रमेंट को प्रोसेस करने के लिए, फ़िल्टर करने वाले आईडी का इस्तेमाल करने की अनुमति देते हैं. इसके बजाय, एग्रीगेट की जा सकने वाली रिपोर्ट में सभी मेज़रमेंट योगदान को एक साथ प्रोसेस करना पड़ता है.

ध्यान रखें कि सभी वैल्यू को स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाना चाहिए. साथ ही, ये केस-सेंसिटिव होती हैं.
आपको एट्रिब्यूशन ट्रिगर मेटाडेटा के साथ, एचटीटीपी हेडर Attribution-Reporting-Register-Trigger
में जवाब देना चाहिए.
हमारा सुझाव है कि आप इनसे शुरुआत करें:
app.get('/register-trigger', async (req, res) => {
…
res.setHeader('Attribution-Reporting-Register-Trigger',
JSON.stringify({
"filtering_id_max_bytes": 1
"aggregatable_trigger_data": [{
"key_piece": "0x400",
"source_keys": ["campaignCounts"]
}],
"aggregatable_values": {
"campaignCounts": { "value": 32768, "filtering_id": "1" }
}
})
);
res.sendStatus(200);
…
});
एग्रीगेट की जा सकने वाली रिपोर्ट, उस एंडपॉइंट पर भेजी जाएंगी जहां आपने एंडपॉइंट /.well-known/attribution-reporting/report-aggregate-attribution
तय किया है. एग्रीगेट की जा सकने वाली रिपोर्ट के बैच, सेट अप की गई एग्रीगेशन सेवा को भेजे जाने और प्रोसेस होने के बाद, फ़िल्टर किए गए नतीजे आपकी खास जानकारी वाली फ़ाइनल रिपोर्ट में दिखने चाहिए.
एग्रीगेशन सेवा में, आईडी फ़िल्टर करने की गाइड पर जाएं. Private Aggregation API के लिए, आईडी फ़िल्टर करने का तरीका भी देखें.
खास जानकारी वाली रिपोर्ट बनाना
विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियों को खास जानकारी वाली रिपोर्ट पाने के लिए, ये चरण पूरे करने होंगे:
- विज्ञापन टेक्नोलॉजी, अलग-अलग उपयोगकर्ताओं के ब्राउज़र से एग्रीगेट की जा सकने वाली रिपोर्ट इकट्ठा करती है.
- विज्ञापन टेक्नोलॉजी की सेवा देने वाली कंपनी, एग्रीगेट की जा सकने वाली रिपोर्ट को एक बैच में जोड़ती है और उन बैचों को एग्रीगेशन सेवा को भेजती है.
- एग्रीगेशन सेवा, डेटा इकट्ठा करने के लिए वर्कर्स को शेड्यूल करती है.
- एग्रीगेशन वर्कर्स, एग्रीगेट की जा सकने वाली रिपोर्ट से डेटा को डिक्रिप्ट और एग्रीगेट करता है. साथ ही, नॉइज़ वाले डेटा (डेटा की निजता बनाए रखने के लिए एक तरीका) को भी एग्रीगेट करता है.
- एग्रीगेशन सेवा, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी को खास जानकारी वाली रिपोर्ट दिखाती है.
विज्ञापन टेक्नोलॉजी, खास जानकारी वाली रिपोर्ट का इस्तेमाल करके बिडिंग की जानकारी दे सकती है. साथ ही, अपने ग्राहकों को रिपोर्टिंग की सुविधा भी दे सकती है. समरी रिपोर्ट का फ़ॉर्मैट, JSON में कोड किया गया स्कीमा होता है.
लोगों से जुड़ें और सुझाव, शिकायत या राय शेयर करें
आपके पास इस एपीआई में हिस्सा लेने और इसका इस्तेमाल करने का विकल्प है.
- एग्रीगेट करने लायक रिपोर्ट और एग्रीगेशन सेवा के बारे में पढ़ें, सवाल पूछें, और सुझाव दें.
- एट्रिब्यूशन रिपोर्टिंग गाइड पढ़ें.
- प्राइवसी सैंडबॉक्स डेवलपर सहायता रेपो पर सवाल पूछें और होने वाली चर्चाओं में शामिल हों.