سرویس تجمع

سرویس تجمیع گزارش‌های خلاصه از داده‌های تبدیل دقیق و اندازه‌گیری‌های دستیابی را از گزارش‌های انباشت‌پذیر خام تولید می‌کند. به‌عنوان فناوری تبلیغات، می‌توانید از API گزارش انتساب و 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 上的汇总调试报告的支持
说明		 可用

اصطلاحات و مفاهیم کلیدی

اگر سرویس تجمیع را برای گردش کار خود در نظر می گیرید، اصطلاحات و مفاهیم زیر ممکن است بینشی در مورد آنچه که این جریان تجمیع جدید می تواند برای تیم شما فراهم کند ارائه دهد.

واژه نامه اصطلاحات

گزارش های جمع آوری

可汇总的报告是从单个用户设备发送的经过加密的报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和相关指标由广告客户或广告技术平台定义。每个报告均已加密，以防止各方访问底层数据。

详细了解可汇总的报告。

حسابداری گزارش انبوه

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.

گزارش جمع آوری بودجه حسابداری

References to the budget that ensures individual reports are not processed more than once.

سرویس تجمع

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.

تصدیق

مکانیزمی برای احراز هویت نرم افزار، معمولاً با هش ها یا امضاهای رمزنگاری . برای پیشنهاد سرویس تجمیع، گواهی کد اجرا شده در سرویس تجمیع فناوری تبلیغاتی شما را با کد منبع باز مطابقت می دهد.

در مورد گواهینامه بیشتر بخوانید .

پیوند مشارکت
هماهنگ کننده

نهادهای مسئول مدیریت کلیدی و حسابداری گزارش انبوه. یک Coordinator فهرستی از هش‌های پیکربندی‌های سرویس تجمیع تایید شده را نگهداری می‌کند و دسترسی به کلیدهای رمزگشایی را پیکربندی می‌کند.

نویز و پوسته پوسته شدن

نویز آماری که در طول فرآیند تجمیع به گزارش‌های خلاصه اضافه می‌شود تا حریم خصوصی حفظ شود و اطمینان حاصل شود که گزارش‌های نهایی اطلاعات اندازه‌گیری ناشناس را ارائه می‌کنند.

در مورد مکانیسم نویز افزایشی که از توزیع لاپلاس گرفته شده است بیشتر بخوانید.

منبع گزارش

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) ایجاد گزارش تبدیل انبوه متناسب با نیازهای کمپین مشتریان (شامل CTC و VTC).
اندازه گیری دسترسی کمپین API ذخیره‌سازی مشترک و API جمع‌آوری خصوصی (Chrome) برای اندازه گیری میزان دسترسی کمپین، از متغیرهای مشاهده تبلیغات بین سایتی استفاده کنید.
گزارش دموگرافیک API ذخیره‌سازی مشترک و API جمع‌آوری خصوصی (Chrome) برای اندازه گیری میزان دسترسی بر اساس اطلاعات جمعیتی، از نمای تبلیغات بین سایتی و اطلاعات جمعیتی استفاده کنید.
تجزیه و تحلیل مسیر تبدیل API ذخیره‌سازی مشترک و API جمع‌آوری خصوصی (Chrome) مشاهده آگهی بین سایتی و متغیرهای تبدیل را برای انجام تجزیه و تحلیل مسیر تبدیل انباشته ذخیره کنید.
افزایش نام تجاری و تبدیل API ذخیره‌سازی مشترک و API جمع‌آوری خصوصی (Chrome) گزارش در مورد گروه های آزمایش/کنترل و اطلاعات نظرسنجی برای اندازه گیری افزایش و افزایش برند.
اشکال زدایی حراج API مخاطب محافظت شده و API جمع‌آوری خصوصی (Chrome) از گزارش های انبوه برای اشکال زدایی استفاده کنید.
توزیع پیشنهادات API مخاطب محافظت شده و API جمع‌آوری خصوصی (Chrome) از گزارش های انبوه برای به دست آوردن توزیع ارزش های پیشنهادی برای مزایده ها استفاده کنید.

جریان انتها به انتها

نمودار زیر سرویس تجمع را در حال عمل نشان می دهد. از زمانی که گزارش‌ها از وب و دستگاه‌های تلفن همراه دریافت می‌شوند تا زمانی که گزارش خلاصه در سرویس تجمیع ایجاد می‌شود، بر جریان سرتاسری تمرکز می‌کنیم.

جریان خدمات جمع آوری انتها به انتها
جریان خدمات جمع آوری انتها به انتها
  1. برای تولید گزارش های رمزگذاری شده، کلید عمومی را واکشی کنید.
  2. گزارش‌های انبوه رمزگذاری‌شده به سرورهای فناوری تبلیغات ارسال می‌شوند تا جمع‌آوری، تبدیل و دسته‌بندی شوند.
  3. سرور فناوری تبلیغات گزارش‌ها را دسته‌بندی می‌کند (در قالب avro) و آنها را به سرویس تجمع ارسال می‌کند. (شما باید این را کامل کنید.)
  4. یک کارگر جمع‌آوری گزارش‌های جمع‌آوری شده را برای رمزگشایی بازیابی می‌کند.
  5. Aggregation Worker کلیدهای رمزگشایی را از یک Coordinator بازیابی می کند.
  6. Aggregation Worker گزارش ها را برای تجمع و نویز رمزگشایی می کند.
  7. خدمات حسابداری گزارش انبوهی بررسی می کند که آیا بودجه حفظ حریم خصوصی کافی برای ایجاد یک گزارش خلاصه برای گزارش های جمع آوری داده شده وجود دارد یا خیر.
  8. گزارش خلاصه نهایی را ارسال کنید.

