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

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

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

उपलब्धता

提案 状态
针对 Attribution Reporting API、Private Aggregation API 中的 Amazon Web Services (AWS) 提供汇总服务支持
说明
可用
跨 Attribution Reporting API、Private Aggregation API 为 Google Cloud 提供汇总服务支持
说明文档
可用
汇总服务网站注册和多源汇总。网站注册包括将网站映射到云账号(AWS 或 GCP)。若要汇总多个源站,这些源站必须属于同一个网站。
GitHub 上的常见问题解答
网站汇总 API 文档
可用
汇总服务的 epsilon 值将保持一个不超过 64 的范围,以方便对不同参数的实验和反馈。
提交 ARA 小数值反馈
提交 PAA 小数值反馈
可用。在更新 epsilon 范围值之前,我们会提前通知整个生态系统。
为汇总服务查询提供更灵活的贡献过滤功能
解说
可用
灾难后(错误、配置错误等)的预算恢复流程
解说
提供
机制,用于审核广告技术平台使用预算挽回功能找回的共享 ID 所占百分比,以及针对 2025 年上半年计划恢复的过多账号恢复请求暂停未来恢复机制
Accenture 是 AWS 协调者之一
开发者博客
可用
担任 Google Cloud 协调员之一的独立方
开发者博客
可用
汇总服务对 Attribution Reporting API 上的汇总调试报告的支持
说明
可用

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

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

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

可汇总报告是从各个用户设备发送的加密报告。这些报告包含有关跨网站用户行为和转化的数据。转化(有时称为归因触发器事件)和关联的指标由广告主或广告技术平台定义。每个报告都会加密,以防止多方访问基础数据。

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)

可信执行环境是计算机硬件和软件的一种特殊配置, 验证计算机上运行的软件的确切版本。TEEs 允许外部各方验证软件是否完全按照 软件制造商声称可以,不多或少。

如需详细了解用于 Privacy Sandbox 提案的 TEE,请参阅 Protected Audience API 服务说明文档 以及汇总服务说明

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

报告来源是接收可汇总报告的实体,也就是调用 Attribution Reporting API 的广告技术平台。可汇总报告的来源 将用户设备转到与报告关联的已知网址 来源。此报告来源应在注册期间指定。

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

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

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

समस्या का हल

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

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