سرویس تجمع

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

این صفحه فرض می کند که شما یک فناوری تبلیغاتی با تجربه هستید. پوشش می دهد:

• وضعیت پیاده سازی
• اصطلاحات و مفاهیم کلیدی
• موارد استفاده از تجمع
• جریان انتها به انتها
• دسته بندی گزارش های انبوه
• اجزای ابر

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

• اکنون سرویس تجمع به در دسترس بودن عمومی منتقل شده است.
• سرویس Aggregation را می‌توان با API گزارش اسناد و API جمع‌آوری خصوصی برای API مخاطب محافظت‌شده و ذخیره‌سازی مشترک 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 گزارش انتساب توضیح دهنده	موجود است
خدمات کلید رمزنگاری بین ابری توضیح دهنده	انتظار می رود در نیمه اول 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_info、reporting_origin、destination_site（仅限 Attribution Reporting API）、source_registration-time（仅限 Attribution Reporting API）、scheduled_report_time 和版本组成。

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

详细了解可信服务器。

گزارش خلاصه

یک API گزارش انتساب و نوع گزارش 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)	ایجاد گزارش تبدیل انبوه متناسب با نیازهای کمپین مشتریان (شامل 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 با خطا مواجه می‌شوید، از این فرم پشتیبانی فنی استفاده کنید.
• داشبورد وضعیت عمومی را برای مشکلات شناخته شده بررسی کنید.