سرویس تجمع

Aggregation Service گزارش‌های خلاصه‌ای از داده‌های تبدیل دقیق و اندازه‌گیری‌های دستیابی را از گزارش‌های انبوه‌سازی خام تولید می‌کند. فن‌آوری‌های تبلیغاتی دارای دو نقطه ورود مجموع اصلی در سمت مشتری هستند تا گزارش‌ها را از طریق API گزارش Attribution یا Private Aggregation به سرویس Aggregation منتقل کنند.

وضعیت پیاده سازی

• Aggregation Service اکنون به در دسترس بودن عمومی منتقل شده است.
• Aggregation Service را می‌توان با Attribution Reporting API و Private Aggregation API برای Protected Audience API و Shared Storage API استفاده کرد.

در دسترس بودن

پیشنهاد	وضعیت
سرویس بودجه حریم خصوصی Cross Cloud توضیح دهنده	موجود است
پشتیبانی از خدمات جمع‌آوری برای خدمات وب آمازون (AWS) در API گزارش اسناد، API جمع‌آوری خصوصی توضیح دهنده	موجود است
پشتیبانی از سرویس تجمیع برای Google Cloud در API گزارش Attribution، API جمع‌آوری خصوصی توضیح دهنده	موجود است
ثبت نام سایت خدمات تجمع و تجمیع چند منبع. ثبت نام سایت شامل نگاشت یک سایت به حساب های ابری (AWS یا GCP) است. برای جمع آوری چندین منبع، آنها باید از یک سایت باشند. سوالات متداول در GitHub اسناد API تجمع سایت	موجود است
برای تسهیل آزمایش و بازخورد در مورد پارامترهای مختلف، مقدار اپسیلون سرویس Aggregation تا محدوده 64 حفظ می‌شود. بازخورد اپسیلون ARA را ارسال کنید . بازخورد PAA epsilon را ارسال کنید .	موجود است. قبل از به‌روزرسانی مقادیر محدوده اپسیلون، اطلاعیه‌های پیشرفته‌ای به اکوسیستم ارائه خواهیم کرد.
فیلتر مشارکت انعطاف‌پذیرتر برای جستارهای خدمات جمع‌آوری توضیح دهنده	موجود است
فرآیند بازیابی بودجه پس از فاجعه (خطاها، پیکربندی‌های نادرست و غیره) توضیح دهنده	موجود است مکانیسم بررسی درصد شناسه‌های مشترک بازیابی شده توسط فناوری تبلیغات با استفاده از بازیابی بودجه و تعلیق بازیابی‌های آینده برای بازیابی‌های بیش از حد برنامه‌ریزی‌شده برای نیمه اول ۲۰۲۵
Accenture به عنوان یکی از هماهنگ کننده ها در AWS فعالیت می کند وبلاگ توسعه دهنده	موجود است
حزب مستقل که به عنوان یکی از هماهنگ کننده ها در Google Cloud عمل می کند وبلاگ توسعه دهنده	موجود است
پشتیبانی از سرویس تجمع برای گزارش اشکال زدایی جمعی در API گزارش انتساب توضیح دهنده	موجود است

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

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

