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

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

लागू करने की स्थिति

• एग्रीगेशन सेवा अब सामान्य तौर पर उपलब्ध है.
• एग्रीगेशन सेवा का इस्तेमाल, Protected Audience API और Shared Storage API के लिए, Attribution Reporting API और Private Aggregation API के साथ किया जा सकता है.

उपलब्धता

प्रस्ताव	स्थिति
Attribution Reporting API, Private एग्रीगेशन एपीआई में Amazon Web Services (AWS) की एग्रीगेशन सेवा सहायता पूरी जानकारी देने वाला वीडियो	उपलब्ध
Attribution Reporting API और Private Aggregation API के ज़रिए, Google Cloud के लिए एग्रीगेशन सेवा की सहायता एक्सप्लेनर	उपलब्ध
एग्रीगेशन सेवा की साइट का रजिस्ट्रेशन और एक से ज़्यादा सोर्स का एग्रीगेशन. साइट रजिस्टर करने के लिए, साइट को क्लाउड खातों (AWS या GCP) से मैप करना शामिल होता है. एक से ज़्यादा ऑरिजिन को एग्रीगेट करने के लिए, वे एक ही साइट के होने चाहिए. GitHub पर अक्सर पूछे जाने वाले सवाल साइट एग्रीगेशन एपीआई से जुड़ा दस्तावेज़	उपलब्ध
अलग-अलग पैरामीटर पर एक्सपेरिमेंट और सुझाव/राय देने की सुविधा देने के लिए, एग्रीगेशन सेवा की epsilon वैल्यू को 64 तक की रेंज में रखा जाएगा. ARA ऐपसिलॉन के बारे में सुझाव/राय दें या शिकायत करें. पीएए (प्रॉडक्ट ऐक्सेस ऐक्सेस) के लिए, एप्सीलन फ़ीडबैक सबमिट करें.	उपलब्ध. ऐपसिलॉन रेंज की वैल्यू अपडेट होने से पहले, हम नेटवर्क को इसकी बेहतर सूचना देंगे.
एग्रीगेशन सेवा की क्वेरी के लिए, योगदान को फ़िल्टर करने की ज़्यादा बेहतर सुविधा पूरी जानकारी देने वाला वीडियो	उपलब्ध
आपदा के बाद बजट वापस पाने की प्रोसेस (गड़बड़ियां, गलत तरीके से कॉन्फ़िगर करना वगैरह) पूरी जानकारी देने वाला वीडियो	उपलब्ध बजट रिकवरी का इस्तेमाल करके, विज्ञापन टेक्नोलॉजी कंपनी के ज़रिए वापस लाए गए शेयर किए गए आईडी के प्रतिशत की समीक्षा करने का तरीका. साथ ही, साल 2025 की पहली छमाही के लिए ज़्यादा रिकवरी की योजना के लिए, आने वाले समय में रिकवरी को निलंबित करना
Accenture, AWS पर कोऑर्डिनेटर के तौर पर काम करता है डेवलपर ब्लॉग	उपलब्ध
Google Cloud पर कोऑर्डिनेटर के तौर पर काम करने वाली स्वतंत्र पार्टी डेवलपर ब्लॉग	उपलब्ध
Attribution Reporting API पर एग्रीगेट डीबग रिपोर्टिंग के लिए एग्रीगेशन सेवा सहायता पूरी जानकारी देने वाला वीडियो	उपलब्ध

मुख्य शब्द और कॉन्सेप्ट

अगर आपको अपने विज्ञापन टेक्नोलॉजी वर्कफ़्लो में एग्रीगेशन सेवा का इस्तेमाल करना है, तो नीचे दी गई शर्तों और कॉन्सेप्ट से आपको इस बारे में ज़्यादा जानकारी मिलेगी कि यह नया एग्रीगेशन फ़्लो आपकी टीम के लिए क्या-क्या कर सकता है:

शब्द	ब्यौरा
एग्रीगेशन सेवा	विज्ञापन टेक्नोलॉजी से संचालित एक सेवा, जो समरी रिपोर्ट बनाने के लिए, एग्रीगेट की जा सकने वाली रिपोर्ट को प्रोसेस करती है.
एग्रीगेट की जा सकने वाली रिपोर्ट	एग्रीगेट की जा सकने वाली रिपोर्ट, एन्क्रिप्ट (सुरक्षित) की गई वे रिपोर्ट होती हैं जिन्हें उपयोगकर्ता के अलग-अलग डिवाइसों से भेजा जाता है. इन रिपोर्ट में, क्रॉस-साइट उपयोगकर्ता के व्यवहार और कन्वर्ज़न से जुड़ा डेटा होता है. कन्वर्ज़न (जिन्हें कभी-कभी एट्रिब्यूशन ट्रिगर इवेंट भी कहा जाता है) और उनसे जुड़ी मेट्रिक, विज्ञापन देने वाली कंपनी या विज्ञापन टेक्नोलॉजी तय करती है. हर रिपोर्ट को एन्क्रिप्ट (सुरक्षित) किया जाता है, ताकि अलग-अलग पक्ष, दिए गए डेटा को ऐक्सेस न कर सकें. एग्रीगेट की जा सकने वाली रिपोर्ट के बारे में ज़्यादा जानें.
एग्रीगेटेबल रिपोर्ट अकाउंटिंग	यह एक डिस्ट्रिब्यूटेड लेज़र है, जो दोनों कोऑर्डिनेटर में मौजूद होता है. यह निजता के लिए तय किए गए बजट को ट्रैक करता है और 'डुप्लीकेट नहीं होना चाहिए' नियम को लागू करता है. यह निजता को बनाए रखने का एक तरीका है. यह कोऑर्डिनेटर के अंदर काम करता है और यह पक्का करता है कि तय किए गए निजता बजट के अलावा, एग्रीगेशन सेवा से कोई भी रिपोर्ट पास न हो. बैच में डेटा इकट्ठा करने की रणनीतियों के बारे में ज़्यादा पढ़ें. इससे आपको यह जानने में मदद मिलेगी कि ये रणनीतियां, एग्रीगेट की जा सकने वाली रिपोर्ट से कैसे जुड़ी हैं.
एग्रीगेट की जा सकने वाली रिपोर्ट का लेखांकन बजट	बजट के रेफ़रंस, जो पक्का करते हैं कि रिपोर्ट एक से ज़्यादा बार प्रोसेस न हों.
भरोसेमंद एक्ज़ीक्यूशन एनवायरमेंट (TEE)	एक भरोसेमंद एक्ज़ीक्यूशन एनवायरमेंट, कंप्यूटर हार्डवेयर और सॉफ़्टवेयर का एक खास कॉन्फ़िगरेशन होता है. इसकी मदद से, बाहरी उपयोगकर्ताओं को का इस्तेमाल करके कंप्यूटर पर चल रहे सॉफ़्टवेयर के सही वर्शन की पुष्टि कर सकते हैं. TEEs बाहरी पक्षों को यह पुष्टि करने की अनुमति देगा कि सॉफ़्टवेयर ठीक वही काम करता है जो सॉफ़्टवेयर बनाने वाली कंपनी का दावा है कि यह ऐसा ही करता है—कुछ भी नहीं. Privacy Sandbox के प्रस्तावों के लिए इस्तेमाल किए जाने वाले टीईई के बारे में ज़्यादा जानने के लिए, Protected Audience API की सेवाओं के बारे में जानकारी और एग्रीगेशन सेवा के बारे में जानकारी पढ़ें.
कोऑर्डिनेटर	कोऑर्डिनेटर ऐसी इकाई होती है जो मुख्य मैनेजमेंट और एग्रीगेटेड रिपोर्ट अकाउंटिंग के लिए ज़िम्मेदार होती है. कोऑर्डिनेटर, स्वीकार किए गए एग्रीगेशन सेवा कॉन्फ़िगरेशन के हैश की सूची बनाए रखता है और डिक्रिप्शन कुंजियों के ऐक्सेस को कॉन्फ़िगर करता है.
शेयर किया गया आईडी	कैलकुलेट की गई वैल्यू, जिसमें ये शामिल हैं: shared_info, reporting_origin, destination_site (सिर्फ़ Attribution Reporting API के लिए उपलब्ध), source_registration-time (सिर्फ़ Attribution Reporting API के लिए उपलब्ध), scheduled_report_time, version. इसका मतलब है कि अगर कई रिपोर्ट में shared_info फ़ील्ड के एक जैसे एट्रिब्यूट शामिल हैं, तो वे एक ही शेयर किए गए आईडी से जुड़ी हैं. यह एग्रीगेट की जा सकने वाली रिपोर्ट के हिसाब-किताब में अहम भूमिका निभाता है. भरोसेमंद सर्वर के बारे में ज़्यादा जानें.
सारांश रिपोर्ट	खास जानकारी वाली रिपोर्ट, Attribution Reporting API और Private Aggregation API रिपोर्ट टाइप है. खास जानकारी रिपोर्ट में, कुल उपयोगकर्ता का डेटा शामिल होता है. साथ ही, इसमें ज़्यादा जानकारी वाला कन्वर्ज़न डेटा भी शामिल हो सकता है. साथ ही, इसमें ग़ैर-ज़रूरी आवाज़ें भी शामिल हो सकती हैं. खास जानकारी वाली रिपोर्ट में एग्रीगेट रिपोर्ट होती हैं. खास जानकारी वाली रिपोर्ट, इवेंट-लेवल की रिपोर्टिंग की तुलना में ज़्यादा सुविधाएं और बेहतर डेटा मॉडल देती हैं. खास तौर पर, कन्वर्ज़न वैल्यू जैसे कुछ इस्तेमाल के उदाहरणों के लिए.
रिपोर्टिंग का ऑरिजिन	रिपोर्टिंग ऑरिजिन वह इकाई है जिसे एग्रीगेट की जा सकने वाली रिपोर्ट मिलती हैं. दूसरे शब्दों में कहें, तो जिसे Attribution Reporting API कहा जाता है. एग्रीगेट की जा सकने वाली रिपोर्ट, उपयोगकर्ता के डिवाइसों से, रिपोर्टिंग ऑरिजिन से जुड़े प्रसिद्ध यूआरएल पर भेजी जाती हैं. इस रिपोर्टिंग ऑरिजिन को, रजिस्टर करने के दौरान तय किया जाना चाहिए.
कॉन्ट्रिब्यूशन बॉन्डिंग	एग्रीगेट की जा सकने वाली रिपोर्ट में, काउंटर में किसी भी संख्या में बढ़ोतरी हो सकती है. उदाहरण के लिए, किसी रिपोर्ट में उन प्रॉडक्ट की संख्या शामिल हो सकती है जिन्हें उपयोगकर्ता ने विज्ञापन देने वाले की साइट पर देखा है. किसी एक सोर्स इवेंट से जुड़ी सभी एग्रीगेटेबल रिपोर्ट में बढ़ोतरी की कुल संख्या, दी गई सीमा `L1=2^16` से ज़्यादा नहीं होनी चाहिए. एग्रीगेट की जा सकने वाली रिपोर्ट के बारे में जानकारी देने वाले दस्तावेज़ में ज़्यादा जानें.
शोर और स्केलिंग	एग्रीगेशन प्रोसेस के हिस्से के तौर पर, खास जानकारी वाली रिपोर्ट में आंकड़ों से जुड़ा कुछ डेटा जोड़ा जाता है. यह डेटा, निजता बनाए रखने और यह पक्का करने के लिए भी काम करता है कि फ़ाइनल रिपोर्ट में मेज़रमेंट की पहचान छिपाई गई हो. एडिटिव नॉइज़ मैकेनिज़्म के बारे में ज़्यादा पढ़ें. यह जानकारी, लैप्लेस डिस्ट्रिब्यूशन से ली गई है.
प्रमाणित करना	प्रमाणित करने की सुविधा, सॉफ़्टवेयर की पहचान की पुष्टि करने का एक तरीका है. आम तौर पर, इसके लिए क्रिप्टोग्राफ़िक हैश या हस्ताक्षर का इस्तेमाल किया जाता है. एग्रीगेशन सेवा के प्रस्ताव के लिए, पुष्टि करने की प्रक्रिया, विज्ञापन की टेक्नोलॉजी से चलने वाली एग्रीगेशन सेवा में चल रहे कोड और ओपन सोर्स कोड से मेल खाती है. प्रमाणित करने के बारे में और पढ़ें.

