Aggregation Service

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

इस पेज पर यह माना गया है कि आप विज्ञापन टेक्नोलॉजी के बारे में जानकार हैं. इस पेज पर ये चीज़ें शामिल हैं:

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

उपलब्धता

Proposal Status
Requerying enables ad techs to process Aggregation Service reports multiple times, supporting flexible analysis for different measurement needs.
GitHub Issue
Upcoming in H2 2025
Cross Cloud Privacy Budget Service
Explainer
Available
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
Cross-cloud cryptographic key services
Explainer
Expected in H1 2025

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

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

शब्दावली

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

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.

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

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

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

An ad tech-operated service that processes aggregatable reports to create a summary report.

Read more about the Aggregation Service backstory in our explainer and the full terms list.

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

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

Read more about attestation.

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

Entities responsible for key management and aggregatable report accounting. A Coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.

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

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

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

शिकायत करने का सोर्स

The entity that receives aggregatable reports—in other words, you or an 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. The reporting origin is designated during enrollment.

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

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 रिपोर्ट टाइप. खास जानकारी वाली रिपोर्ट में, उपयोगकर्ता का इकट्ठा किया गया डेटा शामिल होता है. साथ ही, इसमें ग़ैर-ज़रूरी डेटा के साथ कन्वर्ज़न का पूरा डेटा भी शामिल हो सकता है. खास जानकारी वाली रिपोर्ट, एग्रीगेट रिपोर्ट से बनी होती हैं. ये इवेंट-लेवल की रिपोर्टिंग की तुलना में ज़्यादा सुविधाएं देते हैं और बेहतर डेटा मॉडल उपलब्ध कराते हैं. खास तौर पर, कन्वर्ज़न वैल्यू जैसे कुछ इस्तेमाल के उदाहरणों के लिए.

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

A secure configuration of computer hardware and software that allows external parties to verify the exact versions of software running on the machine without fear of exposure. 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.

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

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

इस्तेमाल का उदाहरण आने की जगह ब्यौरा
बिडिंग ऑप्टिमाइज़ेशन 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. विज्ञापन टेक्नोलॉजी सर्वर, रिपोर्ट को avro फ़ॉर्मैट में बैच में डालता है और उन्हें एग्रीगेशन सेवा को भेजता है. (आपको यह पूरा करना होगा.)
  4. एग्रीगेशन वर्कर्स, एग्रीगेट की गई रिपोर्ट को डिक्रिप्ट करने के लिए वापस लाता है.
  5. एग्रीगेशन वर्कर्स, कोऑर्डिनेटर से डिक्रिप्ट करने की कुंजियां हासिल करता है.
  6. एग्रीगेशन वर्कर, एग्रीगेशन और नॉइज़ करने के लिए रिपोर्ट को डिक्रिप्ट करता है.
  7. एग्रीगेट की जा सकने वाली रिपोर्ट की लेखांकन सेवा यह जांच करती है कि एग्रीगेट की जा सकने वाली दी गई रिपोर्ट के लिए खास जानकारी वाली रिपोर्ट जनरेट करने के लिए, निजता बजट काफ़ी है या नहीं.
  8. खास जानकारी वाली फ़ाइनल रिपोर्ट सबमिट करें.

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

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

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

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

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

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

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

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

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

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

Aggregation Service के क्लाउड कॉम्पोनेंट.
एग्रीगेशन सेवा के क्लाउड कॉम्पोनेंट.

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

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

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

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

एंडपॉइंट ब्यौरा
createJob यह एपीआई, Aggregation Service जॉब को ट्रिगर करता है. जॉब को ट्रिगर करने के लिए, इसमें जॉब आईडी, इनपुट स्टोरेज की जानकारी, आउटपुट स्टोरेज की जानकारी, रिपोर्टिंग ऑरिजिन वगैरह की ज़रूरत होती है.
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)

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

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

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

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

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

अगले चरण

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

समस्या का हल

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

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

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