سرویس تجمع

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

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

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

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

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

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

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

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

分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。

详细了解批处理策略与可汇总报告之间的关系。

گزارش جمع آوری بودجه حسابداری

ارجاع به بودجه ای که تضمین می کند گزارش های فردی بیش از یک بار پردازش نمی شوند.

سرویس تجمع

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

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

تصدیق

一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务提案，认证会将广告技术平台运营的汇总服务中运行的代码与开源代码进行匹配。

详细了解认证。

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

نهادهای مسئول مدیریت کلیدی و حسابداری گزارش انبوه. یک Coordinator فهرستی از هش‌های پیکربندی‌های سرویس تجمیع تایید شده را نگهداری می‌کند و دسترسی به کلیدهای رمزگشایی را پیکربندی می‌کند.

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

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

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

منبع گزارش

نهادی که گزارش‌های جمع‌آوری‌شده را دریافت می‌کند - به عبارت دیگر، شما یا یک فناوری تبلیغاتی که API گزارش Attribution نامیده می‌شود. گزارش‌های جمع‌آوری‌شده از دستگاه‌های کاربر به یک URL معروف مرتبط با منبع گزارش ارسال می‌شوند. مبدا گزارش در هنگام ثبت نام تعیین می شود.

شناسه مشترک

计算值，由 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 ها به طرف های خارجی اجازه می دهند تا تأیید کنند که نرم افزار دقیقاً همان کاری را که سازنده نرم افزار ادعا می کند انجام می دهد - نه بیشتر یا کمتر.

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