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

bookmark_border संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

यह लेख किसके लिए है?

आपको यह लेख तब पढ़ना चाहिए, जब:

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

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

खास जानकारी

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

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

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

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

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

• खास जानकारी वाली रिपोर्ट जनरेट करना. एक साथ कई ऐसी रिपोर्ट इकट्ठा करें जिन्हें एग्रीगेट किया जा सकता है. साथ ही, खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, रिपोर्ट को प्रोसेस करने के लिए एग्रीगेशन सेवा का इस्तेमाल करें.

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

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

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

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

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

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

यह तय करने के बाद कि आपको क्या मेज़र करना है, 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});
   

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

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

   

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

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

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

डेटा कलेक्शन

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

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

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

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

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

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

एक साथ कई रिपोर्ट को एग्रीगेट करने की सुविधा

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

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

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

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

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

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

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

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

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

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

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

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

Attribution Reporting API के बारे में बातचीत में प्रयोग करें और हिस्सा लें.