این نمودار روابط سطح بالایی را نشان می‌دهد که سرویس تجمع با APIهای اندازه‌گیری مشتری اصلی دارد: API گزارش اسناد ، API جمع‌آوری خصوصی و هماهنگ‌کننده‌ها.

این جریان با APIهای اندازه‌گیری، مانند API گزارش انتساب یا API جمع‌آوری خصوصی شروع می‌شود و گزارش‌هایی را از چندین نمونه مرورگر ایجاد می‌کند. Chrome کلید عمومی را از سرویس میزبانی کلید در Coordinator دریافت می‌کند تا گزارش‌ها را قبل از ارسال به مبدا گزارش‌دهی فناوری تبلیغات شما رمزگذاری کند. کلیدهای عمومی هر هفت روز یکبار چرخانده می شوند.

مبدا گزارش‌دهی فناوری تبلیغات شما باید طوری پیکربندی شود که گزارش‌های دریافتی را به فرمت avro جمع‌آوری و تبدیل کند و همانطور که در استراتژی‌های دسته‌بندی توضیح داده شده است، آنها را به سرویس تجمیع ارسال کند.

هنگامی که یک دسته آماده دارید، یک درخواست دسته ای را به سرویس تجمع ارسال می کنید. سرویس تجمیع کلیدهای رمزگشایی را از سرویس میزبانی کلید واکشی می‌کند، گزارش‌ها را رمزگشایی می‌کند و آنها را جمع‌آوری و نویز می‌کند تا یک گزارش خلاصه ایجاد کند. به خاطر داشته باشید که این بستگی به وجود بودجه حفظ حریم خصوصی برای ایجاد آنها دارد.

شما میزبان نقطه پایانی مبدا گزارش‌دهی فناوری تبلیغات هستید که در آن گزارش‌ها جمع‌آوری می‌شوند و سرویس تجمیع در ابر فناوری تبلیغات شما مستقر می‌شود.

دسته بندی گزارش های انبوه

جریان گزارش بدون کمک سرور منبع گزارش تعیین شده کامل نمی شود. این منبعی است که در فرآیند ثبت نام ارسال می کردید. منبع گزارش مسئول جمع‌آوری، تبدیل و دسته‌بندی گزارش‌های انباشته‌ای است که دریافت می‌کند و آماده‌سازی آنها برای ارسال به سرویس تجمع شما در Google Cloud یا Amazon Web Services. در مورد نحوه تهیه گزارش های انبوه خود بیشتر بخوانید.

اکنون که مفهوم کلی را دارید، می‌توانیم نگاهی دقیق‌تر به مؤلفه‌هایی بیندازیم که در سرویس تجمیع شما مستقر شده‌اند.

اجزای ابر

سرویس تجمیع شامل چندین مؤلفه سرویس ابری است. شما از اسکریپت های Terraform ارائه شده برای تهیه و پیکربندی تمام اجزای خدمات ابری ضروری استفاده می کنید.

اجزای ابری سرویس تجمع
اجزای ابری سرویس تجمع

سرویس Frontend

سرویس ابری مدیریت شده: عملکرد ابر (Google Cloud) / دروازه API (سرویس وب آمازون)

سرویس Frontend یک دروازه بدون سرور است که نقطه ورود اولیه برای فراخوان های Aggregation API برای ایجاد شغل و بازیابی وضعیت شغلی است. مسئولیت دریافت درخواست‌های کاربران سرویس تجمع، اعتبارسنجی پارامترهای ورودی و آغاز فرآیند زمان‌بندی کار تجمیع را بر عهده دارد.

سرویس Frontend دو API در دسترس دارد:

نقطه پایانی توضیحات
createJob این API یک کار Aggregation Service را راه اندازی می کند. برای فعال کردن کار به اطلاعاتی مانند شناسه شغل، جزئیات ذخیره سازی ورودی، جزئیات ذخیره سازی خروجی، مبدا گزارش و موارد دیگر نیاز دارد.
getJob این API وضعیت کار را با شناسه شغلی مشخص برمی گرداند. اطلاعاتی درباره وضعیت کار، مانند "دریافت"، "در حال انجام" یا "تمام" ارائه می دهد. اگر کار تمام شد، نتیجه کار را نیز برمی‌گرداند، از جمله هر پیام خطایی که در طول اجرای کار با آن مواجه می‌شوید.

اسناد API Service Aggregation را بررسی کنید.

صف کار

سرویس ابری مدیریت شده: Pub/Sub (Google Cloud) / Amazon SQS (سرویس وب آمازون)

