एट्रिब्यूशन रिपोर्टिंग: सिस्टम की पूरी जानकारी

एट्रिब्यूशन रिपोर्टिंग के लिए कनेक्ट की गई सेवाओं के बारे में खास जानकारी. यह जानकारी, तकनीकी फ़ैसले लेने वाले लोगों के लिए है.

Attribution Reporting API की मदद से, विज्ञापन से जुड़ी टेक्नोलॉजी देने वाली कंपनियां और विज्ञापन देने वाले लोग या कंपनियां यह मेज़र कर सकती हैं कि किसी विज्ञापन पर क्लिक या व्यू करने से कन्वर्ज़न कब होता है. जैसे, खरीदारी. यह एपीआई, क्लाइंट-साइड और सर्वर-साइड इंटिग्रेशन के कॉम्बिनेशन पर काम करता है. यह आपके कारोबार की ज़रूरतों पर निर्भर करता है.

आगे बढ़ने से पहले, एट्रिब्यूशन रिपोर्टिंग की खास जानकारी ज़रूर पढ़ें. इससे आपको एपीआई के मकसद और अलग-अलग आउटपुट रिपोर्ट (इवेंट-लेवल रिपोर्ट और खास जानकारी वाली रिपोर्ट) के फ़्लो को समझने में मदद मिलेगी. अगर आपको कोई ऐसा शब्द मिलता है जिसके बारे में आपको जानकारी नहीं है, तो Privacy Sandbox के शब्दकोश में जाकर देखें.

यह दस्तावेज़ किसके लिए है?

आपको यह दस्तावेज़ तब पढ़ना चाहिए, जब:

• आप विज्ञापन टेक्नोलॉजी या विज्ञापन देने वाले व्यक्ति या कंपनी के तकनीकी फ़ैसले लेने वाले व्यक्ति हैं. आपके पास ऑपरेशंस, DevOps, डेटा साइंस, आईटी, मार्केटिंग या कोई अन्य भूमिका हो सकती है. इस भूमिका में, आपको तकनीकी तौर पर लागू करने से जुड़े फ़ैसले लेने होते हैं. आपको यह जानना है कि निजता बनाए रखने के लिए मेज़रमेंट की सुविधा देने वाले एपीआई कैसे काम करते हैं.
• आप तकनीकी विशेषज्ञ (जैसे, डेवलपर, सिस्टम ऑपरेटर, सिस्टम आर्किटेक्ट या डेटा साइंटिस्ट) हैं. आपको इस एपीआई और एग्रीगेशन सेवा के एनवायरमेंट के साथ एक्सपेरिमेंट सेट अप करने हैं.

इस दस्तावेज़ में, आपको Attribution Reporting API के लिए सेवाओं के काम करने के तरीके के बारे में खास जानकारी मिलेगी. अगर आप तकनीकी विशेषज्ञ हैं, तो इस एपीआई को स्थानीय तौर पर आज़माया जा सकता है.

खास जानकारी

Attribution Reporting API में कई सेवाएं शामिल हैं. इनके लिए, खास सेटअप, क्लाइंट-साइड कॉन्फ़िगरेशन, और सर्वर डिप्लॉयमेंट की ज़रूरत होती है. यह तय करने के लिए कि आपको क्या चाहिए, पहले:

• डिज़ाइन से जुड़े फ़ैसले ले सकते हैं. तय करें कि आपको कौनसी जानकारी इकट्ठा करनी है. साथ ही, यह तय करें कि आपको किसी कैंपेन से किस तरह के कन्वर्ज़न चाहिए और आपको किस तरह की रिपोर्ट चाहिए. फ़ाइनल आउटपुट, दो तरह की रिपोर्ट में से एक या दोनों हो सकते हैं: इवेंट-लेवल रिपोर्ट और खास जानकारी वाली रिपोर्ट.

रिपोर्टिंग के लिए, हमेशा दो (और कभी-कभी तीन) कॉम्पोनेंट एक साथ काम करते हैं:

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

अगर आपने एग्रीगेट की जा सकने वाली रिपोर्ट इकट्ठा की हैं, तो आपको तीसरे कॉम्पोनेंट की ज़रूरत होगी:

• खास जानकारी वाली रिपोर्ट जनरेट करना. खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, एग्रीगेट की जा सकने वाली रिपोर्ट को बैच करें और रिपोर्ट को प्रोसेस करने के लिए, Aggregation Service का इस्तेमाल करें.

