سرویس تجمع

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

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

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

در دسترس بودن

Proposal Status
Cross Cloud Privacy Budget Service
Explainer		 Available
Aggregation Service support for Amazon Web Services (AWS) across Attribution Reporting API, Private Aggregation API
Explainer		 Available
Aggregation Service support for Google Cloud across Attribution Reporting API, Private Aggregation API
Explainer		 Available
Aggregation Service site enrollment and multi-origin aggregation. Site enrollment includes mapping of a site to cloud accounts (AWS, or GCP). To aggregate multiple origins, they must be of the same site.
FAQs on GitHub
Site aggregation API documentation 		Available
The Aggregation Service's epsilon value will be kept as a range of up to 64, to facilitate experimentation and feedback on different parameters.
Submit ARA epsilon feedback.
Submit PAA epsilon feedback.		 Available. We will provide advanced notice to the ecosystem before the epsilon range values are updated.
More flexible contribution filtering for Aggregation Service queries
Explainer		 Available
Process for budget recovery post-disasters (errors, misconfigurations, and so on)
Explainer		 Available
Mechanism to review the percentage of shared IDs recovered by an ad tech using budget recovery and suspend future recoveries for excessive recoveries planned for H1 2025
Accenture operating as one of the Coordinators on AWS
Developer Blog		 Available
Independent party operating as one of the Coordinators on Google Cloud
Developer blog		 Available
Aggregation Service support for Aggregate Debug Reporting on Attribution Reporting API
Explainer		 Available

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

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

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

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

گزارش‌های انبوه، گزارش‌های رمزگذاری‌شده‌ای هستند که از دستگاه‌های کاربر جداگانه ارسال می‌شوند. این گزارش‌ها حاوی داده‌هایی درباره رفتار کاربران بین سایتی و تبدیل‌ها هستند. تبدیل‌ها (گاهی اوقات رویدادهای راه‌اندازی اسناد نامیده می‌شوند) و معیارهای مرتبط توسط تبلیغ‌کننده یا فناوری تبلیغات تعریف می‌شوند. هر گزارش برای جلوگیری از دسترسی طرف های مختلف به داده های اساسی رمزگذاری شده است.

درباره گزارش‌های جمع‌آوری‌شده بیشتر بیاموزید .

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

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.

سرویس تجمع

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

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

تصدیق

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

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

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

Entities responsible for key management and aggregatable report accounting. A Coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.

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

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

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

منبع گزارش

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.

گزارش خلاصه

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