سرویس تجمع

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

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

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

در دسترس بودن

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

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

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

مدت	توضیحات
سرویس تجمع	یک سرویس مبتنی بر فناوری تبلیغات که گزارش‌های جمع‌آوری‌شده را برای ایجاد یک گزارش خلاصه پردازش می‌کند.
گزارش های جمع آوری	گزارش‌های انبوه، گزارش‌های رمزگذاری‌شده‌ای هستند که از دستگاه‌های کاربر جداگانه ارسال می‌شوند. این گزارش‌ها حاوی داده‌هایی درباره رفتار کاربران بین سایتی و تبدیل‌ها هستند. تبدیل‌ها (گاهی اوقات رویدادهای راه‌اندازی اسناد نامیده می‌شوند) و معیارهای مرتبط توسط تبلیغ‌کننده یا فناوری تبلیغات تعریف می‌شوند. هر گزارش برای جلوگیری از دسترسی طرف های مختلف به داده های اساسی رمزگذاری شده است. درباره گزارش‌های جمع‌آوری‌شده بیشتر بیاموزید .
حسابداری گزارش انبوه	یک دفتر کل توزیع شده واقع در هر دو هماهنگ کننده که بودجه اختصاص داده شده حریم خصوصی را ردیابی می کند و قانون "بدون تکرار" را اجرا می کند. این مکانیزم حفظ حریم خصوصی است که در هماهنگ‌کننده‌ها قرار گرفته و اجرا می‌شود و تضمین می‌کند که هیچ گزارشی فراتر از بودجه حفظ حریم خصوصی اختصاص‌یافته از طریق سرویس تجمیع عبور نمی‌کند. در مورد استراتژی‌های دسته‌بندی درباره نحوه ارتباط آن با گزارش‌های جمع‌آوری بیشتر بخوانید.
گزارش جمع آوری بودجه حسابداری	ارجاع به بودجه ای که تضمین می کند گزارش ها بیش از یک بار پردازش نمی شوند.
محیط اجرای مورد اعتماد ( TEE )	یک محیط اجرای قابل اعتماد، پیکربندی ویژه ای از سخت افزار و نرم افزار کامپیوتر است که به طرف های خارجی اجازه می دهد تا نسخه های دقیق نرم افزار در حال اجرا بر روی رایانه را تأیید کنند. TEE ها به طرف های خارجی اجازه می دهند تا تأیید کنند که نرم افزار دقیقاً همان کاری را که سازنده نرم افزار ادعا می کند انجام می دهد - نه بیشتر یا کمتر. برای کسب اطلاعات بیشتر در مورد TEE های مورد استفاده برای پیشنهادات جعبه ایمنی حریم خصوصی، توضیح خدمات API مخاطبین محافظت شده و توضیح سرویس تجمع را بخوانید.
هماهنگ کننده ها	هماهنگ کننده نهادی است که مسئولیت مدیریت کلیدی و حسابداری گزارش انبوه را بر عهده دارد. هماهنگ‌کننده فهرستی از هش‌های پیکربندی‌های سرویس تجمیع تایید شده را نگهداری می‌کند و دسترسی به کلیدهای رمزگشایی را پیکربندی می‌کند.
شناسه مشترک	مقدار محاسبه‌شده شامل: shared_info ، reporting_origin ، destination_site (فقط برای Attribution Reporting API موجود)، source_registration-time (فقط برای Attribution Reporting API موجود)، scheduled_report_time ، version . این بدان معنی است که چندین گزارش به یک شناسه اشتراک‌گذاری شده تعلق دارند، در صورتی که ویژگی‌های یکسان فیلد shared_info را به اشتراک بگذارند. این نقش مهمی در حسابداری گزارش انباشته ایفا می کند. درباره سرورهای مورد اعتماد بیشتر بخوانید.
گزارش خلاصه	گزارش خلاصه یک نوع گزارش 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 با خطا مواجه می‌شوید، از این فرم پشتیبانی فنی استفاده کنید.
• داشبورد وضعیت عمومی را برای مشکلات شناخته شده بررسی کنید.