यह कैसे काम करता है

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

इस दस्तावेज़ में ये चीज़ें शामिल हैं:

• मुख्य शब्द और कॉन्सेप्ट
• एग्रीगेशन सेवा कैसे काम करती है, ताकि आपको एग्रीगेट की जा सकने वाली रॉ रिपोर्ट से, कन्वर्ज़न का ज़्यादा जानकारी वाला डेटा और पहुंच मेज़रमेंट मिल सके
• एग्रीगेट की जा सकने वाली रिपोर्ट को एक साथ भेजने के बारे में खास जानकारी
• क्लाउड कॉम्पोनेंट के बारे में खास जानकारी

यह दस्तावेज़ किसके लिए है?

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

इस दस्तावेज़ में यह माना गया है कि आपको Private Aggregation API, Attribution Reporting API, Protected Audience API, Shared Storage, और भरोसेमंद एक्सीक्यूशन एनवायरमेंट के बारे में पता है.

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

आगे बढ़ने से पहले, इन मुख्य शब्दों के बारे में जानें:

शब्दावली

विज्ञापन टेक्नोलॉजी

विज्ञापन प्लैटफ़ॉर्म, विज्ञापन दिखाने के लिए सेवाएं देने वाली कंपनी है.

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

Aggregatable reports are encrypted reports sent from individual user devices. These reports contain data about cross-site user behavior and conversions. Conversions (sometimes called attribution trigger events) and associated metrics are defined by the advertiser or ad tech. Each report is encrypted to prevent various parties from accessing the underlying data.

Learn more about aggregatable reports.

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

A distributed ledger, located in both coordinators, that tracks the allocated privacy budget and enforces the 'No Duplicates' rule. This is the privacy preserving mechanism, located and run within coordinators, that ensures no reports pass through the Aggregation Service beyond the allocated privacy budget.

Read more on how batching strategies relate to aggregatable reports.

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

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

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

विज्ञापन टेक्नोलॉजी से संचालित एक सेवा, जो समरी रिपोर्ट बनाने के लिए, एग्रीगेट की जा सकने वाली रिपोर्ट को प्रोसेस करती है.

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

प्रमाणित करना

सॉफ़्टवेयर की पहचान की पुष्टि करने का तरीका. आम तौर पर, क्रिप्टोग्राफ़िक हैश या हस्ताक्षर की मदद से ऐसा किया जाता है. एग्रीगेशन सेवा के प्रस्ताव के लिए, पुष्टि करने की प्रक्रिया में, विज्ञापन टेक्नोलॉजी की मदद से आपकी एग्रीगेशन सेवा में चल रहे कोड की तुलना, ओपन सोर्स कोड से की जाती है.

पुष्टि करने के बारे में ज़्यादा जानें.

योगदान के लिए बॉन्ड

कोऑर्डिनेटर

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

शोर और स्केलिंग

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

ऐडिटिव नॉइज़ मैकेनिज्म के बारे में ज़्यादा पढ़ें. इसे लाप्लास डिस्ट्रिब्यूशन से लिया गया है.

रिपोर्टिंग का ऑरिजिन

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

शेयर किया गया आईडी

A computed value that consists of shared_info, reporting_origin, destination_site (for Attribution Reporting API only), source_registration-time (for Attribution Reporting API only), scheduled_report_time, and version.

Multiple reports that share the same attributes in the shared_info field should have the same shared ID. Shared IDs play an important role within Aggregatable Report Accounting.

Read more about Trusted Servers.

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

Attribution Reporting API और Private Aggregation API रिपोर्ट टाइप. खास जानकारी वाली रिपोर्ट में, उपयोगकर्ता का इकट्ठा किया गया डेटा शामिल होता है. साथ ही, इसमें ग़ैर-ज़रूरी डेटा के साथ कन्वर्ज़न का पूरा डेटा भी शामिल हो सकता है. खास जानकारी वाली रिपोर्ट, एग्रीगेट रिपोर्ट से बनी होती हैं. ये इवेंट-लेवल की रिपोर्टिंग की तुलना में ज़्यादा सुविधाएं देते हैं और बेहतर डेटा मॉडल उपलब्ध कराते हैं. खास तौर पर, कन्वर्ज़न वैल्यू जैसे कुछ इस्तेमाल के उदाहरणों के लिए.

ट्रस्टेड एक्ज़ीक्यूशन एनवायरमेंट (टीईई)

कंप्यूटर हार्डवेयर और सॉफ़्टवेयर का सुरक्षित कॉन्फ़िगरेशन, जिसकी मदद से बाहरी पक्ष, मशीन पर चल रहे सॉफ़्टवेयर के सटीक वर्शन की पुष्टि कर सकते हैं. टीईई की मदद से, बाहरी पक्ष यह पुष्टि कर सकते हैं कि सॉफ़्टवेयर ठीक वैसा ही काम करता है जैसा कि सॉफ़्टवेयर बनाने वाली कंपनी का दावा है. इसमें न तो ज़्यादा और न ही कम काम किया जाता है.

Privacy Sandbox के प्रस्तावों के लिए इस्तेमाल किए जाने वाले टीईई के बारे में ज़्यादा जानने के लिए, Protected Audience API की सेवाओं के बारे में जानकारी और एग्रीगेशन सेवा के बारे में जानकारी पढ़ें.

एग्रीगेशन सेवा का वर्कफ़्लो

एग्रीगेशन सेवा, एग्रीगेट की जा सकने वाली रॉ रिपोर्ट से, कन्वर्ज़न और रीच के ज़्यादा जानकारी वाली रिपोर्ट जनरेट करती है. रिपोर्ट जनरेट करने की प्रोसेस में ये चरण शामिल होते हैं:

1. एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट जनरेट करने के लिए, ब्राउज़र एक सार्वजनिक कुंजी फ़ेच करता है.
2. एग्रीगेट की जा सकने वाली एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट, विज्ञापन टेक्नोलॉजी सर्वर पर भेजी जाती हैं.
3. विज्ञापन टेक्नोलॉजी सर्वर, रिपोर्ट को 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	यह एपीआई, किसी खास जॉब आईडी वाली नौकरी की स्थिति दिखाता है. इससे, जॉब की स्थिति के बारे में जानकारी मिलती है. जैसे,"मिला," "जारी है" या "पूरा हो गया." अगर जॉब पूरा हो जाता है, तो यह जॉब का नतीजा भी दिखाता है. इसमें, जॉब के दौरान मिलने वाली गड़बड़ी के मैसेज भी शामिल होते हैं.

एग्रीगेशन सेवा एपीआई का दस्तावेज़ देखें.

जॉब कतार

मैनेज की जा रही क्लाउड सेवा: 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, नौकरी की प्रोसेस के दौरान नौकरी के मेटाडेटा डेटाबेस को अपडेट करते हैं.

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

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

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

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

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

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

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

अगले चरण

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