Job Queue یک صف پیام حاوی درخواست های شغلی برای سرویس Aggregation است. سرویس Frontend درخواست‌های شغلی را در صف قرار می‌دهد، که سپس توسط کارگران جمع‌آوری که آنها را پردازش می‌کنند مصرف می‌شود.

ذخیره سازی ابری

سرویس ابری مدیریت شده: Google Cloud Storage (Google Cloud) / آمازون S3 (سرویس وب آمازون)

فایل های ورودی و خروجی مورد استفاده توسط سرویس تجمع، مانند فایل های گزارش رمزگذاری شده و گزارش های خلاصه خروجی، در فضای ذخیره سازی ابری نگهداری می شوند.

پایگاه داده فراداده شغلی

سرویس ابری مدیریت شده: Spanner (Google Cloud) / DynamoDB (سرویس وب آمازون)

پایگاه داده فراداده شغلی برای ذخیره و ردیابی وضعیت مشاغل تجمیع استفاده می شود. این ابرداده مانند زمان ایجاد، زمان درخواستی، زمان به‌روزرسانی و وضعیتی مانند دریافت، در حال انجام، یا پایان را ثبت می‌کند. Aggregation Workers پایگاه داده فراداده شغلی را با پیشرفت مشاغل به روز می کنند.

کارگر تجمع

سرویس ابری مدیریت شده: موتور محاسباتی با فضای محرمانه (Google Cloud) / خدمات وب آمازون EC2 با Nitro Enclave (سرویس وب آمازون)

یک کارگر جمع‌آوری درخواست‌های شغلی را در Job Queue پردازش می‌کند و ورودی‌های رمزگذاری‌شده را با استفاده از کلیدهایی که از سرویس تولید و توزیع کلید (KGDS) در Coordinators واکشی می‌کند، رمزگشایی می‌کند. برای به حداقل رساندن تأخیر پردازش کار، Aggregation Workers کلیدهای رمزگشایی را برای مدت 8 ساعت در حافظه پنهان نگه می دارد و از آنها در کارهایی که پردازش می کنند استفاده می کند.

کارگران تجمیع در یک نمونه محیط اجرای معتمد (TEE) عمل می کنند. یک کارگر در یک زمان تنها یک کار را انجام می دهد. شما می توانید چندین کارگر را برای پردازش موازی کارها با تنظیم پیکربندی مقیاس خودکار پیکربندی کنید. در صورت استفاده، مقیاس خودکار به صورت پویا تعداد کارگران را با توجه به تعداد پیام‌های موجود در صف کار تنظیم می‌کند. شما می توانید حداقل و حداکثر تعداد کارگران را برای مقیاس خودکار از طریق فایل محیط Terraform پیکربندی کنید. اطلاعات بیشتر درباره مقیاس خودکار را می‌توانید در این اسکریپت‌های Terraform پیدا کنید: خدمات وب آمازون یا Google Cloud .

کارگران تجمیع برای حسابداری گزارش تجمیع با خدمات حسابداری گزارش انبوه تماس می گیرند. این سرویس تضمین می‌کند که مشاغل تنها در صورتی اجرا می‌شوند که از محدودیت بودجه حفظ حریم خصوصی تجاوز نکرده باشند. (به قانون "بدون تکرار" مراجعه کنید.) اگر بودجه در دسترس باشد، یک گزارش خلاصه با استفاده از مجموعات پر سر و صدا ایجاد می شود. جزئیات بیشتر در مورد حسابداری گزارش انبوه را بخوانید.

Aggregation Workers فراداده های شغلی را در پایگاه داده فراداده شغلی به روز می کند. این اطلاعات شامل کدهای بازگشت شغل و شمارشگرهای خطای گزارش در صورت عدم موفقیت جزئی گزارش است. کاربران می توانند با استفاده از getJob job retrieval API وضعیت را واکشی کنند.

برای توضیحات دقیق تر از سرویس تجمیع به این توضیح مراجعه کنید.

مراحل بعدی

اکنون که نکات برجسته سرویس تجمیع را دیدید، زمان آن فرا رسیده است که نمونه خود را از سرویس تجمیع از طریق Google Cloud یا خدمات وب آمازون اجرا کنید. بخش شروع کار را ببینید یا این پیوند را دنبال کنید تا در مورد عملکرد سرویس تجمع بیشتر بدانید.

عیب یابی

برای توضیح دقیق پیام‌های خطا، آنچه ممکن است باعث خطای شما شده باشد و مراحل بعدی کاهش، به سند کدهای خطای رایج و اقدامات کاهشی مراجعه کنید.

دریافت پشتیبانی و ارائه بازخورد

  • برای سؤالات محصول، بازخورد و درخواست‌های ویژگی، مشکلی را در مخزن GitHub ما ایجاد کنید.
  • برای درخواست پشتیبانی عیب‌یابی فنی، اگر در حین استقرار، نگهداری یا اجرای کارها با Aggregation Service با خطا مواجه می‌شوید، از این فرم پشتیبانی فنی استفاده کنید.
  • داشبورد وضعیت عمومی را برای مشکلات شناخته شده بررسی کنید.