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

एग्रीगेशन सेवा, रॉ एग्रीगेट करने लायक रिपोर्ट से ज़्यादा जानकारी वाले कन्वर्ज़न डेटा और रीच मेज़रमेंट की खास जानकारी वाली रिपोर्ट जनरेट करती है. एग्रीगेशन सेवा को रिपोर्ट फ़नल करने के लिए, 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 上的汇总调试报告的支持
说明		 可用

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

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

术语 说明
汇总服务 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。
可汇总的报告

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

详细了解可汇总的报告。
可汇总报告的会计核算 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。
可汇总报告的会计核算预算 对预算的引用，用于确保报告不会被处理多次。
可信执行环境 (TEE)

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

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

कोऑर्डिनेटर ऐसी इकाई होती है जो मुख्य मैनेजमेंट और एग्रीगेटेड रिपोर्ट अकाउंटिंग के लिए ज़िम्मेदार होती है. कोऑर्डिनेटर, स्वीकार किए गए एग्रीगेशन सेवा कॉन्फ़िगरेशन के हैश की सूची बनाए रखता है और डिक्रिप्शन कुंजियों के ऐक्सेस को कॉन्फ़िगर करता है.
共享 ID 计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。 这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。 详细了解可信服务器。
汇总报告

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

समस्या का हल

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

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