تُنشئ خدمة التجميع تقارير موجزة عن بيانات الإحالات الناجحة التفصيلية وقياسات مدى الوصول من التقارير الأولية القابلة للتجميع. بصفتك جهة تقنية للإعلانات، يمكنك استخدام Attribution Reporting API وPrivate Aggregation API، وهما نقطتا الدخول الرئيسيتان للجمع على جانب العميل، لتوجيه التقارير إلى خدمة التجميع وتلقّي تقرير تلخيصي في الردّ.
تفترض هذه الصفحة أنّك خبير في مجال تكنولوجيا الإعلان، وهي تتناول ما يلي:
- حالة التنفيذ
- المصطلحات والمفاهيم الرئيسية
- حالات استخدام التجميع
- المسار الكامل
- تجميع التقارير القابلة للتجميع
- مكونات السحابة الإلكترونية
حالة التنفيذ
- أصبحت ميزة خدمة التجميع متوفرة الآن للجمهور العام.
- يمكن استخدام خدمة التجميع مع Attribution Reporting API وPrivate Aggregation API من أجل Protected Audience API وShared Storage API.
مدى التوفّر
| Proposal | Status |
|---|---|
| Requerying enables ad techs to process Aggregation Service
reports multiple times, supporting flexible analysis for different measurement
needs.
GitHub Issue |
Upcoming in H2 2025 |
| 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 |
| Cross-cloud cryptographic key services
Explainer |
Expected in H1 2025 |
المصطلحات والمفاهيم الرئيسية
إذا كنت تفكر في استخدام "خدمة التجميع" في سير عملك، قد تقدّم لك المصطلحات والمفاهيم التالية إحصاءات حول ما يمكن أن تقدّمه عملية التجميع الجديدة لفريقك.
مسرد المصطلحات
- التقارير القابلة للتجميع
-
التقارير القابلة للتجميع هي تقارير مشفّرة يتم إرسالها من أجهزة المستخدمين الفرديين. تحتوي هذه التقارير على بيانات عن سلوك المستخدِمين والإحالات الناجحة على جميع المواقع الإلكترونية. يحدّد المعلن أو تكنولوجيا الإعلان الإحالات الناجحة (التي تُسمّى أحيانًا أحداث تشغيل عملية تحديد المصدر) والمقاييس المرتبطة بها. ويتم تشفير كل تقرير لمنع الجهات المختلفة من الوصول إلى البيانات الأساسية.
- إعداد التقارير القابلة للتجميع
-
دفتر حسابات موزَّع، يقع في كلا المنسّقين، يتتبّع ميزانية الخصوصية المخصّصة ويفرض قاعدة "عدم السماح بنسخ البيانات". هذه هي آلية الحفاظ على الخصوصية، التي يتمّ تحديد موقعها وتشغيلها ضمن المنظّمات، والتي تضمن عدم مرور أيّ تقارير من خلال خدمة التجميع بما يتجاوز ميزانية الخصوصية المخصّصة.
اطّلِع على مزيد من المعلومات عن كيفية ارتباط استراتيجيات تجميع البيانات بالتقارير القابلة للتجميع.
- ميزانية محاسبية للتقارير القابلة للتجميع
-
إشارات إلى الميزانية تضمن عدم معالجة التقارير الفردية أكثر من مرة
- خدمة تجميع البيانات
-
خدمة تديرها تكنولوجيا الإعلان تعالج التقارير القابلة للتجميع لإنشاء تقرير تلخيصي.
يمكنك الاطّلاع على مزيد من المعلومات حول الخلفية المتعلّقة بخدمة التجميع في الشرح وقائمة الأحكام الكاملة.
- الإقرار
-
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_origindestination_site(لواجهة برمجة التطبيقات Attribution Reporting API فقط)،source_registration-time(لواجهة برمجة التطبيقات Attribution Reporting API فقط)،scheduled_report_timeوالإصداريجب أن تتشارك التقارير المتعددة التي تتضمّن السمات نفسها في الحقل
shared_infoالمعرّف المشترَك نفسه. تؤدي المعرّفات المشترَكة دورًا مهمًا في محاسبة التقارير القابلة للتجميع. - تقرير موجز
-
نوع تقرير Attribution Reporting API وPrivate Aggregation 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) | إنشاء تقارير مجمّعة للإحالات الناجحة مخصّصة لاحتياجات حملات العملاء (تشمل تقارير "تكلفة التحويل" و"تكلفة التفاعل") |
| قياس مدى وصول الحملة إلى الجمهور | Shared Storage API & Private Aggregation API (Chrome) | استخدِم متغيّرات مرّات ظهور الإعلان على مستوى الموقع الإلكتروني لقياس مدى وصول الحملة إلى الجمهور. |
| إعداد تقارير الخصائص الديمغرافية | Shared Storage API & Private Aggregation API (Chrome) | استخدِم معلومات المشاهدات والخصائص الديمغرافية على جميع المواقع الإلكترونية لقياس مدى الوصول إلى الجمهور حسب الخصائص الديمغرافية. |
| تحليل مسار الإحالة الناجحة | Shared Storage API & Private Aggregation API (Chrome) | تخزين متغيّرات الإحالات الناجحة ومرات عرض الإعلان على مستوى الموقع الإلكتروني لإجراء تحليل مجمّع لمسارات الإحالات الناجحة |
| تأثير العلامة التجارية وتحسين الإحالات الناجحة | Shared Storage API & Private Aggregation API (Chrome) | إعداد تقارير عن المجموعات التجريبية/المجموعات الأساسية ومعلومات الاستطلاعات لقياس تأثير العلامة التجارية والزيادة |
| تصحيح أخطاء المزاد | Protected Audience API & Private Aggregation API (Chrome) | استخدِم التقارير المجمّعة لتصحيح الأخطاء. |
| توزيع عروض الأسعار | Protected Audience API & Private Aggregation API (Chrome) | استخدِم التقارير المجمّعة لتسجيل توزيع قيم عروض الأسعار للمزادات. |
الخطوات التي يجب اتّباعها
يوضّح الرسم البياني التالي "خدمة التجميع" أثناء العمل. سنركّز على العملية الكاملة من وقت استلام التقارير من الويب والأجهزة الجوّالة إلى وقت إنشاء التقرير الملخّص في "خدمة التجميع".
- استرجاع المفتاح العام لإنشاء تقارير مشفّرة
- يتم إرسال التقارير القابلة للتجميع والمشفَّرة إلى خوادم تكنولوجيا الإعلان لتجميعها وتحويلها إلى حِزم.
- يُجمِّع خادم تكنولوجيا الإعلان التقارير (بتنسيق avro) ويرسلها إلى "خدمة التجميع". (يجب إكمال هذا الإجراء).
- يسترجع Worker Aggregation التقارير المجمّعة لفك تشفيرها.
- يستردّ "مشغِّل التجميع" مفاتيح فك التشفير من "المنسق".
- يفكّ رمز التقارير عامل التجميع لأغراض التجميع وإدخال التشويش.
- تتحقّق خدمة محاسبة التقارير القابلة للتجميع ممّا إذا كانت هناك ميزانية خصوصية كافية لإنشاء تقرير تلخيصي للتقارير القابلة للتجميع المحدّدة.
- أرسِل تقريرًا نهائيًا ملخّصًا.
يعرض المخطّط البياني العلاقات العالية المستوى التي تربط "خدمة التجميع" بواجهات برمجة التطبيقات الرئيسية لقياس الأداء على مستوى العميل: Attribution Reporting API وPrivate Aggregation API و"المنسّقون".
تبدأ العملية بوساطة واجهات برمجة تطبيقات القياس، مثل Attribution Reporting API أو Private Aggregation API، لإنشاء تقارير من نُسخ متعدّدة من المتصفّح. يحصل Chrome على المفتاح العام من خدمة استضافة المفاتيح في "المنسق" لتشفير التقارير قبل إرسالها إلى مصدر إعداد تقارير تكنولوجيا الإعلان. يتم تغيير المفاتيح العامة كل سبعة أيام.
يجب ضبط مصدر إعداد تقارير تقنية الإعلان لجمع التقارير الواردة وتحويلها إلى تنسيق avro وإرسالها إلى خدمة التجميع كما هو موضّح في استراتيجيات تجميع البيانات.
عندما يكون لديك دفعة جاهزة، يمكنك إرسال طلب دفعة إلى خدمة التجميع. تُستخدَم خدمة التجميع لجلب مفاتيح فك التشفير من خدمة استضافة المفاتيح وفك تشفير التقارير وتجميعها وإخفاء هويتها لإنشاء تقرير تلخيصي. يُرجى العِلم أنّ ذلك يعتمد على توفّر ميزانية خصوصية كافية لإنشاء هذه التقارير.
يمكنك استضافة نقطة نهاية مصدر إعداد تقارير تكنولوجيا الإعلان التي يتم فيها جمع التقارير، ويتم نشر "خدمة التجميع" في السحابة الإلكترونية لتكنولوجيا الإعلان.
تجميع التقارير القابلة للتجميع
لن تكتمل عملية إعداد التقارير بدون مساعدة خادم مصدر إعداد التقارير المحدّد. هذا هو مصدر البيانات الذي أرسلته في عملية التسجيل. تتحمّل مصدر إعداد التقارير مسؤولية جمع التقارير القابلة للتجميع التي تتلقّاها وتحويلها وتجميعها وإعدادها لإرسالها إلى "خدمة التجميع" في Google Cloud أو Amazon Web Services. اطّلِع على مزيد من المعلومات حول كيفية إعداد التقارير القابلة للتجميع.
بعد أن تعرّفت على المفهوم العام، يمكننا إلقاء نظرة فاحصة على المكوّنات التي يتم نشرها في "خدمة التجميع".
مكوّنات السحابة الإلكترونية
تتألف خدمة التجميع من عدة مكوّنات لخدمة السحابة الإلكترونية. يمكنك استخدام النصوص البرمجية Terraform المقدَّمة لتوفير جميع مكوّنات خدمة السحابة الإلكترونية اللازمة وضبطها.
خدمة الواجهة الأمامية
خدمة السحابة الإلكترونية المُدارة: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)
خدمة الواجهة هي بوابة لا تعمل على خادم، وهي نقطة الدخول الأساسية لطلبات Aggregation API لإنشاء المهام واسترداد حالة المهام. وهي مسؤولة عن تلقّي الطلبات من مستخدمي "خدمة التجميع" والتحقّق من مَعلمات الإدخال وبدء عملية جدولة مهام التجميع.
تتوفّر واجهتَا برمجة تطبيقات لخدمة الواجهة الأمامية:
| نقطة نهاية | الوصف |
|---|---|
createJob |
تؤدي واجهة برمجة التطبيقات هذه إلى بدء مهمة "خدمة تجميع البيانات". ويتطلّب ذلك معلومات مثل رقم تعريف المهمة وتفاصيل مساحة تخزين الإدخال وتفاصيل مساحة تخزين الإخراج ومصدر إعداد التقارير وغير ذلك، لبدء المهمة. |
getJob |
تعرض واجهة برمجة التطبيقات هذه حالة المهمة التي لها معرّف مهمة محدّد. يوفّر معلومات عن حالة المهمة، مثل "تم استلامها" أو "قيد التقدّم" أو "انتهت". إذا اكتملت المهمة، يعرض أيضًا نتيجة المهمة، بما في ذلك أي رسائل خطأ حدثت أثناء تنفيذ المهمة. |
اطّلِع على مستندات واجهة برمجة التطبيقات لـ Aggregation Service.
قائمة المهام
خدمة السحابة الإلكترونية المُدارة: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)
"قائمة الوظائف" هي قائمة رسائل تحتوي على طلبات وظائف لخدمة التجميع. تُدرج خدمة الواجهة الأمامية طلبات المهام في "قائمة الانتظار"، والتي تستهلكها بعد ذلك عمليات تجميع البيانات التي تعالج هذه الطلبات.
مساحة التخزين في السحابة الإلكترونية
خدمة السحابة الإلكترونية المُدارة: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)
يتم الاحتفاظ بملفات الإدخال والإخراج التي تستخدمها "خدمة التجميع"، مثل ملفات التقارير المشفّرة وتقارير ملخّص النتائج، في مساحة التخزين في السحابة الإلكترونية.
قاعدة بيانات البيانات الوصفية للوظائف
خدمة السحابة الإلكترونية المُدارة: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)
تُستخدَم قاعدة بيانات البيانات الوصفية للمهام لتخزين حالة مهام التجميع وتتبُّعها. ويُسجِّل هذا السجلّ البيانات الوصفية، مثل وقت الإنشاء والوقت المطلوب والوقت الذي تم فيه التعديل والحالة، مثل "تم استلامه" أو "جارٍ" أو "انتهى". يعدّل العاملون في التجميع قاعدة بيانات البيانات الوصفية للوظائف أثناء تقدّم الوظائف.
عامل تجميع
خدمة السحابة الإلكترونية المُدارة: محرّك حساب الأداء مع مساحة سرية (Google Cloud) / Amazon Web Services EC2 مع Nitro Enclave (Amazon Web Services)
يعالج عامل التجميع طلبات المهام في قائمة انتظار المهام، ويفكّ تشفير الإدخالات المشفَّرة باستخدام المفاتيح التي يجلبُها من خدمة إنشاء المفاتيح وتوزيعها (KGDS) في "المنسّقين". لتقليل وقت الاستجابة في معالجة المهام، تُخزِّن "خوادم تجميع البيانات" مفاتيح فك التشفير مؤقتًا لمدة 8 ساعات، وتستخدمها في جميع المهام التي تعالجها.
تعمل وحدات "تجميع البيانات" ضمن مثيل بيئة تنفيذ موثوقة (TEE). يعالج العامل وظيفة واحدة فقط في كل مرة. يمكنك ضبط عمال متعدّدين لمعالجة المهام بشكل موازٍ من خلال ضبط إعدادات التوسّع التلقائي. في حال استخدام ميزة "التحجيم التلقائي"، يتم ضبط عدد عمال الجلسة ديناميكيًا وفقًا لعدد الرسائل في قائمة الوظائف. يمكنك ضبط الحد الأدنى والحد الأقصى لعدد عمال التوسّع التلقائي من خلال ملف بيئة Terraform. يمكن العثور على مزيد من المعلومات حول توسيع النطاق التلقائي في نصوص Terraform البرمجية التالية: Amazon Web Services أو Google Cloud.
يتصل "عاملو التجميع" بخدمة "تجميع التقارير" لإعداد تقارير مجمّعة. تضمن هذه الخدمة عدم تنفيذ المهام إلا إذا لم يتم تجاوز الحد الأقصى لميزانية الخصوصية. (اطّلِع على قاعدة"عدم السماح بنسخ طبق الأصل"). إذا كانت الميزانية متاحة، يتم إنشاء تقرير تلخيصي باستخدام القيم المجمّعة التي تتضمّن بيانات غير مرغوب فيها. اطّلِع على تفاصيل إضافية حول تجميع تقارير المحاسبة.
يعدّل "عاملو التجميع" البيانات الوصفية للوظائف في "قاعدة بيانات البيانات الوصفية للوظائف". وتشمل هذه المعلومات رموز إرجاع المهام وعدادات أخطاء التقارير في حال حدوث أخطاء جزئية في التقارير. يمكن للمستخدمين جلب الحالة باستخدام واجهة برمجة التطبيقات getJob لاسترداد حالة المهام.
اطّلِع على هذا الشرح للحصول على وصف أكثر تفصيلاً لخدمة التجميع.
الخطوات التالية
بعد الاطّلاع على أهم ميزات "خدمة التجميع"، حان وقت نشر نسختك الخاصة من "خدمة التجميع" من خلال Google Cloud أو Amazon Web Services. اطّلِع على قسم "البدء"، أو اتّبِع هذا الرابط للتعرّف على مزيد من المعلومات عن تشغيل "خدمة التجميع".
تحديد المشاكل وحلّها
راجِع مستند رموز الأخطاء الشائعة والتخفيف منها للحصول على أوصاف تفصيلية لرسائل الخطأ، والسبب المحتمَل لظهور الخطأ الذي تواجهه، والخطوات التالية للتخفيف من تأثيره.
الحصول على الدعم وتقديم الملاحظات
- إذا كانت لديك أسئلة حول المنتجات أو ملاحظات أو طلبات ميزات، يمكنك إنشاء مشكلة في مستودع GitHub.
- لطلب الدعم الفني لتحديد المشاكل وحلّها في حال مواجهة خطأ أثناء نشر المهام أو صيانتها أو تشغيلها باستخدام "خدمة التجميع"، يُرجى استخدام نموذج الدعم الفني هذا.
- يُرجى الانتقال إلى لوحة البيانات العامة للحالة للاطّلاع على المشاكل المعروفة.