Aggregation Service

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

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

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

उपलब्धता

提案 状态
跨云隐私预算服务
说明
可用
针对 Attribution Reporting API、Private Aggregation API 中的 Amazon Web Services (AWS) 提供汇总服务支持
说明
可用
针对 Attribution Reporting API、Private Aggregation API 的 Google Cloud 汇总服务支持
说明
可用
汇总服务网站注册和多源汇总。网站注册包括将网站映射到云账号(AWS 或 GCP)。如需汇总多个来源,这些来源必须属于同一网站。
GitHub 上的常见问题解答
Site aggregation API 文档
可用
汇总服务的 epsilon 值将保持在 64 以内的范围内,以便对不同的参数进行实验和反馈。
提交 ARA 小数值反馈
提交 PAA 小数值反馈
可用。在更新 epsilon 范围值之前,我们会提前通知生态系统。
为汇总服务查询提供了更灵活的贡献过滤功能
解说
可用
灾难发生后(错误、配置错误等)预算恢复流程
说明
已推出
机制,用于查看广告技术平台使用预算恢复功能恢复的共享 ID 的百分比,并暂停计划在 2025 年上半年过度恢复的未来恢复
Accenture 是 AWS 协调者之一
开发者博客
可用
作为 Google Cloud 协调者之一的独立方
开发者博客
可用
汇总服务支持 Attribution Reporting API 上的汇总调试报告
说明
可用
跨云加密密钥服务
解说
预计 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.

अलग-अलग डेटा को मिलाकर तैयार की गई रिपोर्ट का हिसाब

分布式账本,位于两个协调者中,用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制,可确保没有任何报告在通过汇总服务时超出分配的隐私预算。

详细了解批处理策略与可汇总报告之间的关系

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

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

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

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

如需详细了解汇总服务的背景信息,请参阅我们的说明文档完整条款列表

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

一种用于对软件身份进行身份验证的机制,通常使用加密哈希或签名。对于汇总服务提案,认证会将广告技术平台运营的汇总服务中运行的代码与开源代码进行匹配。

详细了解认证

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

负责密钥管理和汇总报告会计核算的实体。协调者会维护已获批准的汇总服务配置的哈希列表,并配置对解密密钥的访问权限。

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

在汇总过程中向摘要报告添加的统计噪声,用于保护隐私并确保最终报告提供匿名化衡量信息。

详细了解加法噪声机制,该机制是从拉普拉斯分布中提取的。

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

接收可汇总报告的实体,也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。

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

计算值,由 shared_inforeporting_origindestination_site(仅限 Attribution Reporting API)、source_registration-time(仅限 Attribution Reporting API)、scheduled_report_time 和版本组成。

如果多个报告在 shared_info 字段中具有相同的属性,则应具有相同的共享 ID。共享 ID 在可汇总报告的会计核算中发挥着重要作用。

详细了解可信服务器

सारांश रिपोर्ट

Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据,并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比,这些报告具有更高的灵活性,并提供更丰富的数据模型,对于转化价值等某些用例尤其如此。

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

计算机硬件和软件的安全配置,可让外部方验证机器上运行的软件的确切版本,而无需担心信息泄露。通过 TEE,外部方可以确认软件的行为和功能与其制造商声称的完全一致,不多不少。

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

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

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

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