एग्रीगेशन सेवा के बारे में ज़्यादा जानने के लिए, एग्रीगेशन सेवा के बारे में जानकारी और शर्तों की पूरी सूची पढ़ें.

एग्रीगेशन के इस्तेमाल के उदाहरण

विज्ञापन मेज़रमेंट और उससे जुड़ी मेज़रमेंट क्लाइंट लाइब्रेरी के लिए, डेवलपर के इन सफ़र पर विचार करें.

इस्तेमाल का उदाहरण	आने की जगह	ब्यौरा
बिडिंग ऑप्टिमाइज़ेशन	Attribution Reporting API (Chrome और Android)	बिड ऑप्टिमाइज़ेशन के लिए कन्वर्ज़न सिग्नल डालने के लिए, एग्रीगेट की गई रिपोर्ट का इस्तेमाल करें.
क्रॉस-प्लैटफ़ॉर्म मेज़रमेंट	Attribution Reporting API (Chrome और Android)	Chrome और Android पर परफ़ॉर्मेंस की जानकारी पाने के लिए, वेब और ऐप्लिकेशन के बीच मेज़रमेंट की सुविधाओं का इस्तेमाल करें.
कन्वर्ज़न रिपोर्टिंग	Attribution Reporting API (Chrome और Android)	ग्राहकों के कैंपेन की ज़रूरतों के हिसाब से, एग्रीगेट की गई कन्वर्ज़न रिपोर्टिंग बनाएं. इसमें सीटीसी और वीटीसी शामिल हैं.
कैंपेन की पहुंच का मेज़रमेंट	Shared Storage API & Private Aggregation API (Chrome)	कैंपेन की पहुंच को मेज़र करने के लिए, अलग-अलग साइटों के विज्ञापन व्यू वैरिएबल का इस्तेमाल करें.
डेमोग्राफ़िक रिपोर्टिंग	Shared Storage API & Private Aggregation API (Chrome)	डेमोग्राफ़िक के हिसाब से पहुंच को मेज़र करने के लिए, क्रॉस-साइट विज्ञापन व्यू और डेमोग्राफ़िक जानकारी का इस्तेमाल करें.
कन्वर्ज़न पाथ का विश्लेषण	Shared Storage API & Private Aggregation API (Chrome)	कन्वर्ज़न पाथ का एग्रीगेट विश्लेषण करने के लिए, अलग-अलग साइटों पर दिखने वाले विज्ञापन व्यू और कन्वर्ज़न वैरिएबल सेव करें.
ब्रैंड और कन्वर्ज़न लिफ़्ट	Shared Storage API & Private Aggregation API (Chrome)	ब्रैंड पर असर और इंक्रीमेंटलिटी को मेज़र करने के लिए, टेस्ट/कंट्रोल ग्रुप और पोलिंग की जानकारी की रिपोर्टिंग.
ऑक्शन डीबग करना	Protected Audience API और Private Aggregation API (Chrome)	डीबग करने के लिए, अलग-अलग डेटा को मिलाकर तैयार की गई रिपोर्ट का इस्तेमाल करें.
बिड का डिस्ट्रिब्यूशन	Protected Audience API और Private Aggregation API (Chrome)	नीलामियों के लिए बिड वैल्यू के डिस्ट्रिब्यूशन को कैप्चर करने के लिए, एग्रीगेट की गई रिपोर्ट का इस्तेमाल करें.