术语	说明
汇总服务	由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。
可汇总的报告	可汇总报告是从各个用户设备发送的加密报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和关联的指标由广告主或广告技术平台定义。每个报告都会加密，以防止多方访问基础数据。 详细了解可汇总的报告。
可汇总报告的会计核算	位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。
可汇总报告的会计核算预算	对预算的引用，用于确保报告不会被处理多次。
可信执行环境 (TEE)	可信执行环境是计算机硬件和软件的一种特殊配置， 验证计算机上运行的软件的确切版本。TEEs 允许外部各方验证软件是否完全按照 软件制造商声称可以，不多或少。 如需详细了解用于 Privacy Sandbox 提案的 TEE，请参阅 Protected Audience API 服务说明文档 以及汇总服务说明。
协调员	نهادهای مسئول مدیریت کلیدی و حسابداری گزارش انبوه. یک Coordinator فهرستی از هش‌های پیکربندی‌های سرویس تجمیع تایید شده را نگهداری می‌کند و دسترسی به کلیدهای رمزگشایی را پیکربندی می‌کند.
共享 ID	计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。 这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。 详细了解可信服务器。
汇总报告	گزارش خلاصه یک نوع گزارش API گزارش اسناد و API جمع‌آوری خصوصی است. گزارش خلاصه شامل داده‌های کاربر جمع‌آوری می‌شود و می‌تواند حاوی داده‌های تبدیل دقیق، با اضافه شدن نویز باشد. گزارش های خلاصه از گزارش های انبوه تشکیل شده است. گزارش‌های خلاصه، انعطاف‌پذیری بیشتر و مدل داده‌ای غنی‌تر را نسبت به گزارش‌دهی در سطح رویداد، به ویژه برای برخی موارد استفاده مانند مقادیر تبدیل، امکان‌پذیر می‌سازد.
举报来源	منبع گزارش، نهادی است که گزارش‌های انبوهی را دریافت می‌کند - به عبارت دیگر، فناوری تبلیغاتی که API گزارش انتساب نامیده می‌شود. گزارش‌های جمع‌آوری‌شده از دستگاه‌های کاربر به یک URL معروف مرتبط با منبع گزارش ارسال می‌شوند. این مبدا گزارش باید در هنگام ثبت نام مشخص شود.
贡献债券	可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。
噪声和缩放	在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。
证明	认证是一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务方案，证明会将广告技术平台运营的汇总服务中运行的代码与开放源代码进行匹配。 详细了解证明。

در توضیح ما و فهرست کامل اصطلاحات، درباره پیشینه خدمات تجمع بیشتر بخوانید.

موارد استفاده از تجمع

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

مورد استفاده	نقطه ورود	توضیحات
بهینه سازی مناقصه	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)	از گزارش های انبوه برای به دست آوردن توزیع ارزش های پیشنهادی برای مزایده ها استفاده کنید.

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

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

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

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

این جریان با Measurement API های مختلف مانند Attribution Reporting API یا Private Aggregation API شروع می شود که گزارش هایی را از چندین نمونه مرورگر ایجاد می کند. Chrome کلید عمومی را از سرویس میزبانی کلید در Coordinator می گیرد تا گزارش ها را قبل از ارسال به منبع گزارش فناوری تبلیغات رمزگذاری کند. کلیدهای عمومی هر هفت روز یکبار چرخانده می شوند.

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

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

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

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

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

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

اجزای ابر

Aggregation Service از اجزای مختلف سرویس ابری تشکیل شده است. اسکریپت های Terraform ارائه شده، تمام اجزای خدمات ابری لازم را ارائه و پیکربندی می کند.

سرویس Frontend

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

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

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

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

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

صف کار

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

Job Queue یک صف پیام است که درخواست های شغلی را برای Aggregation Service ذخیره می کند. سرویس Frontend پیام‌های درخواست شغل را در صف قرار می‌دهد، که سپس توسط Aggregation Worker برای پردازش درخواست کار مصرف می‌شود.

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

سرویس ابری مدیریت‌شده: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services) فضای ذخیره‌سازی ابری برای ذخیره فایل‌های ورودی و خروجی مورد استفاده توسط Aggregation Service استفاده می‌شود (مثلاً: فایل‌های گزارش رمزگذاری‌شده، گزارش‌های خلاصه خروجی، و غیره).

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

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

Job Metadata Database وضعیت مشاغل تجمیع را ذخیره و ردیابی می کند. پایگاه داده ابرداده هایی مانند زمان ایجاد، زمان درخواستی، زمان به روز رسانی و وضعیت را ثبت می کند (مثلاً: دریافت شده، در حال انجام، پایان یافته و غیره). Aggregation Worker با پیشرفت کار، پایگاه داده فراداده شغلی را به روز می کند.

کارگر تجمع

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

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

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

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

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

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

مراحل بعدی

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

عیب یابی

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

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

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