तकनीकी फ़ैसला लेने वालों के लिए, एट्रिब्यूशन रिपोर्टिंग के लिए कनेक्ट की गई सेवाओं की खास जानकारी.
Attribution Reporting API की मदद से, विज्ञापन टेक्नोलॉजी और विज्ञापन देने वाले लोग या कंपनियां, यह मेज़र कर सकती हैं कि किसी विज्ञापन पर क्लिक या व्यू से कब कन्वर्ज़न हुआ, जैसे कि खरीदारी. यह एपीआई, आपके कारोबार की ज़रूरतों के मुताबिक, क्लाइंट-साइड और सर्वर साइड इंटिग्रेशन के कॉम्बिनेशन पर निर्भर करता है.
जारी रखने से पहले, एट्रिब्यूशन रिपोर्टिंग की खास जानकारी ज़रूर पढ़ें. इससे आपको एपीआई के मकसद और अलग-अलग आउटपुट रिपोर्ट के फ़्लो को समझने में मदद मिलेगी (इवेंट लेवल की रिपोर्ट और खास जानकारी वाली रिपोर्ट). अगर आपको ऐसे शब्द दिखते हैं जिनके बारे में आपको जानकारी नहीं है, तो प्राइवसी सैंडबॉक्स की शब्दावली देखें.
यह लेख किसके लिए है?
आपको यह लेख तब पढ़ना चाहिए, जब:
- आप विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी या विज्ञापन देने वाले के तौर पर तकनीकी फ़ैसले लेने वाले हों. आपके पास ऑपरेशन, DevOps, डेटा साइंस, आईटी, मार्केटिंग या किसी अन्य भूमिका में काम करने का विकल्प होता है. आपको यह जानना है कि निजता बनाए रखने से जुड़े मेज़रमेंट के लिए, एपीआई कैसे काम करते हैं.
- आप तकनीकी पेशेवर (जैसे कि डेवलपर, सिस्टम ऑपरेटर, सिस्टम आर्किटेक्ट या डेटा साइंटिस्ट) हैं जो इस एपीआई और एग्रीगेशन सर्विस एनवायरमेंट के साथ प्रयोग सेट अप करेंगे.
इस लेख में, आपको विस्तार से जानकारी मिलेगी कि एट्रिब्यूशन रिपोर्टिंग एपीआई के साथ सेवाएं कैसे काम करती हैं. पूरी जानकारी देने के लिए, पूरी जानकारी पढ़ें. अगर आप तकनीकी पेशेवर हैं, तो इस एपीआई का इस्तेमाल करके स्थानीय तौर पर प्रयोग किया जा सकता है.
खास जानकारी
Attribution Reporting API में कई सेवाएं हैं, जिनके लिए खास सेट अप, क्लाइंट-साइड कॉन्फ़िगरेशन, और सर्वर डिप्लॉयमेंट की ज़रूरत होती है. यह तय करने के लिए कि आपको क्या चाहिए, सबसे पहले:
- डिज़ाइन से जुड़े फ़ैसले लें. तय करें कि आपको कौनसी जानकारी इकट्ठा करनी है, किसी कैंपेन से मिलने वाले कन्वर्ज़न की पहचान करें, और तय करें कि आपको किस तरह की रिपोर्ट इकट्ठा करनी है. आखिरी आउटपुट, दो तरह की रिपोर्ट में से कोई एक या दोनों होता है: इवेंट-लेवल रिपोर्ट और खास जानकारी वाली रिपोर्ट.
रिपोर्टिंग के लिए हमेशा दो (और कभी-कभी तीन) कॉम्पोनेंट एक साथ काम करते हैं:
- वेबसाइट से ब्राउज़र कम्यूनिकेशन तक. कुकी-आधारित सिस्टम में, कन्वर्ज़न और विज्ञापन से जुड़ाव की जानकारी एक आइडेंटिफ़ायर से अटैच हो जाती है. इसकी मदद से, आपको या विश्लेषण करने वाली किसी सेवा को बाद में इन इवेंट में शामिल होने की अनुमति मिलती है. इस एपीआई की मदद से ब्राउज़र, विश्लेषण के लिए डिलीवर होने से पहले आपके निर्देशों के आधार पर कन्वर्ज़न को विज्ञापन पर क्लिक/व्यू के साथ जोड़ता है. इसलिए, आपके विज्ञापन रेंडरिंग कोड और कन्वर्ज़न ट्रैकिंग में:
- ब्राउज़र को बताएं कि कौनसे कन्वर्ज़न का क्रेडिट, किस विज्ञापन पर क्लिक या इंप्रेशन को दिया जाना चाहिए.
- फ़ाइनल रिपोर्ट में शामिल करने के लिए किसी दूसरे डेटा के बारे में बताएं.
- डेटा कलेक्शन. उपयोगकर्ताओं के ब्राउज़र में जनरेट होने वाली रिपोर्ट पाने के लिए, आपको कलेक्टर एंडपॉइंट की ज़रूरत होगी. ब्राउज़र से मिलने वाला आउटपुट, दो संभावित रिपोर्ट में से एक हो सकता है: इवेंट-लेवल की रिपोर्ट और एग्रीगेट की जा सकने वाली रिपोर्ट (जिन्हें एन्क्रिप्ट (सुरक्षित) किया गया है और जिनका इस्तेमाल खास जानकारी वाली रिपोर्ट जनरेट करने के लिए किया जाता है).
अगर आपने इकट्ठा की जा सकने वाली रिपोर्ट इकट्ठा की हैं, तो आपको एक तीसरे कॉम्पोनेंट की ज़रूरत होगी:
- खास जानकारी वाली रिपोर्ट जनरेट करना. बैच में एग्रीगेट की जा सकने वाली रिपोर्ट बनाईं और एग्रीगेशन सर्विस का इस्तेमाल करके रिपोर्ट प्रोसेस करके खास जानकारी रिपोर्ट जनरेट करें.
डिज़ाइन से जुड़े फ़ैसले
एट्रिब्यूशन रिपोर्टिंग का मुख्य सिद्धांत है डिज़ाइन से जुड़े शुरुआती फ़ैसले लेना. आपके पास यह तय करने का विकल्प है कि किस कैटगरी में कौनसा डेटा इकट्ठा किया जाए और उस डेटा को कितनी बार प्रोसेस किया जाए. आउटपुट रिपोर्ट में आपको अपने कैंपेन या कारोबार के बारे में अहम जानकारी मिलती है.
आउटपुट रिपोर्ट यह हो सकती है:
- इवेंट-लेवल रिपोर्ट किसी खास विज्ञापन क्लिक या व्यू (विज्ञापन की साइड में) को कन्वर्ज़न साइड पर मौजूद डेटा से असोसिएट करती हैं. कई साइटों पर उपयोगकर्ता की पहचान को सीमित करके उपयोगकर्ता की निजता बनाए रखने के लिए, कन्वर्ज़न साइड डेटा बहुत सीमित होता है. साथ ही, डेटा में ग़ैर-ज़रूरी जानकारी दिखती है. इसका मतलब है कि कुछ मामलों में, असल रिपोर्ट के बजाय बिना किसी क्रम के डेटा भेजा जाता है.
- खास जानकारी वाली रिपोर्ट, विज्ञापन पर होने वाले किसी खास इवेंट से नहीं जुड़ी होती हैं. इन रिपोर्ट में ज़्यादा जानकारी वाला कन्वर्ज़न डेटा होता है. साथ ही, क्लिक और व्यू डेटा को कन्वर्ज़न डेटा के साथ जोड़ने की सुविधा भी मिलती है.
आपकी चुनी हुई रिपोर्ट से यह तय होता है कि आपको कौनसा डेटा इकट्ठा करना है.
फ़ाइनल आउटपुट को उन टूल के लिए इनपुट के तौर पर भी देखा जा सकता है जिनका इस्तेमाल, फ़ैसले लेने के लिए किया जाता है. उदाहरण के लिए, अगर यह पता लगाने के लिए खास जानकारी वाली रिपोर्ट जनरेट की जाती हैं कि कितने कन्वर्ज़न से कुल खर्च का कोई मान मिला, तो इससे आपकी टीम को यह तय करने में मदद मिल सकती है कि ज़्यादा कुल खर्च जनरेट करने के लिए, आपके अगले विज्ञापन कैंपेन को क्या टारगेट करना चाहिए.
किस चीज़ को मेज़र करना है यह तय कर लेने के बाद, Attribution Reporting API के लिए क्लाइंट-साइड सेट अप किया जा सकता है.
वेबसाइट से ब्राउज़र कम्यूनिकेशन तक
एट्रिब्यूशन इवेंट का फ़्लो
मान लें कि कोई पब्लिशर साइट विज्ञापन दिखाती है. विज्ञापन देने वाली हर कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, अपने विज्ञापनों के साथ होने वाले इंटरैक्शन के बारे में जानना चाहती है और कन्वर्ज़न का क्रेडिट सही विज्ञापन को देना चाहती है. रिपोर्ट (इवेंट-लेवल और एग्रीगेटेड, दोनों) इस तरह जनरेट होंगी:
पब्लिशर की साइट पर, किसी विज्ञापन एलिमेंट (
<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 कॉल का इस्तेमाल किया जा सकता है.
यहां JavaScript का एक उदाहरण दिया गया है, जिसमें
window.open()
का इस्तेमाल किया गया है. ध्यान दें कि यूआरएल को कोड में बदला गया है, ताकि खास वर्णों वाली समस्याओं से बचा जा सके.const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- जब उपयोगकर्ता विज्ञापन पर क्लिक करता है या उसे देखता है, तो ब्राउज़र
attributionsrc
कोGET
अनुरोध भेजता है. आम तौर पर, यह अनुरोध विज्ञापन देने वाली कंपनी या विज्ञापन टेक्नोलॉजी की सेवा देने वाली कंपनी का एंडपॉइंट होता है. यह अनुरोध मिलने पर, विज्ञापन देने वाली कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, ब्राउज़र को यह निर्देश देती है कि वह विज्ञापन के साथ इंटरैक्शन के लिए सोर्स इवेंट रजिस्टर करे, ताकि बाद में इस विज्ञापन से कन्वर्ज़न को एट्रिब्यूट किया जा सके. ऐसा करने के लिए, विज्ञापन देने वाला या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी अपने जवाब में एक खास एचटीटीपी हेडर शामिल करती है. यह इस हेडर कस्टम डेटा से जुड़ जाता है, जो सोर्स इवेंट (विज्ञापन पर क्लिक या व्यू) के बारे में जानकारी देता है—अगर इस विज्ञापन के लिए कोई कन्वर्ज़न हो जाता है, तो यह कस्टम डेटा आखिर में एट्रिब्यूशन रिपोर्ट में दिखेगा.
बाद में, उपयोगकर्ता विज्ञापन देने वाले की साइट पर जाता है.
विज्ञापन देने वाले की साइट के हर काम के पेज—उदाहरण के लिए, खरीदारी की पुष्टि करने वाला पेज या प्रॉडक्ट पेज—कन्वर्ज़न पिक्सल (
<img>
एलिमेंट) या JavaScript कॉल,https://adtech.example/conversion?param1=...¶m2=...
पर एक अनुरोध भेजता है.इस यूआरएल पर मौजूद सेवा—आम तौर पर, विज्ञापन देने वाले या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी को अनुरोध मिलता है. उसने इसे कन्वर्ज़न की कैटगरी में रखने का फ़ैसला किया है, ताकि ब्राउज़र को किसी कन्वर्ज़न को रिकॉर्ड करने का निर्देश दिया जाए. ऐसा एट्रिब्यूशन ट्रिगर करने के लिए किया जाता है. इसके लिए, विज्ञापन देने वाली कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, पिक्सल के अनुरोध के जवाब में एक खास एचटीटीपी हेडर शामिल करती है. इस हेडर में कन्वर्ज़न के बारे में कस्टम डेटा शामिल होता है.
उपयोगकर्ता के लोकल डिवाइस पर मौजूद ब्राउज़र को यह रिस्पॉन्स मिलता है. साथ ही, यह कन्वर्ज़न डेटा को ओरिजनल सोर्स इवेंट (विज्ञापन पर क्लिक या व्यू) से मैच करता है. ट्रिगर से सोर्स को मैच करना सेक्शन में ज़्यादा जानें
ब्राउज़र, रिपोर्ट को
attributionsrc
को भेजने के लिए शेड्यूल करता है. इस रिपोर्ट में शामिल हैं:- कस्टम एट्रिब्यूशन कॉन्फ़िगरेशन डेटा, जिसे विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी या विज्ञापन देने वाले व्यक्ति या कंपनी ने तीसरे चरण में सोर्स इवेंट से अटैच किया है.
- कस्टम कन्वर्ज़न डेटा, छठे चरण में सेट किया गया है.
बाद में, ब्राउज़र, डेटा को
attributionsrc
में तय किए गए एंडपॉइंट पर भेजता है. डेटा को प्रोसेस होने में थोड़ी देर और किसी भी तरह की देरी नहीं होती है. एग्रीगेट की जा सकने वाली रिपोर्ट एन्क्रिप्ट (सुरक्षित) की जाती हैं, जबकि इवेंट-लेवल की रिपोर्ट को नहीं.
एट्रिब्यूशन ट्रिगर (विज्ञापन देने वाले की वेबसाइट)
एट्रिब्यूशन ट्रिगर एक ऐसा इवेंट है जो ब्राउज़र को कन्वर्ज़न कैप्चर करने के लिए कहता है.
हमारा सुझाव है कि आप ऐसे कन्वर्ज़न कैप्चर करें जो विज्ञापन देने वाले के लिए सबसे ज़रूरी हैं, जैसे कि खरीदारी. खास जानकारी वाली रिपोर्ट में कई कन्वर्ज़न के टाइप और मेटाडेटा कैप्चर किए जा सकते हैं.
इससे यह पक्का होता है कि सभी इवेंट के नतीजे पूरी और सटीक हों.
ट्रिगर के लिए सोर्स का मिलान करें
जब किसी ब्राउज़र को एट्रिब्यूशन ट्रिगर से जुड़ा कोई रिस्पॉन्स मिलता है, तो ब्राउज़र लोकल स्टोरेज को ऐक्सेस करके ऐसा सोर्स ढूंढता है जो एट्रिब्यूशन ट्रिगर के ऑरिजिन और उस पेज यूआरएल के eTLD+1, दोनों से मेल खाता हो.
उदाहरण के लिए, जब ब्राउज़र को shoes.example/shoes123
पर adtech.example
से कोई एट्रिब्यूशन ट्रिगर मिलता है, तो ब्राउज़र लोकल स्टोरेज में उस सोर्स की खोज करता है जो adtech.example
और shoes.example
, दोनों से मेल खाता हो.
फ़िल्टर (या पसंद के मुताबिक नियम) को सेट करके यह तय किया जा सकता है कि ट्रिगर का किसी खास सोर्स से कब मैच हुआ. उदाहरण के लिए, किसी खास प्रॉडक्ट कैटगरी के लिए सिर्फ़ कन्वर्ज़न की गिनती करने के लिए फ़िल्टर सेट करें और दूसरी सभी कैटगरी को अनदेखा करें. फ़िल्टर और प्राथमिकता वाले मॉडल की मदद से, एट्रिब्यूशन की बेहतर रिपोर्टिंग की जा सकती है.
अगर लोकल स्टोरेज में एक से ज़्यादा एट्रिब्यूशन सोर्स मिलते हैं, तो ब्राउज़र हाल ही में सेव किए गए सोर्स को चुनता है. कुछ मामलों में जहां एट्रिब्यूशन सोर्स को प्राथमिकता दी जाती है, वहां ब्राउज़र सबसे ज़्यादा प्राथमिकता वाले सोर्स को चुनता है.
डेटा कलेक्शन
साथ मिलकर, एट्रिब्यूशन ट्रिगर किसी संबंधित सोर्स से मेल खाता है और उसे ब्राउज़र से रिपोर्ट के तौर पर विज्ञापन टेक्नोलॉजी के मालिकाना हक वाले सर्वर पर, रिपोर्टिंग एंडपॉइंट को भेजा जाता है. इसे कभी-कभी कलेक्शन एंडपॉइंट या कलेक्शन सेवा भी कहा जाता है. ये रिपोर्ट, इवेंट-लेवल की रिपोर्ट या एग्रीगेट की जा सकने वाली रिपोर्ट हो सकती हैं.
एग्रीगेट की जा सकने वाली रिपोर्ट का इस्तेमाल, खास जानकारी वाली रिपोर्ट जनरेट करने के लिए किया जाता है. एग्रीगेटेड रिपोर्ट, विज्ञापन (पब्लिशर की साइट पर) से इकट्ठा किए गए डेटा और कन्वर्ज़न डेटा (विज्ञापन देने वाले की साइट से) से इकट्ठा किए गए डेटा को मिलाकर बनती है. इस डेटा को विज्ञापन टेक्नोलॉजी की मदद से इकट्ठा करने से पहले, उपयोगकर्ता के डिवाइस पर ब्राउज़र जनरेट और एन्क्रिप्ट (सुरक्षित) करता है.
इवेंट लेवल की रिपोर्ट को प्रोसेस होने में 2 से 30 दिन लगते हैं. एग्रीगेट की जा सकने वाली रिपोर्ट, एक घंटे के अंदर किसी भी देरी से भेजी जाती हैं और इवेंट, योगदान के बजट में फ़िट होने चाहिए. ये विकल्प निजता की सुरक्षा करते हैं और किसी भी उपयोगकर्ता की कार्रवाइयों के गलत इस्तेमाल को रोकते हैं.
अगर आपकी दिलचस्पी सिर्फ़ इवेंट-लेवल की रिपोर्ट में है, तो यह आपके लिए ज़रूरी इंफ़्रास्ट्रक्चर का आखिरी हिस्सा है. हालांकि, अगर आपको खास जानकारी वाली रिपोर्ट जनरेट करनी हैं, तो आपको अतिरिक्त सेवा के साथ इकट्ठा की जा सकने वाली रिपोर्ट को प्रोसेस करना होगा.
खास जानकारी वाली रिपोर्ट जनरेट करना
खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, आपको एग्रीगेशन सेवा का इस्तेमाल करना होगा. इस सेवा को विज्ञापन टेक्नोलॉजी उपलब्ध कराती है. ऐसा करके, इकट्ठा की जा सकने वाली रिपोर्ट प्रोसेस की जा सकती हैं. एग्रीगेशन सेवा, उपयोगकर्ता की निजता को सुरक्षित रखने के लिए ग़ैर-ज़रूरी आवाज़ों का इस्तेमाल करती है. साथ ही, यह खास जानकारी वाली आखिरी रिपोर्ट दिखाती है.
बैच की गई एग्रीगेटेड रिपोर्ट
इकट्ठा की जा सकने वाली रिपोर्ट को प्रोसेस करने से पहले, उन्हें बैच करना ज़रूरी है. एक बैच में, रणनीतिक तौर पर ग्रुप की गई एग्रीगेट की जा सकने वाली रिपोर्ट होती हैं. इस बात की संभावना काफ़ी ज़्यादा है कि आपकी रणनीति में किसी खास समयावधि (जैसे कि हर दिन या हर हफ़्ते) के बारे में बताया जाए. यह प्रोसेस उसी सर्वर पर हो सकती है जो आपके रिपोर्टिंग एंडपॉइंट के तौर पर काम करता है.
बैच में कई रिपोर्ट शामिल होनी चाहिए, ताकि यह पक्का किया जा सके कि सिग्नल-शोर का अनुपात ज़्यादा है.
बैच पीरियड किसी भी समय बदल सकते हैं, ताकि आप ऐसे खास इवेंट कैप्चर कर सकें जिनके ज़्यादा वॉल्यूम की उम्मीद होती है, जैसे कि सालाना सेल. बैचिंग अवधि को एट्रिब्यूशन सोर्स या ट्रिगर में बदलाव किए बिना बदला जा सकता है.
एग्रीगेशन सेवा
एग्रीगेशन सेवा की ज़िम्मेदारी है कि वह इकट्ठा की जा सकने वाली रिपोर्ट को प्रोसेस करके, खास जानकारी वाली रिपोर्ट जनरेट करे. एग्रीगेट की जा सकने वाली रिपोर्ट एन्क्रिप्ट (सुरक्षित) की जाती हैं और इन्हें सिर्फ़ एग्रीगेशन सेवा के ज़रिए पढ़ा जा सकता है. एग्रीगेशन सर्विस एक भरोसेमंद प्रोग्राम (टीईई) पर काम करती है.
एग्रीगेशन सेवा, डेटा को डिक्रिप्ट और एग्रीगेट करने के लिए, कोऑर्डिनेटर से डिक्रिप्शन कुंजियों का अनुरोध करती है. डिक्रिप्ट करने और इकट्ठा करने के बाद, नतीजों को निजता बनाए रखने के लिए शोर किया जाता है और एक खास जानकारी वाली रिपोर्ट के तौर पर दिखाया जाता है.
एग्रीगेशन सेवा को स्थानीय तौर पर टेस्ट करने के लिए, डॉक्टर एग्रीगेटेड क्लियर टेक्स्ट रिपोर्ट जनरेट कर सकते हैं. इसके अलावा, Nclaves की मदद से AWS पर एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट की जांच की जा सकती है.
आगे क्या करना है?
हम आपके साथ बातचीत करना चाहते हैं, ताकि हम ऐसा एपीआई बना सकें जो सभी के काम आए.
एपीआई के बारे में चर्चा करें
प्राइवसी सैंडबॉक्स के अन्य एपीआई की तरह, इस एपीआई को भी दस्तावेज़ के तौर पर दर्ज किया गया है और सार्वजनिक तौर पर इसकी चर्चा की गई है.
एपीआई के साथ प्रयोग करें
Attribution Reporting API के बारे में बातचीत में, एक्सपेरिमेंट के साथ-साथ उसमें हिस्सा भी लिया जा सकता है.