एंड-टू-एंड फ़्लो

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

1. एन्क्रिप्ट की गई रिपोर्ट जनरेट करने के लिए, सार्वजनिक कुंजी फ़ेच करें.
2. एग्रीगेट की जा सकने वाली एन्क्रिप्ट की गई रिपोर्ट, विज्ञापन टेक्नोलॉजी सर्वर को भेजी जाती हैं, ताकि उन्हें इकट्ठा, ट्रांसफ़ॉर्म, और एक साथ भेजा जा सके.
3. AdTech सर्वर, रिपोर्ट (avro फ़ॉर्मैट) को एक साथ भेजता है और डिप्लॉय की गई एग्रीगेशन सेवा को भेजता है. (विज्ञापन टेक्नोलॉजी कंपनी को यह पूरा करना होगा).
4. एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट को डिक्रिप्ट (सुरक्षित से सामान्य में बदलना) करने के लिए, इकट्ठा की गई रिपोर्ट वापस पाएं.
5. कोऑर्डिनेटर से, डेटा को डिक्रिप्ट करने की कुंजियां पाना.
6. एग्रीगेशन सेवा, एग्रीगेशन और नॉइज़ करने के लिए रिपोर्ट को डिक्रिप्ट करती है.
7. एग्रीगेट की जा सकने वाली रिपोर्ट की लेखांकन सेवा यह जांच करती है कि एग्रीगेट की जा सकने वाली दी गई रिपोर्ट के लिए खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, निजता बजट बचा है या नहीं.
8. खास जानकारी वाली आखिरी रिपोर्ट सबमिट करें.

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