डिज़ाइन से जुड़े फ़ैसले

Attribution Reporting API का एक अहम सिद्धांत, डिज़ाइन से जुड़े फ़ैसले जल्दी लेना है. आपके पास यह तय करने का विकल्प होता है कि किस कैटगरी में कौनसा डेटा इकट्ठा करना है और उस डेटा को कितनी बार प्रोसेस करना है. आउटपुट रिपोर्ट से, आपको अपने कैंपेन या कारोबार के बारे में अहम जानकारी मिलती है.

आउटपुट रिपोर्ट इस तरह की हो सकती है:

• इवेंट-लेवल की रिपोर्ट, विज्ञापन पर हुए किसी क्लिक या व्यू (विज्ञापन देने वाले व्यक्ति या कंपनी के हिसाब से) को कन्वर्ज़न के डेटा से जोड़ती हैं. उपयोगकर्ता की निजता बनाए रखने के लिए, अलग-अलग साइटों पर उपयोगकर्ता की पहचान को सीमित किया जाता है. इसलिए, कन्वर्ज़न-साइड डेटा बहुत सीमित होता है. साथ ही, डेटा में नॉइज़ होती है. इसका मतलब है कि कुछ मामलों में, असली रिपोर्ट के बजाय रैंडम डेटा भेजा जाता है.
• खास जानकारी वाली रिपोर्ट, विज्ञापन से जुड़े किसी इवेंट से नहीं जुड़ी होती हैं. इन रिपोर्ट में, कन्वर्ज़न का ज़्यादा जानकारी वाला डेटा मिलता है. साथ ही, क्लिक और व्यू डेटा को कन्वर्ज़न डेटा के साथ जोड़ने की सुविधा मिलती है.

रिपोर्ट के लिए चुने गए विकल्प से यह तय होता है कि आपको कौनसा डेटा इकट्ठा करना होगा.

फ़ैसले लेने के लिए इस्तेमाल किए जाने वाले टूल के लिए, फ़ाइनल आउटपुट को इनपुट के तौर पर भी इस्तेमाल किया जा सकता है. उदाहरण के लिए, अगर आपने यह पता लगाने के लिए खास जानकारी वाली रिपोर्ट जनरेट की हैं कि कुल खर्च की कुछ वैल्यू से कितने कन्वर्ज़न हुए, तो इससे आपकी टीम को यह तय करने में मदद मिल सकती है कि आपके अगले विज्ञापन कैंपेन को ज़्यादा कुल खर्च जनरेट करने के लिए, किस चीज़ को टारगेट करना चाहिए.

आपको जिस चीज़ को मेज़र करना है उसे तय करने के बाद, Attribution Reporting API के लिए क्लाइंट-साइड सेट अप किया जा सकता है.

वेबसाइट से ब्राउज़र तक डेटा ट्रांसफ़र करना

एट्रिब्यूशन इवेंट का फ़्लो

मान लें कि कोई पब्लिशर साइट विज्ञापन दिखाती है. विज्ञापन देने वाला हर व्यक्ति या कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, अपने विज्ञापनों के साथ होने वाले इंटरैक्शन के बारे में जानना चाहती है. साथ ही, सही विज्ञापन को कन्वर्ज़न एट्रिब्यूट करना चाहती है. रिपोर्ट (इवेंट-लेवल और एग्रीगेट की जा सकने वाली, दोनों) इस तरह जनरेट की जाएंगी:

1. पब्लिशर की साइट पर, विज्ञापन एलिमेंट (<a> या <img> टैग) को खास एट्रिब्यूट attributionsrc के साथ कॉन्फ़िगर किया जाता है. इसकी वैल्यू एक यूआरएल होती है. उदाहरण के लिए, https://adtech.example/register-source/ad_id=....

   यहां एक ऐसे लिंक का उदाहरण दिया गया है जिस पर क्लिक करने से, सोर्स रजिस्टर हो जाएगा:

   <a href="https://shoes.example/landing"
     attributionsrc="http://adtech.example/register-source?..."
     target="_blank">
   Click me</a>
   

   यहां एक ऐसी इमेज का उदाहरण दिया गया है जिसे देखने पर, सोर्स रजिस्टर हो जाएगा:

   <img href="https://advertiser.example/landing"
     attributionsrc="https://adtech.example/register-source?..."/>
   

   इसके अलावा, एचटीएमएल एलिमेंट के बजाय JavaScript कॉल का इस्तेमाल किया जा सकता है.

   यहां window.open() का इस्तेमाल करने वाला JavaScript का एक उदाहरण दिया गया है. ध्यान दें कि यूआरएल को यूआरएल-कोड में बदला गया है, ताकि खास वर्णों से जुड़ी समस्याओं से बचा जा सके.

   const encodedUrl = encodeURIComponent(
     'https://adtech.example/attribution_source?ad_id=...');
   window.open(
     "https://shoes.example/landing",
     "_blank",
     `attributionsrc=${encodedUrl}`);
   

