एग्रीगेशन सेवा की मदद से, विज्ञापन टेक्नोलॉजी से जुड़ी सेवा देने वाली कंपनियां, विज्ञापन कैंपेन का विश्लेषण करने और उन्हें ऑप्टिमाइज़ करने के लिए, एन्क्रिप्ट (सुरक्षित) किए गए विज्ञापन की परफ़ॉर्मेंस का डेटा हासिल कर सकती हैं. इससे आपको यह जानकारी मिलती है कि आपके विज्ञापन कैसा परफ़ॉर्म कर रहे हैं. इससे आपको यह पता चलता है कि आपके कारोबार के लिए कौनसी चीज़ें काम कर रही हैं और कौनसी नहीं.
इस दस्तावेज़ में इनके बारे में बताया गया है:
- मुख्य शब्द और कॉन्सेप्ट
- एग्रीगेशन सेवा कैसे काम करती है, ताकि आपको एग्रीगेट की जा सकने वाली रॉ रिपोर्ट से, कन्वर्ज़न डेटा और पहुंच मेज़रमेंट की पूरी जानकारी मिल सके
- एग्रीगेट की जा सकने वाली रिपोर्ट को एक साथ भेजने के बारे में खास जानकारी
- क्लाउड कॉम्पोनेंट के बारे में खास जानकारी
इस दस्तावेज़ में ये शामिल नहीं हैं:
- आर्किटेक्चरल डिज़ाइन की जानकारी: ज़्यादा जानकारी के लिए, GitHub पर उपलब्ध दस्तावेज़ पढ़ें.
- लागू करने के लिए दिशा-निर्देश: डिप्लॉयमेंट के निर्देशों के लिए, शुरू करने की गाइड पढ़ें.
यह दस्तावेज़ किसके लिए है?
यह पेज उन विज्ञापन टेक्नोलॉजी और डेवलपर के लिए है जो यह समझना चाहते हैं कि उपयोगकर्ता की निजता को सुरक्षित रखते हुए, विज्ञापन के इस्तेमाल के उदाहरणों को चालू करने के लिए डिज़ाइन किए गए मुख्य क्लाइंट मेज़रमेंट एपीआई, एक साथ कैसे काम करते हैं.
इस दस्तावेज़ में यह माना गया है कि आपको Private Aggregation API, Attribution Reporting API, Protected Audience API, Shared Storage, और भरोसेमंद एक्सीक्यूशन एनवायरमेंट के बारे में पहले से पता है.
मुख्य शब्द और कॉन्सेप्ट
आगे बढ़ने से पहले, इन मुख्य शब्दों के बारे में जानें:
शब्दावली
- विज्ञापन टेक्नोलॉजी
-
विज्ञापन प्लैटफ़ॉर्म, विज्ञापन दिखाने के लिए सेवाएं देने वाली कंपनी है.
- एग्रीगेट की जा सकने वाली रिपोर्ट
-
एग्रीगेट की जा सकने वाली रिपोर्ट, एन्क्रिप्ट की गई रिपोर्ट होती हैं. इन्हें उपयोगकर्ता के अलग-अलग डिवाइसों से भेजा जाता है. इन रिपोर्ट में, क्रॉस-साइट उपयोगकर्ता के व्यवहार और कन्वर्ज़न का डेटा होता है. कन्वर्ज़न (जिन्हें कभी-कभी एट्रिब्यूशन ट्रिगर इवेंट भी कहा जाता है) और उनसे जुड़ी मेट्रिक, विज्ञापन देने वाला या विज्ञापन टेक्नोलॉजी कंपनी तय करती है. हर रिपोर्ट को एन्क्रिप्ट किया जाता है, ताकि अलग-अलग पक्ष उस डेटा को ऐक्सेस न कर सकें.
- एग्रीगेट की जा सकने वाली रिपोर्ट का हिसाब
-
यह एक डिस्ट्रिब्यूटेड लेज़र है, जो दोनों कोऑर्डिनेटर में मौजूद होता है. यह निजता के लिए तय किए गए बजट को ट्रैक करता है और 'डुप्लीकेट नहीं है' नियम को लागू करता है. यह निजता बनाए रखने का एक तरीका है. यह कोऑर्डिनेटर में मौजूद होता है और वहां से चलाया जाता है. इससे यह पक्का होता है कि एग्रीगेशन सेवा में, निजता के लिए तय किए गए बजट से ज़्यादा डेटा न भेजा जाए.
- एग्रीगेट की जा सकने वाली रिपोर्ट का लेखांकन बजट
-
बजट के रेफ़रंस, जो यह पक्का करते हैं कि अलग-अलग रिपोर्ट एक से ज़्यादा बार प्रोसेस न की जाएं.
- एग्रीगेशन सेवा
-
विज्ञापन टेक्नोलॉजी से संचालित एक सेवा, जो समरी रिपोर्ट बनाने के लिए, एग्रीगेट की जा सकने वाली रिपोर्ट को प्रोसेस करती है.
एग्रीगेशन सेवा के बारे में ज़्यादा जानने के लिए, एग्रीगेशन सेवा के बारे में जानकारी और शर्तों की पूरी सूची पढ़ें.
- प्रमाणित करना
-
सॉफ़्टवेयर की पहचान की पुष्टि करने का तरीका. आम तौर पर, क्रिप्टोग्राफ़िक हैश या हस्ताक्षर की मदद से ऐसा किया जाता है. एग्रीगेशन सेवा के प्रस्ताव के लिए, पुष्टि करने की प्रक्रिया में, विज्ञापन टेक्नोलॉजी की मदद से आपकी एग्रीगेशन सेवा में चल रहे कोड की तुलना, ओपन सोर्स कोड से की जाती है.
- योगदान के लिए बॉन्ड
- कोऑर्डिनेटर
-
ये इकाइयां, अहम मैनेजमेंट और एग्रीगेट की जा सकने वाली रिपोर्ट के हिसाब-किताब के लिए ज़िम्मेदार होती हैं. कोऑर्डिनेटर, एग्रीगेशन सेवा के मंज़ूर किए गए कॉन्फ़िगरेशन के हैश की सूची रखता है. साथ ही, डिक्रिप्ट करने की कुंजियों के ऐक्सेस को कॉन्फ़िगर करता है.
- शोर और स्केलिंग
-
आंकड़ों से जुड़ी ग़ैर-ज़रूरी जानकारी, जो एग्रीगेशन की प्रोसेस के दौरान खास जानकारी वाली रिपोर्ट में जोड़ी जाती है. ऐसा, निजता बनाए रखने और यह पक्का करने के लिए किया जाता है कि आखिरी रिपोर्ट में, पहचान छिपाकर मेज़रमेंट की जानकारी दी जाए.
ऐडिटिव नॉइज़ मैकेनिज्म के बारे में ज़्यादा पढ़ें. इसे लाप्लास डिस्ट्रिब्यूशन से लिया गया है.
- रिपोर्टिंग का सोर्स
-
वह इकाई जिसे एग्रीगेट की जा सकने वाली रिपोर्ट मिलती हैं. दूसरे शब्दों में, आप या कोई ऐसी विज्ञापन टेक्नोलॉजी कंपनी जिसने Attribution Reporting API को कॉल किया है. एग्रीगेट की जा सकने वाली रिपोर्ट, उपयोगकर्ता के डिवाइसों से, रिपोर्टिंग ऑरिजिन से जुड़े किसी लोकप्रिय यूआरएल पर भेजी जाती हैं. रिपोर्टिंग ऑरिजिन को रजिस्टर करने के दौरान तय किया जाता है.
- शेयर किया गया आईडी
-
कैलकुलेट की गई वैल्यू, जिसमें
shared_info,reporting_origin,destination_site(सिर्फ़ Attribution Reporting API के लिए),source_registration-time(सिर्फ़ Attribution Reporting API के लिए),scheduled_report_time, और वर्शन शामिल हैं.shared_infoफ़ील्ड में एक जैसे एट्रिब्यूट शेयर करने वाली कई रिपोर्ट का शेयर किया गया आईडी एक ही होना चाहिए. शेयर किए गए आईडी, एग्रीगेट की जा सकने वाली रिपोर्ट के हिसाब से अहम भूमिका निभाते हैं. - खास जानकारी वाली रिपोर्ट
-
Attribution Reporting API और Private Aggregation API रिपोर्ट टाइप. खास जानकारी वाली रिपोर्ट में, उपयोगकर्ता का इकट्ठा किया गया डेटा शामिल होता है. साथ ही, इसमें ग़ैर-ज़रूरी डेटा के साथ कन्वर्ज़न का पूरा डेटा भी शामिल हो सकता है. खास जानकारी वाली रिपोर्ट, एग्रीगेट रिपोर्ट से बनी होती हैं. ये इवेंट-लेवल की रिपोर्टिंग की तुलना में ज़्यादा सुविधाएं देते हैं और बेहतर डेटा मॉडल उपलब्ध कराते हैं. खास तौर पर, कन्वर्ज़न वैल्यू जैसे कुछ इस्तेमाल के उदाहरणों के लिए.
- ट्रस्टेड एक्ज़ीक्यूशन एनवायरमेंट (TEE)
-
कंप्यूटर हार्डवेयर और सॉफ़्टवेयर का सुरक्षित कॉन्फ़िगरेशन, जिसकी मदद से बाहरी पक्ष, मशीन पर चल रहे सॉफ़्टवेयर के सटीक वर्शन की पुष्टि कर सकते हैं. टीईई की मदद से, बाहरी पक्ष यह पुष्टि कर सकते हैं कि सॉफ़्टवेयर ठीक वैसा ही काम करता है जैसा कि सॉफ़्टवेयर बनाने वाली कंपनी का दावा है. इसमें न तो ज़्यादा और न ही कम काम किया जाता है.
Privacy Sandbox के प्रस्तावों के लिए इस्तेमाल किए जाने वाले टीईई के बारे में ज़्यादा जानने के लिए, Protected Audience API की सेवाओं के बारे में जानकारी और एग्रीगेशन सेवा के बारे में जानकारी पढ़ें.
एग्रीगेशन सेवा का वर्कफ़्लो
रिपोर्ट जनरेट करने की प्रोसेस में ये चरण शामिल होते हैं:
- एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट जनरेट करने के लिए, ब्राउज़र सार्वजनिक पासकोड फ़ेच करता है.
- एग्रीगेट की जा सकने वाली एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट, विज्ञापन से जुड़ी टेक्नोलॉजी के सर्वर पर भेजी जाती हैं, ताकि उन्हें इकट्ठा, बदला, और बैच में बांटा जा सके.
- विज्ञापन टेक्नोलॉजी सर्वर, रिपोर्ट को avro फ़ॉर्मैट में बैच में बांटता है और उन्हें एग्रीगेशन सेवा को भेजता है.
- एग्रीगेशन वर्कर्स, एग्रीगेट की गई रिपोर्ट को डिक्रिप्ट करने के लिए वापस लाता है.
- एग्रीगेशन वर्कर्स, कोऑर्डिनेटर से डिक्रिप्ट करने की कुंजियां हासिल करता है.
- एग्रीगेशन वर्कर, एग्रीगेशन और नॉइज़ करने के लिए रिपोर्ट को डिक्रिप्ट करता है.
- एग्रीगेट की जा सकने वाली रिपोर्ट की लेखांकन सेवा यह जांच करती है कि एग्रीगेट की जा सकने वाली दी गई रिपोर्ट के लिए खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, निजता बजट काफ़ी है या नहीं.
- एग्रीगेशन सेवा, खास जानकारी वाली फ़ाइनल रिपोर्ट सबमिट करती है.
नीचे दिए गए डायग्राम में, एग्रीगेशन सेवा के काम करने का तरीका दिखाया गया है. इसमें, वेब और मोबाइल डिवाइसों से रिपोर्ट मिलने से लेकर, एग्रीगेशन सेवा में खास जानकारी वाली रिपोर्ट बनने तक की प्रोसेस शामिल है.
खास जानकारी के तौर पर, Attribution Reporting API या Private Aggregation API, एक से ज़्यादा ब्राउज़र इंस्टेंस से रिपोर्ट जनरेट करते हैं. Chrome, कोऑर्डिनेटर में मौजूद पासकोड होस्टिंग सेवा से सार्वजनिक पासकोड पाता है. यह पासकोड हर सात दिन में बदला जाता है. Chrome, रिपोर्ट को एड टेक रिपोर्टिंग ऑरिजिन पर भेजने से पहले, उन्हें एन्क्रिप्ट करता है. आपका विज्ञापन टेक्नोलॉजी रिपोर्टिंग ऑरिजिन, इनकमिंग रिपोर्ट को इकट्ठा करके उन्हें एवरो फ़ॉर्मैट में बदलता है. इसके बाद, उन्हें आपकी एग्रीगेशन सेवा को भेजता है. इसके बाद, जब Aggregation Service को बैच का अनुरोध भेजा जाता है, तो वह Key Hosting Service से डिक्रिप्ट करने की कुंजियां फ़ेच करती है. साथ ही, रिपोर्ट को डिक्रिप्ट करके, खास जानकारी वाली रिपोर्ट बनाने के लिए उन्हें एग्रीगेट करती है और उनमें गड़बड़ियां करती है. ऐसा तब तक किया जाता है, जब तक निजता बजट में उन्हें बनाने के लिए ज़रूरी बजट मौजूद होता है.
लागू करने के सेक्शन में, एग्रीगेट की जा सकने वाली रिपोर्ट तैयार करने के तरीके के बारे में ज़्यादा पढ़ा जा सकता है.
एग्रीगेट की जा सकने वाली रिपोर्ट को एक साथ भेजना
रिपोर्टिंग के लिए चुने गए ऑरिजिन सर्वर की मदद के बिना, रिपोर्टिंग फ़्लो पूरा नहीं हो सकता. यह वह ऑरिजिन है जिसे आपने रजिस्टर करने की प्रोसेस के दौरान सबमिट किया होगा. रिपोर्टिंग ऑरिजिन की ज़िम्मेदारी, एग्रीगेट की जा सकने वाली रिपोर्ट को इकट्ठा करने, उनमें बदलाव करने, और उन्हें बैच में डालने की होती है. साथ ही, उन्हें Google Cloud या Amazon Web Services में मौजूद आपकी एग्रीगेशन सेवा को भेजने के लिए तैयार करना भी उसकी ज़िम्मेदारी होती है. एग्रीगेट की जा सकने वाली रिपोर्ट तैयार करने के तरीके के बारे में ज़्यादा जानें.
अब आपको इस बारे में सामान्य जानकारी मिल गई है. इसलिए, अब हम आपकी एग्रीगेशन सेवा में डिप्लॉय किए गए कॉम्पोनेंट की बारीकी से जांच कर सकते हैं.
क्लाउड कॉम्पोनेंट
एग्रीगेशन सेवा में कई क्लाउड सेवा कॉम्पोनेंट होते हैं. क्लाउड सेवा के सभी ज़रूरी कॉम्पोनेंट को प्रोवाइड और कॉन्फ़िगर करने के लिए, दी गई Terraform स्क्रिप्ट का इस्तेमाल किया जाता है.
फ़्रंटएंड सेवा
मैनेज की जाने वाली क्लाउड सेवा: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)
फ़्रंटएंड सेवा, सर्वरलेस गेटवे है. यह जॉब बनाने और जॉब की स्थिति वापस पाने के लिए, एग्रीगेशन एपीआई कॉल का मुख्य एंट्री पॉइंट है. यह एग्रीगेशन सेवा के उपयोगकर्ताओं से अनुरोध पाने, इनपुट पैरामीटर की पुष्टि करने, और एग्रीगेशन जॉब शेड्यूलिंग की प्रोसेस शुरू करने के लिए ज़िम्मेदार है.
फ़्रंटएंड सेवा के लिए दो एपीआई उपलब्ध हैं:
| एंडपॉइंट | ब्यौरा |
|---|---|
createJob |
यह एपीआई, एग्रीगेशन सेवा की जॉब को ट्रिगर करता है. जॉब को ट्रिगर करने के लिए, जॉब आईडी, इनपुट स्टोरेज की जानकारी, आउटपुट स्टोरेज की जानकारी, रिपोर्टिंग ऑरिजिन वगैरह की ज़रूरत होती है. |
getJob |
यह एपीआई, किसी खास जॉब आईडी वाली नौकरी की स्थिति दिखाता है. इससे, जॉब की स्थिति के बारे में जानकारी मिलती है. जैसे,"मिला," "जारी है" या "पूरा हो गया." अगर जॉब पूरा हो जाता है, तो यह जॉब का नतीजा भी दिखाता है. इसमें, जॉब के दौरान मिलने वाली गड़बड़ी के मैसेज भी शामिल होते हैं. |
एग्रीगेशन सेवा एपीआई का दस्तावेज़ देखें.
जॉब कतार
मैनेज की जा रही क्लाउड सेवा: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)
जॉब क्यू, एक मैसेज क्यू है. इसमें एग्रीगेशन सेवा के लिए, जॉब के अनुरोध होते हैं. फ़्रंटएंड सेवा, जॉब के अनुरोधों को सूची में डालती है. इसके बाद, एग्रीगेशन वर्कर्स उन्हें प्रोसेस करते हैं.
क्लाउड स्टोरेज
मैनेज की जाने वाली क्लाउड सेवा: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)
एग्रीगेशन सेवा का इस्तेमाल करने वाली इनपुट और आउटपुट फ़ाइलों को क्लाउड स्टोरेज में सेव किया जाता है. जैसे, एन्क्रिप्ट की गई रिपोर्ट फ़ाइलें और आउटपुट की खास जानकारी वाली रिपोर्ट.
नौकरी का मेटाडेटा डेटाबेस
मैनेज की जाने वाली क्लाउड सेवा: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)
जॉब मेटाडेटा डेटाबेस का इस्तेमाल, एग्रीगेशन जॉब की स्थिति को स्टोर और ट्रैक करने के लिए किया जाता है. यह मेटाडेटा रिकॉर्ड करता है, जैसे कि बनाने का समय, अनुरोध करने का समय, अपडेट करने का समय, और स्थिति, जैसे कि मिला, प्रोसेस जारी है या पूरा हो गया. AggWorkers, नौकरी की प्रोसेस के दौरान नौकरी के मेटाडेटा डेटाबेस को अपडेट करते हैं.
एग्रीगेशन वर्कर्स
मैनेज की जाने वाली क्लाउड सेवा: गोपनीय स्पेस वाला Compute Engine (Google Cloud) / Nitro Enclave वाला Amazon Web Services EC2 (Amazon Web Services)
एग्रीगेशन वर्कर्स, जॉब कतार में मौजूद जॉब के अनुरोधों को प्रोसेस करता है. साथ ही, एन्क्रिप्ट (सुरक्षित) किए गए इनपुट को डिक्रिप्ट (सुरक्षित) करता है. इसके लिए, वह कोऑर्डिनेटर में मौजूद पासकोड जनरेशन और डिस्ट्रिब्यूशन सर्विस (केजीडीएस) से फ़ेच की गई कुंजियों का इस्तेमाल करता है. जॉब प्रोसेस करने में लगने वाले समय को कम करने के लिए, एग्रीगेशन वर्कर्स, डिक्रिप्ट करने की कुंजियों को आठ घंटे के लिए कैश मेमोरी में सेव करते हैं. साथ ही, प्रोसेस की जाने वाली सभी जॉब में उनका इस्तेमाल करते हैं.
एग्रीगेशन वर्कर्स, ट्रस्टेड एक्ज़ीक्यूशन एनवायरमेंट (टीईई) इंस्टेंस में काम करते हैं. एक वर्कर्स एक बार में सिर्फ़ एक जॉब को हैंडल करता है. ऑटो स्केलिंग कॉन्फ़िगरेशन सेट करके, एक साथ कई जॉब प्रोसेस करने के लिए कई वर्कर्स कॉन्फ़िगर किए जा सकते हैं. अगर ऑटो स्केलिंग का इस्तेमाल किया जाता है, तो यह जॉब कतार में मौजूद मैसेज की संख्या के हिसाब से, वर्कर की संख्या को डाइनैमिक तौर पर अडजस्ट करता है. Terraform एनवायरमेंट फ़ाइल की मदद से, ऑटो स्केलिंग के लिए वर्कर्स की कम से कम और ज़्यादा से ज़्यादा संख्या कॉन्फ़िगर की जा सकती है. ऑटोस्केल करने के बारे में ज़्यादा जानकारी, इन Terraform स्क्रिप्ट में मिल सकती है: Amazon Web Services या Google Cloud.
एग्रीगेट की जा सकने वाली रिपोर्ट के लिए, एग्रीगेशन वर्कर्स, एग्रीगेट की जा सकने वाली रिपोर्ट अकाउंटिंग सेवा को कॉल करते हैं. यह सेवा यह पक्का करती है कि निजता बजट की सीमा पार न होने पर ही जॉब चलाए जाएं. ("डुप्लीकेट नहीं" नियम देखें.) अगर बजट उपलब्ध है, तो ग़ैर-ज़रूरी एग्रीगेट का इस्तेमाल करके खास जानकारी वाली रिपोर्ट जनरेट की जाती है. एग्रीगेट की जा सकने वाली रिपोर्ट के हिसाब-किताब के बारे में ज़्यादा जानें.
एग्रीगेशन वर्कर्स, जॉब मेटाडेटा डेटाबेस में जॉब मेटाडेटा अपडेट करते हैं. इस जानकारी में, नौकरी के लिए मिले कोड और रिपोर्ट में गड़बड़ी के काउंटर शामिल होते हैं. ऐसा तब होता है, जब रिपोर्ट में कुछ डेटा नहीं मिलता. उपयोगकर्ता, getJob नौकरी की स्थिति वापस पाने वाले एपीआई का इस्तेमाल करके, स्थिति फ़ेच कर सकते हैं.
एग्रीगेशन सेवा के बारे में ज़्यादा जानने के लिए, यह एक्सप्लेनर देखें.
अगले चरण
अब आपको एग्रीगेशन सेवा के काम करने का तरीका पता है. इसलिए, Google Cloud या Amazon Web Services की मदद से, एग्रीगेशन सेवा का अपना इंस्टेंस डिप्लॉय करें. शुरू करने के लिए गाइड देखें.