यह फ़्लो, Attribution Reporting API या Private Aggregation API जैसे अलग-अलग मेज़रमेंट एपीआई से शुरू होता है. ये एपीआई, कई ब्राउज़र इंस्टेंस से रिपोर्ट जनरेट करते हैं. Chrome, रिपोर्ट को विज्ञापन टेक्नोलॉजी के रिपोर्टिंग ऑरिजिन पर भेजने से पहले, उन्हें एन्क्रिप्ट (सुरक्षित) करने के लिए, कोऑर्डिनेटर में मौजूद पासकोड होस्टिंग सेवा से सार्वजनिक पासकोड लेता है. सार्वजनिक कुंजियों को हर सात दिन में बदला जाता है.

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

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

विज्ञापन टेक्नोलॉजी रिपोर्टिंग का ऑरिजिन एंडपॉइंट, जहां रिपोर्ट इकट्ठा की जाती हैं उसे विज्ञापन टेक्नोलॉजी होस्ट करती है. साथ ही, एग्रीगेशन सेवा को विज्ञापन टेक्नोलॉजी के क्लाउड में डिप्लॉय किया जाता है.

एग्रीगेट की जा सकने वाली रिपोर्ट को एक साथ भेजना

रिपोर्टिंग के लिए चुने गए ऑरिजिन सर्वर की मदद के बिना, रिपोर्टिंग फ़्लो पूरा नहीं हो सकता. यह वह ऑरिजिन है जिसे विज्ञापन टेक्नोलॉजी ने रजिस्टर करने की प्रोसेस के दौरान सबमिट किया होगा. रिपोर्टिंग ऑरिजिन की मुख्य कार्रवाइयां, इकट्ठा की गई रिपोर्ट को इकट्ठा करना, बदलना, और बैच में डालना होगा. साथ ही, उन्हें Google Cloud या Amazon Web Services में, विज्ञापन टेक्नोलॉजी की डिप्लॉय की गई एग्रीगेशन सेवा को भेजने के लिए तैयार करना होगा. एग्रीगेट की जा सकने वाली रिपोर्ट तैयार करने के तरीके के बारे में ज़्यादा जानें.

अब आपको इस बारे में सामान्य जानकारी मिल गई है. अब उन कॉम्पोनेंट पर नज़र डालें जिन्हें आपकी एग्रीगेशन सेवा में डिप्लॉय किया जाएगा.

क्लाउड कॉम्पोनेंट

एग्रीगेशन सेवा में, क्लाउड सेवा के कई कॉम्पोनेंट होते हैं. दी गई Terraform स्क्रिप्ट, क्लाउड सेवा के सभी ज़रूरी कॉम्पोनेंट को कॉन्फ़िगर और प्रोवाइड करती हैं.