2. जब उपयोगकर्ता विज्ञापन पर क्लिक करता है या उसे देखता है, तो ब्राउज़र, attributionsrc को GET अनुरोध भेजता है. आम तौर पर, यह अनुरोध विज्ञापन देने वाले व्यक्ति या कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी के एंडपॉइंट को भेजा जाता है.

3. यह अनुरोध मिलने पर, विज्ञापन देने वाला व्यक्ति या कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, ब्राउज़र को विज्ञापन के साथ इंटरैक्शन के लिए सोर्स इवेंट रजिस्टर करने का निर्देश देती है. इससे बाद में कन्वर्ज़न को इस विज्ञापन के लिए एट्रिब्यूट किया जा सकता है. इसके लिए, विज्ञापन देने वाला व्यक्ति या कंपनी या विज्ञापन टेक्नोलॉजी उपलब्ध कराने वाली कंपनी, अपने रिस्पॉन्स में एक खास एचटीटीपी हेडर शामिल करती है. यह हेडर में कस्टम डेटा जोड़ता है. इससे सोर्स इवेंट (विज्ञापन पर क्लिक या व्यू) के बारे में जानकारी मिलती है. अगर इस विज्ञापन के लिए कन्वर्ज़न होता है, तो यह कस्टम डेटा आखिर में एट्रिब्यूशन रिपोर्ट में दिखेगा.

   

4. बाद में, उपयोगकर्ता विज्ञापन देने वाले व्यक्ति या कंपनी की साइट पर जाता है.

5. विज्ञापन देने वाले व्यक्ति या कंपनी की साइट के हर काम के पेज पर, कन्वर्ज़न पिक्सल (<img> एलिमेंट) या JavaScript कॉल, https://adtech.example/conversion?param1=...&param2=... से अनुरोध करता है. उदाहरण के लिए, खरीदारी की पुष्टि करने वाला पेज या प्रॉडक्ट पेज.

6. इस यूआरएल पर मौजूद सेवा को अनुरोध मिलता है. आम तौर पर, यह सेवा विज्ञापन देने वाले व्यक्ति या कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी की होती है. यह इसे कन्वर्ज़न के तौर पर कैटगरी में रखता है. इसलिए, इसे ब्राउज़र को कन्वर्ज़न रिकॉर्ड करने का निर्देश देना होगा. इसका मतलब है कि एट्रिब्यूशन को ट्रिगर करना. इसके लिए, विज्ञापन देने वाला व्यक्ति या कंपनी या विज्ञापन टेक्नोलॉजी सेवा देने वाली कंपनी, पिक्सल के अनुरोध के जवाब में एक खास एचटीटीपी हेडर शामिल करती है. इसमें कन्वर्ज़न के बारे में कस्टम डेटा शामिल होता है.

7. उपयोगकर्ता के लोकल डिवाइस पर मौजूद ब्राउज़र को यह जवाब मिलता है. इसके बाद, यह कन्वर्ज़न डेटा को ओरिजनल सोर्स इवेंट (विज्ञापन पर क्लिक या विज्ञापन व्यू) से मैच करता है.

8. ब्राउज़र, attributionsrc को रिपोर्ट भेजने के लिए शेड्यूल करता है. इस रिपोर्ट में यह जानकारी शामिल होती है:

   1. कस्टम एट्रिब्यूशन कॉन्फ़िगरेशन का वह डेटा जिसे विज्ञापन टेक्नोलॉजी सेवा देने वाली कंपनी या विज्ञापन देने वाले व्यक्ति या कंपनी ने तीसरे चरण में सोर्स इवेंट से जोड़ा था.
   2. छठे चरण में कस्टम कन्वर्ज़न डेटासेट.

   

