سرویس تجمیع، بینشهای عملکردی لازم برای بهبود اثربخشی کمپین با مشتریان را در اختیار تکنسینهای تبلیغات قرار میدهد.
این سند موارد زیر را پوشش میدهد :
- اصطلاحات و مفاهیم کلیدی
- نحوه عملکرد سرویس تجمیع برای ارائه دادههای دقیق تبدیل و اندازهگیری میزان دسترسی از گزارشهای خام قابل تجمیع
- مرور کلی مفهومی دستهبندی گزارشهای قابل تجمیع
- مرور مفهومی اجزای ابر
این سند برای کیست؟
این صفحه به تکنسینها و توسعهدهندگان تبلیغات کمک میکند تا بفهمند چگونه APIهای ما امکان سنجش تبلیغات مؤثر و با حفظ حریم خصوصی را فراهم میکنند.
این سند فرض میکند که شما با APIهای Private Aggregation API ، Attribution Reporting API ، Protected Audience API ، Shared Storage و Trusted Execution Environments آشنا هستید.
اصطلاحات و مفاهیم کلیدی
قبل از ادامه با اصطلاحات کلیدی آشنا شوید:
واژهنامه
- فناوری تبلیغات
-
An ad platform is a company that provides services to deliver ads.
- گزارشهای قابل تجمیع
-
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.
- حسابداری گزارشهای تجمیعی
-
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.
- گزارش تجمیعی بودجه حسابداری
-
ارجاع به بودجه ای که تضمین می کند گزارش های فردی بیش از یک بار پردازش نمی شوند.
- خدمات تجمیع
-
یک سرویس مبتنی بر فناوری تبلیغات که گزارشهای جمعآوریشده را برای ایجاد یک گزارش خلاصه پردازش میکند.
در توضیح ما و فهرست کامل اصطلاحات، درباره پیشینه خدمات تجمع بیشتر بخوانید.
- گواهی
-
A mechanism to authenticate software identity, usually with cryptographic hashes or signatures. For the aggregation service proposal, attestation matches the code running in your ad tech-operated aggregation service with the open source code.
- ضمانت مشارکت
- هماهنگ کننده
-
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.
- شناسه مشترک
-
یک مقدار محاسبهشده که شامل
shared_info،reporting_origin،destination_site(فقط برای Attribution Reporting API)،source_registration-time(فقط برای Attribution Reporting API)،scheduled_report_timeو نسخه است.گزارشهای متعددی که ویژگیهای یکسانی را در قسمت
shared_infoبه اشتراک میگذارند باید دارای شناسه مشترک یکسان باشند. شناسه های مشترک نقش مهمی در حسابداری گزارش جمعی ایفا می کنند. - گزارش خلاصه
-
An Attribution Reporting API and Private Aggregation API report type. A summary report includes aggregated user data, and can contain detailed conversion data with noise added. Summary reports are made up of aggregate reports. They allow for greater flexibility and provide a richer data model than event-level reporting, particularly for some use-cases like conversion values.
- محیط اجرای قابل اعتماد ( 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.
گردش کار سرویس تجمیع
سرویس تجمیع، گزارشهای خلاصهای از دادههای تبدیل و دسترسی دقیق را از گزارشهای خام قابل تجمیع تولید میکند. جریان تولید گزارش شامل مراحل زیر است:
- یک مرورگر برای تولید گزارشهای رمزگذاری شده، یک کلید عمومی را دریافت میکند.
- گزارشهای رمزگذاریشده و قابل جمعآوری به سرورهای فناوری تبلیغات ارسال میشوند.
- سرور فناوری تبلیغات، گزارشها را (با فرمت avro ) دستهبندی کرده و آنها را به سرویس تجمیع ارسال میکند.
- یک کارگر تجمیع، گزارشهای تجمیعشده را برای رمزگشایی بازیابی میکند.
- کارگر تجمیع، کلیدهای رمزگشایی را از یک هماهنگکننده بازیابی میکند.
- کارگر تجمیع، گزارشها را برای تجمیع و نویز رمزگشایی میکند.
- سرویس حسابداری گزارشهای تجمیعی بررسی میکند که آیا بودجه حریم خصوصی کافی برای تولید گزارش خلاصه برای گزارشهای تجمیعی داده شده وجود دارد یا خیر.
- سرویس تجمیع، گزارش خلاصه نهایی را ارائه میدهد.
نمودار زیر، سرویس تجمیع را در عمل، از زمانی که گزارشها از دستگاههای وب و تلفن همراه دریافت میشوند، تا زمانی که یک گزارش خلاصه توسط سرویس تجمیع ایجاد میشود، نشان میدهد.
به طور خلاصه، API گزارشدهی انتسابی یا API تجمیع خصوصی، گزارشهایی را از چندین نمونه مرورگر تولید میکنند. کروم یک کلید عمومی را که هر هفت روز یکبار تغییر میکند، از سرویس میزبانی کلید در هماهنگکننده دریافت میکند تا گزارشها را قبل از ارسال به مبدا گزارشدهی فناوری تبلیغات رمزگذاری کند. مبدا گزارشدهی فناوری تبلیغات، گزارشهای ورودی را جمعآوری و به فرمت avro تبدیل میکند و آنها را به سرویس تجمیع ارسال میکند. هنگامی که یک درخواست دستهای به سرویس تجمیع ارسال میشود، کلیدهای رمزگشایی را از سرویس میزبانی کلید دریافت میکند، گزارشها را رمزگشایی میکند و آنها را تجمیع و نویز میکند تا یک گزارش خلاصه ایجاد کند، البته تا زمانی که بودجه حریم خصوصی کافی برای ایجاد آنها وجود داشته باشد.
برای کسب اطلاعات بیشتر در مورد نحوه تهیه گزارشهای تجمیعی، به بخش پیادهسازی مراجعه کنید.
گزارشهای تجمیعی و دستهبندی آنها
جریان گزارشدهی بدون کمک سرور مبدا گزارشدهی تعیینشده، که شما در طول فرآیند ثبتنام مشخص کردهاید، کامل نخواهد بود. مبدا گزارشدهی مسئول جمعآوری، تبدیل و دستهبندی گزارشهای قابل تجمیع و آمادهسازی آنها برای ارسال به سرویس تجمیع شما در Google Cloud یا Amazon Web Services است. در مورد نحوه تهیه گزارشهای قابل تجمیع خود بیشتر بخوانید.
اجزای ابری
سرویس تجمیع از چندین مؤلفه سرویس ابری تشکیل شده است. شما از اسکریپتهای Terraform ارائه شده برای تهیه و پیکربندی تمام مؤلفههای لازم سرویس ابری استفاده میکنید.
خدمات فرانتاند
سرویس ابری مدیریتشده: عملکرد ابری (گوگل کلود) / درگاه API (خدمات وب آمازون)
سرویس Frontend یک دروازه بدون سرور است که نقطه ورود اصلی برای فراخوانیهای API Aggregation برای ایجاد شغل و بازیابی وضعیت شغل است. این سرویس مسئول دریافت درخواستها از کاربران سرویس Aggregation، اعتبارسنجی پارامترهای ورودی و آغاز فرآیند زمانبندی شغل Aggregation است.
سرویس Frontend دو API در دسترس دارد:
| نقطه پایانی | توضیحات |
|---|---|
createJob | این API یک کار سرویس تجمیع (Aggregation Service) را آغاز میکند. برای آغاز این کار، به اطلاعاتی مانند شناسه کار، جزئیات ذخیرهسازی ورودی، جزئیات ذخیرهسازی خروجی و مبدا گزارش نیاز است. |
getJob | این API وضعیت کار را با داشتن یک شناسه کار مشخص شده برمیگرداند. این API اطلاعاتی در مورد وضعیت کار، مانند "دریافت شده"، "در حال انجام" یا "پایان یافته" ارائه میدهد. اگر کار تمام شده باشد، نتیجه کار، از جمله هرگونه پیام خطایی که در طول اجرای کار با آن مواجه شده است را نیز برمیگرداند. |
مستندات API سرویس تجمیع را بررسی کنید.
صف کار
سرویس ابری مدیریتشده: Pub/Sub (گوگل کلود) / Amazon SQS (خدمات وب آمازون)
صف کار (Job Queue) یک صف پیام است که شامل درخواستهای کار برای سرویس تجمیع (Aggregation Service) میباشد. سرویس Frontend درخواستهای کار را در صف قرار میدهد که سپس توسط Aggregation Workerهایی که آنها را پردازش میکنند، مصرف میشوند.
فضای ذخیرهسازی ابری
سرویس ابری مدیریتشده: فضای ذخیرهسازی ابری گوگل (گوگل کلود) / آمازون S3 (خدمات وب آمازون)
فایلهای ورودی و خروجی مورد استفاده توسط سرویس تجمیع، مانند فایلهای گزارش رمزگذاری شده و گزارشهای خلاصه خروجی، در فضای ذخیرهسازی ابری نگهداری میشوند.
پایگاه داده فراداده شغلی
سرویس ابری مدیریتشده: Spanner (گوگل کلود) / DynamoDB (خدمات وب آمازون)
پایگاه داده فراداده شغل برای ذخیره و پیگیری وضعیت شغلهای تجمیعی استفاده میشود. این پایگاه داده فرادادههایی مانند زمان ایجاد، زمان درخواست، زمان بهروزرسانی و وضعیتی مانند دریافتشده، در حال انجام یا پایانیافته را ثبت میکند. عاملهای تجمیعی، پایگاه داده فراداده شغل را با پیشرفت شغلها بهروزرسانی میکنند.
کارگر تجمیع
سرویس ابری مدیریتشده: موتور محاسباتی با فضای محرمانه (گوگل کلود) / سرویسهای وب آمازون EC2 با Nitro Enclave (سرویسهای وب آمازون).
یک کارگر تجمیع، درخواستهای کار را در صف کار پردازش میکند و ورودیهای رمزگذاری شده را با استفاده از کلیدهایی که از سرویس تولید و توزیع کلید (KGDS) در هماهنگکنندهها دریافت میکند، رمزگشایی میکند. برای به حداقل رساندن تأخیر پردازش کار، کارگران تجمیع، کلیدهای رمزگشایی را به مدت هشت ساعت ذخیره میکنند و از آنها در کارهایی که پردازش میکنند استفاده میکنند.
کارگران تجمعی در یک نمونه محیط اجرای قابل اعتماد (TEE) فعالیت میکنند. یک کارگر فقط یک کار را در یک زمان انجام میدهد. میتوانید با تنظیم پیکربندی مقیاسبندی خودکار، چندین کارگر را برای پردازش موازی کارها پیکربندی کنید. در صورت استفاده، مقیاسبندی خودکار به صورت پویا تعداد کارگران را با توجه به تعداد پیامهای موجود در صف کار تنظیم میکند. میتوانید حداقل و حداکثر تعداد کارگران را برای مقیاسبندی خودکار از طریق فایل محیط Terraform پیکربندی کنید. اطلاعات بیشتر در مورد مقیاسبندی خودکار را میتوانید در این اسکریپتهای Terraform بیابید: Amazon Web Services یا Google Cloud .
کارگران تجمیع، سرویس حسابداری گزارش تجمیعپذیر را برای حسابداری گزارش تجمیعپذیر فراخوانی میکنند. این سرویس تأیید میکند که کارها فقط در صورتی اجرا میشوند که از محدودیت بودجه حریم خصوصی تجاوز نشده باشند. ( به قانون "عدم تکرار" مراجعه کنید.) اگر بودجه در دسترس باشد، یک گزارش خلاصه با استفاده از تجمیعهای نویزی ایجاد میشود. جزئیات بیشتر در مورد حسابداری گزارش تجمیعپذیر را بخوانید.
عاملهای تجمیع، فرادادههای کار را در پایگاه داده فرادادههای کار بهروزرسانی میکنند. این اطلاعات شامل کدهای بازگشت کار و شمارندههای خطای گزارش در صورت خرابی جزئی گزارش است. کاربران میتوانند با استفاده از API بازیابی وضعیت کار getJob وضعیت را دریافت کنند.
برای توضیحات بیشتر در مورد سرویس تجمیع، به این توضیح مراجعه کنید.
مراحل بعدی
اکنون که میدانید سرویس تجمیع چگونه کار میکند، راهنمای شروع به کار را دنبال کنید تا نمونه خود را از طریق Google Cloud یا Amazon Web Services مستقر کنید.