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

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

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

उपलब्धता

Proposal Status
Aggregation Service support for Amazon Web Services (AWS) across Attribution Reporting API, Private Aggregation API
Explainer		 Available
Aggregation Service support for Google Cloud across Attribution Reporting API, Private Aggregation API
Explainer		 Available
Aggregation Service site enrollment and multi-origin aggregation. Site enrollment includes mapping of a site to cloud accounts (AWS, or GCP). To aggregate multiple origins, they must be of the same site.
FAQs on GitHub
Site aggregation API documentation 		Available
The Aggregation Service's epsilon value will be kept as a range of up to 64, to facilitate experimentation and feedback on different parameters.
Submit ARA epsilon feedback.
Submit PAA epsilon feedback.		 Available. We will provide advanced notice to the ecosystem before the epsilon range values are updated.
More flexible contribution filtering for Aggregation Service queries
Explainer		 Available
Process for budget recovery post-disasters (errors, misconfigurations, and so on)
Explainer		 Available
Mechanism to review the percentage of shared IDs recovered by an ad tech using budget recovery and suspend future recoveries for excessive recoveries planned for H1 2025
Accenture operating as one of the Coordinators on AWS
Developer Blog		 Available
Independent party operating as one of the Coordinators on Google Cloud
Developer blog		 Available
Aggregation Service support for Aggregate Debug Reporting on Attribution Reporting API
Explainer		 Available

मुख्य शब्द और सिद्धांत

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

Term Description
Aggregation Service An ad tech-operated service that processes aggregatable reports to create a summary report.
Aggregatable Reports

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.
Aggregatable Report Accounting A distributed ledger located in both coordinators that tracks allocated privacy budget and enforces the 'No Duplicates' rule. This is the privacy preserving mechanism, located and run within coordinators, that ensures that no report passes through Aggregation Service beyond the allocated privacy budget. Read more on batching strategies on how it relates to aggregatable reports.
Aggregatable Report Accounting Budget References to the budget that ensures reports are not processed more than once.
Trusted Execution Environment (TEE)

A trusted execution environment is a special configuration of computer hardware and software that allows external parties to verify the exact versions of software running on the computer. TEEs allow external parties to verify that the software does exactly what the software manufacturer claims it does—nothing more or less.

To learn more about TEEs used for the Privacy Sandbox proposals, read the Protected Audience API services explainer and the Aggregation Service explainer.
Coordinators

कोऑर्डिनेटर ऐसी इकाई होती है जो मुख्य मैनेजमेंट और एग्रीगेटेड रिपोर्ट अकाउंटिंग के लिए ज़िम्मेदार होती है. कोऑर्डिनेटर, स्वीकार किए गए एग्रीगेशन सेवा कॉन्फ़िगरेशन के हैश की सूची बनाए रखता है और डिक्रिप्शन कुंजियों के ऐक्सेस को कॉन्फ़िगर करता है.
Shared ID Computed value that consists of: shared_info, reporting_origin, destination_site (available for Attribution Reporting API only), source_registration-time (available for Attribution Reporting API only), scheduled_report_time, version. This means that multiple reports belong to the same shared ID should they share the same attributes of the shared_info field. This plays an important role within Aggregatable Report Accounting. Read more about Trusted Servers.
Summary Report

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

The reporting origin is the entity that receives aggregatable reports—in other words, the ad tech that called the Attribution Reporting API. Aggregatable reports are sent from user devices to a well-known URL associated with the reporting origin. This reporting origin should be designated during enrollment.
Contribution Bonding Aggregatable reports may contain an arbitrary number of counter increments. For example, a report may contain a count of products that a user has viewed on an advertiser's site. The sum of increments in all aggregatable reports related to a single source event must not exceed a given limit, `L1=2^16`. Learn more in the aggregatable reports explainer.
Noise & Scaling A certain amount of statistical noise is added to summary reports as a part of the aggregation process that also functions to preserve privacy and ensure the final reports provide anonymized measurement information. Read more about additive noise mechanism, which is drawn from Laplace distribution.
Attestation

Attestation is a mechanism to authenticate software identity, usually with cryptographic hashes or signatures. For the aggregation service proposal, attestation matches the code running in the ad tech-operated aggregation service with the open source code.

Read more about attestation.

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

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

विज्ञापनों की परफ़ॉर्मेंस का आकलन करने और उनसे जुड़ी क्लाइंट लाइब्रेरी के मेज़रमेंट के लिए, डेवलपर के इन अनुभवों को ध्यान में रखें.

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

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

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

एग्रीगेशन सेवा का एंड-टू-एंड फ़्लो

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

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

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

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

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

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

इकट्ठा की जा सकने वाली रिपोर्ट के बैच बनाना

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

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

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

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

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

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

मैनेज की जा रही क्लाउड सेवा: क्लाउड फ़ंक्शन (Google क्लाउड) / एपीआई गेटवे (Amazon वेब सेवाएं)

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

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

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

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

जॉब कतार

मैनेज की जा रही क्लाउड सेवा: Pub/Sub (Google Cloud) / Amazon SQS (Amazon वेब सेवाएं)

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

क्लाउड स्टोरेज

मैनेज की जा रही क्लाउड सेवा: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon वेब सेवाएं) क्लाउड स्टोरेज का इस्तेमाल, एग्रीगेशन सेवा में इस्तेमाल की गई इनपुट और आउटपुट फ़ाइलों को स्टोर करने के लिए किया जाता है. जैसे, एन्क्रिप्ट (सुरक्षित) की गई रिपोर्ट फ़ाइलें, आउटपुट की खास जानकारी वाली रिपोर्ट वगैरह.

नौकरी का मेटाडेटा डेटाबेस

मैनेज की जा रही क्लाउड सेवा: Spanner (Google क्लाउड) / DynamoDB (Amazon वेब सेवाएं)

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

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

मैनेज की जाने वाली क्लाउड सेवा: गोपनीय स्पेस वाला 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 की मदद से, अपने एग्रीगेशन सेवा के अपने इंस्टेंस को डिप्लॉय करने का समय आ गया है. इसके लिए, शुरुआत करने वाला सेक्शन देखें या अगर आपको डिप्लॉय की गई एग्रीगेशन सेवा के इस्तेमाल के बारे में ज़्यादा जानकारी चाहिए, तो एग्रीगेशन सेवा चलाने के बारे में ज़्यादा जानें.

समस्या का हल

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

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