9. इसके बाद, ब्राउज़र attributionsrc में तय किए गए एंडपॉइंट को रिपोर्ट भेजता है. इसमें कुछ समय लगता है और कुछ गड़बड़ियां भी हो सकती हैं. एग्रीगेट की जा सकने वाली रिपोर्ट को एन्क्रिप्ट (सुरक्षित) किया जाता है, जबकि इवेंट-लेवल की रिपोर्ट को एन्क्रिप्ट नहीं किया जाता.

एट्रिब्यूशन ट्रिगर (विज्ञापन देने वाले व्यक्ति या कंपनी की वेबसाइट)

एट्रिब्यूशन ट्रिगर वह इवेंट होता है जो ब्राउज़र को कन्वर्ज़न कैप्चर करने के लिए कहता है.

हमारा सुझाव है कि विज्ञापन देने वाले व्यक्ति या कंपनी के लिए सबसे अहम कन्वर्ज़न कैप्चर करें. जैसे, खरीदारी. खास जानकारी वाली रिपोर्ट में, कन्वर्ज़न टाइप और मेटाडेटा के कई विकल्प कैप्चर किए जा सकते हैं.

इससे यह पुष्टि होती है कि इन इवेंट के लिए एग्रीगेट किए गए नतीजे, सटीक और ज़्यादा जानकारी वाले हैं.

सोर्स को ट्रिगर से मैच करना

जब किसी ब्राउज़र को एट्रिब्यूशन ट्रिगर का रिस्पॉन्स मिलता है, तो ब्राउज़र लोकल स्टोरेज को ऐक्सेस करता है. ऐसा इसलिए, ताकि वह ऐसा सोर्स ढूंढ सके जो एट्रिब्यूशन ट्रिगर के ऑरिजिन और उस पेज के यूआरएल के eTLD+1, दोनों से मेल खाता हो.

उदाहरण के लिए, जब ब्राउज़र को adtech.example से shoes.example/shoes123 पर एट्रिब्यूशन ट्रिगर मिलता है, तो ब्राउज़र, लोकल स्टोरेज में ऐसे सोर्स की तलाश करता है जो adtech.example और shoes.example, दोनों से मेल खाता हो.

फ़िल्टर (या कस्टम नियम) सेट किए जा सकते हैं. इनसे यह तय किया जा सकता है कि किसी ट्रिगर को किसी सोर्स से कब मैच किया जाए. उदाहरण के लिए, किसी खास प्रॉडक्ट कैटगरी के कन्वर्ज़न की गिनती करने के लिए फ़िल्टर सेट करें और अन्य सभी कैटगरी को अनदेखा करें. फ़िल्टर और प्राथमिकता तय करने वाले मॉडल की मदद से, एट्रिब्यूशन रिपोर्टिंग को बेहतर बनाया जा सकता है.

अगर लोकल स्टोरेज में एट्रिब्यूशन के कई सोर्स मिलते हैं, तो ब्राउज़र उस सोर्स को चुनता है जिसे हाल ही में सेव किया गया था. कुछ मामलों में, एट्रिब्यूशन सोर्स को प्राथमिकता दी जाती है. ऐसे में, ब्राउज़र सबसे ज़्यादा प्राथमिकता वाले सोर्स को चुनता है.

डेटा संग्रह

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

खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, एग्रीगेट की जा सकने वाली रिपोर्ट का इस्तेमाल किया जाता है. एग्रीगेट की जा सकने वाली रिपोर्ट, विज्ञापन (पब्लिशर की साइट पर) और कन्वर्ज़न डेटा (विज्ञापन देने वाले व्यक्ति या कंपनी की साइट से) से इकट्ठा किए गए डेटा का कॉम्बिनेशन होती है. इसे उपयोगकर्ता के डिवाइस पर ब्राउज़र जनरेट और एन्क्रिप्ट (सुरक्षित) करता है. इसके बाद, इसे विज्ञापन टेक्नोलॉजी कंपनी इकट्ठा करती है.

