एट्रिब्यूशन रिपोर्टिंग के लिए कनेक्ट की गई सेवाओं के बारे में खास जानकारी. यह खास जानकारी, तकनीकी तौर पर ज़रूरी फ़ैसले लेने वालों के लिए है.
Attribution Reporting API की मदद से, विज्ञापन टेक्नोलॉजी और विज्ञापन देने वाली कंपनियां यह मेज़र कर सकती हैं कि किसी विज्ञापन पर मिले क्लिक या व्यू से कन्वर्ज़न होता है, जैसे कि खरीदारी. यह एपीआई इन चीज़ों पर निर्भर करता है क्लाइंट-साइड और सर्वर-साइड इंटिग्रेशन का मिला-जुला रूप इस्तेमाल करते हैं. कारोबार की ज़रूरतों को पूरा करता है.
आगे बढ़ने से पहले, एट्रिब्यूशन रिपोर्टिंग की खास जानकारी. इससे आपको एपीआई का मकसद और अलग-अलग आउटपुट रिपोर्ट के फ़्लो को समझने में मदद मिलेगी (इवेंट-लेवल की रिपोर्ट और खास जानकारी वाली रिपोर्ट देखें). अगर आपको अनजान शब्द दिखते हैं, तो Privacy Sandbox की ग्लॉसरी.
यह लेख किसके लिए है?
आपको यह लेख तब पढ़ना चाहिए, जब:
- आप विज्ञापन टेक्नोलॉजी या विज्ञापन देने वाले व्यक्ति या कंपनी के तकनीकी फ़ैसले लेने वाले हों. आप काम कर सकते हैं ऑपरेशन, DevOps, डेटा साइंस, आईटी, मार्केटिंग या किसी अन्य ऐसी भूमिका में हैं जहां तकनीकी तौर पर लागू करने से जुड़े फ़ैसले लिए जा सकते हैं. आपको यह जानना है कि निजता बनाए रखने वाले मेज़रमेंट के लिए, एपीआई कैसे काम करते हैं.
- आप एक तकनीकी विशेषज्ञ हैं (जैसे कि डेवलपर, सिस्टम ऑपरेटर, या डेटा साइंटिस्ट) के साथ मिलकर काम करता है, जो इस एपीआई और एग्रीगेशन सेवा के एनवायरमेंट की जानकारी दें.
इस लेख में, आप यह जानेंगे कि कैसे ये सेवाएं Attribution Reporting API के लिए काम करती हैं. अगर आप तकनीकी पेशेवर के तौर पर, इस एपीआई का इस्तेमाल करके एक्सपेरिमेंट करें स्थानीय रूप से.
खास जानकारी
Attribution Reporting API में कई सेवाएं शामिल हैं. इन सेवाओं के लिए, कुछ खास सेटअप, क्लाइंट-साइड कॉन्फ़िगरेशन, और सर्वर डिप्लॉयमेंट. यह तय करने के लिए कि क्या सबसे पहले:
- डिज़ाइन से जुड़े फ़ैसले लेना. तय करें कि आपको किस तरह की जानकारी इकट्ठा करनी है, किसी कैंपेन से आपको किस तरह के कन्वर्ज़न की उम्मीद है, और किस तरह की रिपोर्ट इकट्ठा करनी है. आखिरी आउटपुट इन दो रिपोर्ट टाइप में से एक या दोनों तरह की होती है: इवेंट-लेवल की रिपोर्ट और खास जानकारी वाली रिपोर्ट.
रिपोर्टिंग के लिए हमेशा दो (और कभी-कभी तीन) कॉम्पोनेंट एक साथ काम करते हैं:
- वेबसाइट से ब्राउज़र कम्यूनिकेशन. तय सीमा में
कुकी-आधारित सिस्टम के आधार पर, कन्वर्ज़न और विज्ञापन से जुड़ी यूज़र ऐक्टिविटी की जानकारी
किसी ऐसे आइडेंटिफ़ायर से अटैच किया गया हो जो आपको या आंकड़ों की सेवा देने वाली किसी कंपनी को
बाद में बंद कर सकते हैं. इस एपीआई की मदद से, ब्राउज़र कन्वर्ज़न को
आपके निर्देशों के आधार पर, विज्ञापन पर क्लिक/व्यू
विश्लेषण करें. इसलिए, आपके विज्ञापन को रेंडर करने वाले कोड और कन्वर्ज़न ट्रैकिंग के लिए ज़रूरी है कि:
- ब्राउज़र को बताएं कि कौनसे कन्वर्ज़न का एट्रिब्यूट किस विज्ञापन को दिया जाना चाहिए क्लिक या इंप्रेशन की संख्या.
- फ़ाइनल रिपोर्ट में शामिल करने के लिए, कोई दूसरा डेटा दिखाएं.
- डेटा कलेक्शन. इसके लिए आपको कलेक्टर एंडपॉइंट की ज़रूरत होगी उन्हें रिपोर्ट मिलती हैं, जो उपयोगकर्ताओं की ब्राउज़र खोलें. ब्राउज़र से मिला आउटपुट दो संभावित रिपोर्ट में से एक हो सकती है: इवेंट-लेवल रिपोर्ट और एग्रीगेट की जा सकने वाली रिपोर्ट रिपोर्ट (जो एन्क्रिप्ट की गई होती हैं और जिनका इस्तेमाल खास जानकारी वाली रिपोर्ट जनरेट करने के लिए किया जाता है).
अगर आपने एग्रीगेट की जा सकने वाली रिपोर्ट इकट्ठा की हैं, तो आपको किसी तीसरे कॉम्पोनेंट की ज़रूरत होगी:
- खास जानकारी वाली रिपोर्ट जनरेट करना. बैच एग्रीगेट की जा सकने वाली रिपोर्ट और रिपोर्ट प्रोसेस करने के लिए एग्रीगेशन सेवा का इस्तेमाल करना खास जानकारी वाली रिपोर्ट जनरेट करें.
डिज़ाइन से जुड़े फ़ैसले
एट्रिब्यूशन रिपोर्टिंग का मुख्य सिद्धांत है डिज़ाइन के शुरुआती फ़ैसले लेना. आप तय करें किस कैटगरी में कौनसा डेटा इकट्ठा करना है और उसे कितनी बार प्रोसेस करना है डेटा शामिल है. आउटपुट रिपोर्ट से, आपके कैंपेन या कारोबार के बारे में अहम जानकारी मिलती है.
आउटपुट रिपोर्ट इनमें से कोई एक हो सकती है:
- इवेंट-लेवल की रिपोर्ट में, किसी खास विज्ञापन क्लिक या व्यू (विज्ञापन के किनारे) को कन्वर्ज़न साइड के डेटा के साथ जोड़ा जाता है. अलग-अलग साइटों पर उपयोगकर्ता की पहचान को सीमित करके, उपयोगकर्ता की निजता बनाए रखने के लिए, कन्वर्ज़न के तौर पर दिया गया डेटा बहुत सीमित होता है. साथ ही, डेटा में शोर भी होता है. इसका मतलब है कि कुछ मामलों में, असली रिपोर्ट के बजाय रैंडम डेटा भेजा जाता है.
- खास जानकारी वाली रिपोर्ट, विज्ञापन साइड पर किसी खास इवेंट से जुड़ी नहीं होतीं. इन रिपोर्ट से, ज़्यादा जानकारी वाला कन्वर्ज़न डेटा मिलता है. साथ ही, क्लिक और व्यू डेटा को कन्वर्ज़न डेटा के साथ जोड़ने की सुविधा भी मिलती है.
आपकी चुनी हुई रिपोर्ट से यह तय होता है कि आपको कौनसा डेटा इकट्ठा करना होगा.
फ़ाइनल आउटपुट को एक ऐसे टूल के तौर पर भी देखा जा सकता है जिसका इस्तेमाल फ़ैसले लेने में मदद मिलती है. उदाहरण के लिए, अगर आपने यह तय करने के लिए समरी रिपोर्ट जनरेट की हैं कि कई कन्वर्ज़न से कुल खर्च मूल्य मिला, जिससे आपकी टीम को यह तय करने में मदद मिल सकती है ज़्यादा कुल खर्च जनरेट करने के लिए, आपके अगले विज्ञापन कैंपेन को क्या टारगेट करना चाहिए.
क्या मेज़र करना है, यह तय करने के बाद क्लाइंट-साइड सेट अप करें Attribution Reporting API के लिए.
वेबसाइट से ब्राउज़र कम्यूनिकेशन
![पब्लिशर की वेबसाइट पर मौजूद एट्रिब्यूशन सोर्स, विज्ञापन देने वाले की वेबसाइट पर ट्रिगर से कनेक्ट होते हैं.](https://developers.google.cn/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=4&hl=hi)
एट्रिब्यूशन इवेंट फ़्लो
कल्पना करें कि एक प्रकाशक साइट है जो विज्ञापन दिखाती है. विज्ञापन देने वाली हर कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली हर कंपनी, अपने विज्ञापनों के साथ होने वाले इंटरैक्शन के बारे में जानना चाहती है. साथ ही, कन्वर्ज़न का क्रेडिट सही विज्ञापन को देना चाहती है. रिपोर्ट (इवेंट-लेवल और एग्रीगेटेबल, दोनों) इस तरह जनरेट होंगी:
पब्लिशर की साइट पर, विज्ञापन एलिमेंट (
<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});
- जब उपयोगकर्ता विज्ञापन पर क्लिक करता है या उसे देखता है, तो ब्राउज़र,
attributionsrc
कोGET
का अनुरोध भेजता है. आम तौर पर, यह अनुरोध विज्ञापन देने वाले या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी के एंडपॉइंट को भेजा जाता है. यह अनुरोध मिलने के बाद, विज्ञापन देने वाली कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, ब्राउज़र को विज्ञापन के साथ इंटरैक्शन के लिए सोर्स इवेंट रजिस्टर करने का निर्देश देती है, ताकि बाद में कन्वर्ज़न को इस विज्ञापन के लिए एट्रिब्यूट किया जा सके. ऐसा करने के लिए, विज्ञापन देने वाली कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, अपने रिस्पॉन्स में एक खास एचटीटीपी हेडर शामिल करती है. यह हेडर कस्टम डेटा से जुड़ जाता है, जो सोर्स इवेंट (विज्ञापन पर क्लिक या व्यू) के बारे में जानकारी देता है—अगर इस विज्ञापन के लिए कोई कन्वर्ज़न होता है, तो यह कस्टम डेटा एट्रिब्यूशन रिपोर्ट में दिखेगा.
बाद में, उपयोगकर्ता विज्ञापन देने वाले की साइट पर जाता है.
विज्ञापन देने वाले की साइट के हर काम के पेज—उदाहरण के लिए, खरीदारी की पुष्टि वाला पेज या प्रॉडक्ट पेज पर, कन्वर्ज़न पिक्सल (
<img>
एलिमेंट) या JavaScript कॉल की मदद से,https://adtech.example/conversion?param1=...¶m2=...
के लिए अनुरोध किया जाता है.इस यूआरएल पर मौजूद सेवा—आम तौर पर, विज्ञापन देने वाले या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी को अनुरोध मिलता है. यह प्लैटफ़ॉर्म, कन्वर्ज़न की कैटगरी तय करता है. इसलिए, इसे ब्राउज़र को कन्वर्ज़न रिकॉर्ड करने का निर्देश देना होगा—यानी कि एट्रिब्यूशन ट्रिगर करना. ऐसा करने के लिए, विज्ञापन देने वाली कंपनी या विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी, पिक्सल के अनुरोध के जवाब में एक खास एचटीटीपी हेडर शामिल करती है. इस हेडर में, कन्वर्ज़न के बारे में कस्टम डेटा शामिल होता है.
उपयोगकर्ता के लोकल डिवाइस पर मौजूद ब्राउज़र को यह रिस्पॉन्स मिलता है और यह कन्वर्ज़न डेटा को ओरिजनल सोर्स इवेंट (विज्ञापन पर क्लिक या व्यू) से मैच करता है. ज़्यादा जानने के लिए, ट्रिगर से सोर्स का मिलान करना लेख पढ़ें
ब्राउज़र,
attributionsrc
पर रिपोर्ट भेजने के लिए शेड्यूल करता है. इस रिपोर्ट में ये चीज़ें शामिल होती हैं:- कस्टम एट्रिब्यूशन कॉन्फ़िगरेशन डेटा, जिसे विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनी या विज्ञापन देने वाले व्यक्ति या कंपनी ने तीसरे चरण में, सोर्स इवेंट से अटैच किया है.
- कस्टम कन्वर्ज़न डेटा सेट, छठे चरण में है.
इसके बाद, ब्राउज़र कुछ देरी और शोर के साथ,
attributionsrc
में तय किए गए एंडपॉइंट पर रिपोर्ट भेजता है. एग्रीगेट की जा सकने वाली रिपोर्ट एन्क्रिप्ट (सुरक्षित) की जाती हैं, जबकि इवेंट-लेवल की रिपोर्ट नहीं.
एट्रिब्यूशन ट्रिगर (विज्ञापन देने वाले की वेबसाइट)
एट्रिब्यूशन ट्रिगर वह इवेंट है जो ब्राउज़र को कन्वर्ज़न कैप्चर करने के लिए कहता है.
हम उन कन्वर्ज़न को कैप्चर करने का सुझाव देते हैं जो आपके कैंपेन के लिए सबसे ज़रूरी हैं जैसे कि खरीदारी. कन्वर्ज़न के अलग-अलग टाइप और मेटाडेटा खास जानकारी वाली रिपोर्ट में शामिल किया जाता है.
इससे यह पक्का होता है कि इन इवेंट के लिए एग्रीगेट नतीजे ज़्यादा जानकारी वाले और सटीक हैं.
सोर्स को ट्रिगर से मैच करें
जब किसी ब्राउज़र को एट्रिब्यूशन ट्रिगर का रिस्पॉन्स मिलता है, तो लोकल स्टोरेज का इस्तेमाल करके, उस सोर्स को ढूंढा जा सकता है जो एट्रिब्यूशन ट्रिगर, दोनों से मैच करता हो ऑरिजिन और उस पेज का यूआरएल eTLD+1 के साथ सबमिट किया गया है.
उदाहरण के लिए, जब ब्राउज़र को Google से कोई एट्रिब्यूशन ट्रिगर मिलता है
shoes.example/shoes123
पर adtech.example
, ब्राउज़र इसमें स्रोत ढूंढता है
लोकल स्टोरेज जो adtech.example
और shoes.example
, दोनों से मेल खाता है.
किसी ट्रिगर के मेल खाने की तारीख तय करने के लिए फ़िल्टर (या पसंद के मुताबिक बनाए गए नियम) सेट किए जा सकते हैं एक सटीक सोर्स होता है. उदाहरण के लिए, खास प्रॉडक्ट कैटगरी के लिए चुनें और अन्य सभी कैटगरी को अनदेखा करें. फ़िल्टर और प्राथमिकता वाले मॉडल की मदद से, बेहतर एट्रिब्यूशन रिपोर्टिंग की जा सकती है.
अगर लोकल स्टोरेज में एक से ज़्यादा एट्रिब्यूशन सोर्स मिलते हैं, तो ब्राउज़र जिसे सबसे हाल में सेव किया गया था. कुछ मामलों में जहां एट्रिब्यूशन सोर्स को प्राथमिकता दी जाती है, तो ब्राउज़र प्राथमिकता तय करें.
डेटा संग्रह
एक साथ, किसी संबंधित स्रोत से मेल खाने वाले एट्रिब्यूशन ट्रिगर को इस रूप में भेजा जाता है विज्ञापन टेक्नोलॉजी के मालिकाना हक वाले सर्वर पर, ब्राउज़र से रिपोर्टिंग एंडपॉइंट की रिपोर्ट (इसे कभी-कभी कलेक्शन एंडपॉइंट या कलेक्शन सर्विस भी कहा जाता है). ये रिपोर्ट, इवेंट-लेवल की रिपोर्ट या एग्रीगेट की जा सकने वाली रिपोर्ट हो सकती हैं.
एग्रीगेट की जा सकने वाली रिपोर्ट का इस्तेमाल खास जानकारी वाली रिपोर्ट जनरेट करने के लिए किया जाता है. एग्रीगेट की जा सकने वाली रिपोर्ट, (पब्लिशर की साइट पर) और कन्वर्ज़न डेटा (पब्लिशर की साइट पर) से इकट्ठा किए गए डेटा विज्ञापन देने वाले की साइट) होती है, जो ब्राउज़र के माध्यम से उपयोगकर्ता के डिवाइस पर मौजूद डेटा को इकट्ठा करने से पहले.
इवेंट-लेवल की रिपोर्ट मिलने में 2 से 30 दिन लग सकते हैं. एग्रीगेट की जा सकने वाली रिपोर्ट एक घंटे के भीतर किसी भी क्रम में देर से भेजा जाता है और इवेंट योगदान के लिए बजट. इन सेटिंग की मदद से, आपकी निजता की सुरक्षा की जाती है. साथ ही, उपयोगकर्ता की कार्रवाइयों के गलत इस्तेमाल को रोकने में भी मदद मिलती है.
अगर आपकी दिलचस्पी सिर्फ़ इवेंट-लेवल की रिपोर्ट में है, तो यह आखिरी हिस्सा है किया जा सकता है. हालांकि, अगर आपको खास जानकारी वाली रिपोर्ट जनरेट करनी हैं, तो आपको एक अतिरिक्त सेवा के साथ एग्रीगेट की जा सकने वाली रिपोर्ट प्रोसेस करनी होंगी.
खास जानकारी वाली रिपोर्ट जनरेट करना
खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, एग्रीगेशन सेवा (इसे AdTech की ओर से मैनेज किया जाता है). इनका इस्तेमाल, एग्रीगेट की जा सकने वाली रिपोर्ट को प्रोसेस करने के लिए किया जाता है. द एग्रीगेशन यह सेवा, उपयोगकर्ता की निजता को सुरक्षित रखने के लिए ग़ैर-ज़रूरी जानकारी शामिल करती है. साथ ही, खास जानकारी वाली फ़ाइनल रिपोर्ट दिखाती है.
![एग्रीगेट की जा सकने वाली रिपोर्ट को इकट्ठा किया जाता है, बैच बनाया जाता है, और AdTech एनवायरमेंट में भेजा जाता है.](https://developers.google.cn/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=4&hl=hi)
इकट्ठा की गई एग्रीगेशन रिपोर्ट के बैच को तैयार करने के बाद, बैच को प्रोसेस किया जाता है एग्रीगेशन सेवा के ज़रिए. ऐप्लिकेशन कोऑर्डिनेटर यह डिक्रिप्शन कुंजियां सिर्फ़ एग्रीगेशन के पुष्टि किए गए वर्शन को देता है सेवा. इसके बाद, एग्रीगेशन सेवा डेटा को डिक्रिप्ट करती है और डेटा को इकट्ठा करती है उसे, और सारांश रिपोर्ट के रूप में परिणाम लौटाने से पहले शोर जोड़ें.
बैच की गई एग्रीगेट करने लायक रिपोर्ट
एग्रीगेट की जा सकने वाली रिपोर्ट प्रोसेस होने से पहले, उन्हें बैच में भेजना ज़रूरी है. बैच में रणनीति बनाकर ग्रुप की गई, एग्रीगेट की जा सकने वाली रिपोर्ट शामिल होती हैं. आपकी रणनीति से किसी समयावधि (जैसे कि हर दिन या हर हफ़्ते) के हिसाब से होने की संभावना होती है. यह यह प्रोसेस उसी सर्वर पर हो सकती है जो आपके रिपोर्टिंग एंडपॉइंट के तौर पर काम करता है.
बैच में कई रिपोर्ट होनी चाहिए, ताकि यह पक्का किया जा सके कि सिग्नल-टू-नॉइज़ रेशियो ज़्यादा है.
![समयावधि ज़्यादा होने की वजह से, ज़्यादा शोर वाले नतीजे नहीं मिलते.](https://developers.google.cn/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=4&hl=hi)
बैच पीरियड किसी भी समय बदल सकते हैं, ताकि यह पक्का किया जा सके कि आपने खास इवेंट कैप्चर किए हैं जहां आपको ज़्यादा वॉल्यूम की उम्मीद हो, जैसे कि सालाना सेल. एक साथ कई आइटम तैयार करने की अवधि एट्रिब्यूशन सोर्स या ट्रिगर को बदले बिना बदला जा सकता है.
एग्रीगेशन सेवा
एग्रीगेशन सेवा की ज़िम्मेदारी यह है कि वह एग्रीगेट की जा सकने वाली रिपोर्ट को इस तरह प्रोसेस करे: खास जानकारी वाली रिपोर्ट जनरेट करें. एग्रीगेट की जा सकने वाली रिपोर्ट एन्क्रिप्ट (सुरक्षित) की जाती हैं. इन्हें सिर्फ़ एग्रीगेशन सेवा से पढ़ता है. यह सेवा भरोसेमंद एक्ज़ीक्यूशन एनवायरमेंट पर चलती है (टीईई).
एग्रीगेशन सेवा, कोऑर्डिनेटर से डिक्रिप्शन कुंजियों का अनुरोध करती है की मदद से डेटा को डिक्रिप्ट और इकट्ठा किया जा सकता है. डिक्रिप्ट और एग्रीगेट किए जाने के बाद, नतीजे निजता बनाए रखने के लिए नॉइज़ किया जाता है और इन्हें खास जानकारी वाली रिपोर्ट के तौर पर दिखाया जाता है.
प्रैक्टिस करने वाले लोग, ऐप्लिकेशन की मदद से इकट्ठा की जा सकने वाली क्लियरटेक्स्ट रिपोर्ट जनरेट कर सकते हैं एग्रीगेशन सेवा की स्थानीय जांच करें. इसके अलावा, नाइट्रो एनक्लेव की मदद से, AWS पर एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट की मदद से टेस्ट किया जा सकता है.
आगे क्या करना है?
हम आपके साथ बातचीत करना चाहते हैं, ताकि हम ऐसा एपीआई बना सकें सभी के लिए उपयोगी हो.
इस एपीआई के बारे में चर्चा करें
प्राइवसी सैंडबॉक्स के अन्य एपीआई की तरह, इस एपीआई को भी दस्तावेज़ में शामिल किया गया है और सार्वजनिक रूप से चर्चा की गई.
एपीआई का इस्तेमाल करके एक्सपेरिमेंट करना
आपके पास एक्सपेरिमेंट करने और इसमें हिस्सा लेने का विकल्प है Attribution Reporting API के बारे में बातचीत.