फ़्रंटएंड सेवा

मैनेज की जाने वाली क्लाउड सेवा: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)

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

फ़्रंटएंड सेवा में दो एपीआई उपलब्ध हैं:

एंडपॉइंट	ब्यौरा
createJob	यह एपीआई, एग्रीगेशन सेवा की जॉब को ट्रिगर करता है. किसी जॉब को ट्रिगर करने के लिए, इसकी ज़रूरत होती है. जैसे, जॉब आईडी, इनपुट स्टोरेज की जानकारी, आउटपुट स्टोरेज की जानकारी, रिपोर्टिंग का ऑरिजिन वगैरह.
getJob	यह एपीआई, किसी खास जॉब आईडी के लिए जॉब का स्टेटस दिखाता है. इससे, जॉब की स्थिति के बारे में जानकारी मिलती है. जैसे,"मिला," "जारी है" या "पूरा हो गया." इसके अलावा, अगर जॉब पूरा हो जाता है, तो यह जॉब का नतीजा दिखाता है. इसमें, जॉब के दौरान मिलने वाली गड़बड़ियों के मैसेज भी शामिल होते हैं.

Aggregation Service API का दस्तावेज़ देखें.

जॉब कतार

मैनेज की जा रही क्लाउड सेवा: 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)

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

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

मैनेज की जाने वाली क्लाउड सेवा: गोपनीय स्पेस वाला Compute Engine (Google Cloud) / Nitro Enclave वाला Amazon Web Services EC2 (Amazon Web Services)

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

यह वर्कर, ट्रस्टेड एक्ज़ीक्यूशन एनवायरमेंट (टीईई) इंस्टेंस में काम करता है. हर वर्कर एक बार में सिर्फ़ एक काम करता है. विज्ञापन टेक्नोलॉजी, अपने-आप स्केल होने की सुविधा का कॉन्फ़िगरेशन सेट करके, एक साथ कई जॉब प्रोसेस करने के लिए कई वर्कर्स को कॉन्फ़िगर कर सकती है. अपने-आप स्केल होने की सुविधा की मदद से, जॉब कतार में बचे मैसेज की संख्या के हिसाब से, वर्कर की संख्या डाइनैमिक तौर पर अडजस्ट की जाती है. Terraform एनवायरमेंट फ़ाइल की मदद से, अपने-आप स्केल होने की सुविधा के लिए, वर्कर्स की कम से कम और ज़्यादा से ज़्यादा संख्या कॉन्फ़िगर की जा सकती है. ऑटोस्केल करने के बारे में ज़्यादा जानकारी, यहां दी गई terraform स्क्रिप्ट में मिल सकती है. [Amazon Web Services / Google Cloud]

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

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

एग्रीगेशन सेवा के बारे में ज़्यादा जानकारी के लिए, एग्रीगेशन सेवा के बारे में जानकारी देखें.

अगले चरण

अब आपको एग्रीगेशन सेवा की खास बातें पता चल गई हैं. अब Google Cloud या Amazon Web Services की मदद से, एग्रीगेशन सेवा का अपना इंस्टेंस डिप्लॉय करें. इसके लिए, शुरू करने का सेक्शन देखें. अगर आपको डिप्लॉय की गई एग्रीगेशन सेवा को इस्तेमाल करने के तरीके के बारे में ज़्यादा जानकारी चाहिए, तो एग्रीगेशन सेवा को इस्तेमाल करने के बारे में ज़्यादा जानने के लिए इस लिंक पर जाएं.

समस्या का हल

गड़बड़ी के मैसेज के बारे में ज़्यादा जानकारी पाने, यह जानने के लिए कि आपको जो गड़बड़ी दिख रही है उसकी वजह क्या हो सकती है, और गड़बड़ी को ठीक करने के लिए आगे क्या करना होगा, गड़बड़ी के आम कोड और उन्हें ठीक करने के तरीके वाला हमारा दस्तावेज़ पढ़ें.

सहायता पाना और सुझाव/राय देना या शिकायत करना

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