इवेंट-लेवल की रिपोर्ट में डेटा आने में दो से 30 दिन लगते हैं. एग्रीगेट की जा सकने वाली रिपोर्ट, एक घंटे के अंदर कुछ समय के लिए रुककर भेजी जाती हैं. साथ ही, इवेंट योगदान बजट के मुताबिक होने चाहिए. इन विकल्पों से निजता को सुरक्षित रखने और किसी भी व्यक्ति की कार्रवाइयों का गलत इस्तेमाल रोकने में मदद मिलती है.

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

खास जानकारी वाली रिपोर्ट जनरेट करना

खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, आपको Aggregation Service का इस्तेमाल करना होगा. इसे विज्ञापन टेक्नोलॉजी कंपनी मैनेज करती है. इसकी मदद से, एग्रीगेट की जा सकने वाली रिपोर्ट प्रोसेस की जाती हैं. Aggregation Service, उपयोगकर्ता की निजता की सुरक्षा के लिए नॉइज़ जोड़ती है और खास जानकारी वाली आखिरी रिपोर्ट दिखाती है.

बैच में एग्रीगेट की जा सकने वाली रिपोर्ट

एग्रीगेट की जा सकने वाली रिपोर्ट को प्रोसेस करने से पहले, उन्हें बैच में रखना ज़रूरी है. बैच में, ऐसी रिपोर्ट को रणनीतिक तरीके से ग्रुप किया जाता है जिन्हें इकट्ठा किया जा सकता है. आपकी रणनीति में, किसी समयावधि (जैसे, हर दिन या हर हफ़्ते) के हिसाब से बदलाव दिखेंगे. यह प्रोसेस उसी सर्वर पर हो सकती है जो आपके रिपोर्टिंग एंडपॉइंट के तौर पर काम करता है.

यह पक्का करने के लिए कि सिग्नल-टू-नॉइज़ रेशियो ज़्यादा हो, बैच में कई रिपोर्ट शामिल होनी चाहिए.

बैच की अवधि को कभी भी बदला जा सकता है, ताकि यह पक्का किया जा सके कि आपने उन खास इवेंट को कैप्चर किया है जहां आपको ज़्यादा वॉल्यूम की उम्मीद है. जैसे, सालाना सेल के लिए. बैचिंग की अवधि को बदला जा सकता है. इसके लिए, एट्रिब्यूशन सोर्स या ट्रिगर बदलने की ज़रूरत नहीं होती.

एग्रीगेशन सेवा

Aggregation Service, एग्रीगेट की जा सकने वाली रिपोर्ट को प्रोसेस करने के लिए ज़िम्मेदार होती है, ताकि खास जानकारी वाली रिपोर्ट जनरेट की जा सके. एग्रीगेट की जा सकने वाली रिपोर्ट को एन्क्रिप्ट (सुरक्षित) किया जाता है. इन्हें सिर्फ़ एग्रीगेशन सेवा पढ़ सकती है. यह सेवा, ट्रस्टेड एक्ज़ीक्यूशन एनवायरमेंट (टीईई) पर काम करती है.

एग्रीगेशन सेवा, डेटा को डिक्रिप्ट और एग्रीगेट करने के लिए, कोऑर्डिनेटर से डिक्रिप्शन कुंजियों का अनुरोध करती है. डिक्रिप्ट और एग्रीगेट करने के बाद, निजता बनाए रखने के लिए नतीजों में नॉइज़ जोड़ा जाता है. इसके बाद, इन्हें खास जानकारी वाली रिपोर्ट के तौर पर दिखाया जाता है.

डॉक्टर, एग्रीगेट की जा सकने वाली क्लियरटेक्स्ट रिपोर्ट जनरेट कर सकते हैं, ताकि वे एग्रीगेशन सेवा को स्थानीय तौर पर टेस्ट कर सकें. इसके अलावा, Nitro Enclaves की मदद से, AWS पर एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट की जांच की जा सकती है.

आगे क्या करना है?

हम आपसे बातचीत करना चाहते हैं, ताकि हम ऐसा एपीआई बना सकें जो सभी के लिए काम करे.

एपीआई के बारे में चर्चा करें

Privacy Sandbox के अन्य एपीआई की तरह, इस एपीआई के बारे में भी दस्तावेज़ मौजूद हैं. साथ ही, इस पर सार्वजनिक तौर पर चर्चा की गई है.

एपीआई के साथ एक्सपेरिमेंट करना

Attribution Reporting API के बारे में बातचीत में एक्सपेरिमेंट किया जा सकता है और हिस्सा लिया जा सकता है.