تُنشئ "خدمة التجميع" تقارير موجزة لبيانات الإحالات الناجحة التفصيلية وقياسات مدى الوصول من التقارير الأولية القابلة للتجميع. تتضمّن تقنيات الإعلان نقطتَي دخول رئيسيتين للجمع من جهة العميل لتوجيه التقارير إلى "خدمة التجميع"، إما من خلال Attribution Reporting API أو Private Aggregation API.
حالة التنفيذ
- خدمة التجميع أصبحت متاحة للجمهور العام الآن.
- يمكن استخدام خدمة التجميع مع Attribution Reporting API وPrivate Aggregation API من أجل Protected Audience API وShared Storage API.
مدى التوفّر
| الاقتراح | الحالة |
|---|---|
| إتاحة "خدمة تجميع البيانات" لخدمة Amazon Web Services (AWS) في كلّ من Attribution Reporting API وPrivate Aggregation API
شرح |
متاح |
| إتاحة خدمة التجميع في Google Cloud على مستوى Attribution Reporting API وPrivate Aggregation API شرح |
متاح |
| تسجيل موقع خدمة التجميع والتجميع متعدد المصادر. يتضمن تسجيل الموقع الإلكتروني ربط موقع إلكتروني بحسابات السحابة الإلكترونية (AWS أو GCP). لتجميع مصادر متعددة، يجب أن تكون جميعها من الموقع الإلكتروني نفسه.
الأسئلة الشائعة على GitHub مستندات واجهة برمجة التطبيقات لتجميع المواقع الإلكترونية |
متاح |
| سيتم الاحتفاظ بقيمة epsilon لخدمة التجميع كنطاق يصل إلى 64، لتسهيل التجربة والملاحظات حول المَعلمات المختلفة.
يُرجى إرسال ملاحظات حول نص ARA بتنسيق ARA. إرسال ملاحظات حول الإصدار التجريبي من "إعلانات المنتجات داخل التطبيق" |
متوفرة. سنرسل إشعارًا مسبقًا إلى المنظومة المتكاملة قبل تعديل قيم نطاق "الخطأ المعياري". |
| فلترة أكثر مرونة للمساهمات لطلبات خدمة التجميع
الموضّح |
متاح |
| عملية استرداد الميزانية بعد الكوارث (الأخطاء وإعدادات الضبط غير الصحيحة وما إلى ذلك)
شرح |
متوفّرة آلية لمراجعة النسبة المئوية لأرقام التعريف المشتركة التي استعادتها تقنية عرض الإعلانات باستخدام ميزة استرداد الميزانية وتعليق عمليات الاسترداد المستقبلية لعمليات الاسترداد المفرطة المخطّط لها في النصف الأول من عام 2025 |
| شركة Accenture التي تعمل كأحد المنسقين في AWS
مدوّنة المطوّرين |
متاح |
| جهة مستقلة تعمل كمنسق على Google Cloud
مدوّنة المطوّرين |
متاح |
| إتاحة "خدمة تجميع البيانات" لميزة "إعداد تقارير تصحيح الأخطاء المجمّعة" في Attribution Reporting API
شرح |
متاح |
المصطلحات والمفاهيم الرئيسية
إذا كنت تفكر في استخدام "خدمة التجميع" في سير عمل تكنولوجيا الإعلان، من المفترض أن تقدّم لك المصطلحات والمفاهيم التالية بعض الإحصاءات الإضافية حول ما يمكن أن تقدّمه عملية التجميع الجديدة لفريقك:
| 术语 | 说明 |
|---|---|
| 汇总服务 | 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。 |
| 可汇总的报告 |
التقارير المجمّعة هي تقارير مشفَّرة يتم إرسالها من أجهزة مستخدمين فرديين. تحتوي هذه التقارير على بيانات حول سلوك المستخدمين على عدة مواقع إلكترونية وكذلك الإحالات الناجحة. يحدّد المعلِن أو تقنية الإعلان الإحالات الناجحة (تُسمّى أحيانًا أحداث مشغِّلات الإحالة) والمقاييس المرتبطة بها، ويتم تشفير كل تقرير لمنع الجهات المختلفة من الوصول إلى البيانات الأساسية. 详细了解可汇总的报告。 |
| 可汇总报告的会计核算 | 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。 |
| 可汇总报告的会计核算预算 | 对预算的引用，用于确保报告不会被处理多次。 |
| 可信执行环境 (TEE) |
بيئة التنفيذ الموثوقة هي إعدادات خاصة لمعدّات وبرامج الكمبيوتر تسمح لأطراف خارجية بإثبات صحة الإصدارات الدقيقة للبرامج التي تعمل على الكمبيوتر. TEEs تسمح للأطراف الخارجية بالتحقق من أن البرنامج يؤدي بالضبط ما الشركة المصنعة للبرنامج، لا يوجد شيء أكثر أو أقل. لمزيد من المعلومات عن بيئة التنفيذ الموثوقة (TEE) المستخدَمة في عروض "مبادرة حماية الخصوصية"، يُرجى الاطّلاع على شرح لخدمات Protected Audience API وشرح خدمة التجميع. |
| 协调员 |
المنسّق هو كيان مسؤول عن إدارة المفاتيح ومحاسبة التقارير المجمَّعة. ويحتفظ المُنسِّق بقائمة من تجزئات عمليات الضبط الموافَق عليها لخدمة التجميع ويضبط إمكانية الوصول إلى مفاتيح فك التشفير. |
| 共享 ID |
计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。
这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。
详细了解可信服务器。
|
| 汇总报告 |
التقرير الموجز هو نوع تقرير "Attribution Reporting API" و"واجهة برمجة تطبيقات التجميع الخاص". ملخص بيانات مجمّعة للمستخدمين ويمكن أن يحتوي على بيانات إحالات ناجحة تفصيلية، مع إضافة بعض التشويش. تتألّف التقارير الموجزة من تقارير مجمّعة. تتيح التقارير التلخيصية قدرًا أكبر من المرونة ونموذج بيانات أكثر ثراءً من إعداد التقارير على مستوى الحدث، لا سيما في بعض حالات الاستخدام مثل قيم الإحالات الناجحة. |
| 举报来源 |
مصدر إعداد التقارير هو الكيان الذي يتلقّى تقارير قابلة للتجميع، أي تكنولوجيا الإعلان التي تستدعي Attribution Reporting API. يتم إرسال التقارير القابلة للتجميع من أجهزة المستخدمين إلى عنوان URL معروف مرتبط بمصدر reporting . يجب تحديد مصدر إعداد التقارير هذا أثناء التسجيل. |
| 贡献债券 | 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。 |
| 噪声和缩放 | 在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。 |
| 证明 |
المصادقة هي آلية لمصادقة هوية البرامج، وعادةً ما تتم باستخدام عمليات التشفير أو التوقيعات. بالنسبة إلى عرض خدمة التجميع، تتطابق المصادقة مع الرمز الذي يتم تشغيله في خدمة التجميع التي تشغّلها تكنولوجيا الإعلانات مع الرمز مفتوح المصدر. 详细了解证明。 |
يمكنك الاطّلاع على مزيد من المعلومات حول الخلفية المتعلّقة بخدمة التجميع في الشرح وقائمة البنود الكاملة.
حالات استخدام التجميع
راجِع تجارب المطوّرين التالية لقياس الإعلانات ومكتبات عملاء القياس المقابلة لها.
| حالة الاستخدام | نقطة الإدخال | الوصف |
|---|---|---|
| تحسين عروض الأسعار | 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) ويرسلها إلى "خدمة التجميع" المنشورة. (يجب إكمالها من خلال تكنولوجيا الإعلان).
- استرداد التقارير المجمّعة لفك التشفير
- استرداد مفاتيح فك التشفير من المنسقين
- تُشفِّر خدمة تجميع البيانات التقارير لتجميعها وإخفاء هويتها.
- تتحقّق خدمة محاسبة التقارير القابلة للتجميع ممّا إذا كانت هناك أي ميزانية خصوصية متبقّية لإنشاء تقرير تلخيصي للتقارير القابلة للتجميع المحدّدة.
- أرسِل التقرير النهائي الملخّص.
من المخطّط البياني، يمكنك الاطّلاع على العلاقة العامة التي تربط "خدمة التجميع" بواجهتَي برمجة التطبيقات الرئيسيتَين لقياس الأداء لدى العملاء، وهما 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)
Frontend Service هي بوابة بدون خادم تُستخدَم كنقطة دخول لطلبات البيانات من واجهة برمجة التطبيقات 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]
يُطلِق Aggregation Worker طلبًا إلى خدمة "محاسبة التقارير القابلة للتجميع" من أجل محاسبة التقارير القابلة للتجميع. تضمن خدمة محاسبة التقارير القابلة للتجميع عدم تنفيذ المهام إلا ما دامت لم تتجاوز حدّ ميزانية الخصوصية. (راجِع قاعدة"عدم السماح بالنُسخ المكرّرة"). إذا كانت الميزانية متاحة، يتم إنشاء تقرير تلخيصي باستخدام القيم المجمّعة التي تتضمّن بيانات غير مرغوب فيها. يمكنك الاطّلاع على تفاصيل إضافية حول تجميع تقارير المحاسبة.
يعدّل Worker Aggregation البيانات الوصفية للمهمة في قاعدة بيانات البيانات الوصفية للمهام، بما في ذلك رموز الإرجاع المناسبة للمهام وعدادات أخطاء التقارير في حال حدوث أخطاء جزئية في التقارير. يمكن للمستخدمين جلب الحالة باستخدام واجهة برمجة التطبيقات لاسترداد حالة المهام (getJob).
للحصول على وصف أكثر تفصيلاً لخدمة التجميع، يُرجى الرجوع إلى الشرح.
الخطوات التالية
بعد الاطّلاع على أهم تفاصيل "خدمة التجميع"، حان وقت نشر نسختك الخاصة من "خدمة التجميع" من خلال Google Cloud أو Amazon Web Services. يمكنك الاطّلاع على قسم "البدء" أو إذا كنت بحاجة إلى مزيد من المعلومات حول كيفية تشغيل "خدمة التجميع" المنشورة، يمكنك اتّباع هذا الرابط للاطّلاع على مزيد من المعلومات حول تشغيل "خدمة التجميع".
تحديد المشاكل وحلّها
يُرجى الرجوع إلى مستند رموز الأخطاء الشائعة والتخفيف منها للحصول على أوصاف أكثر تفصيلاً لرسائل الخطأ، والسبب المحتمَل للخطأ الذي تواجهه، والخطوات التالية للتخفيف من تأثيره.
الحصول على الدعم وتقديم الملاحظات
- إذا كانت لديك أسئلة حول المنتجات أو ملاحظات أو طلبات ميزات، يمكنك إنشاء مشكلة في مستودع GitHub.
- لطلب الدعم الفني لتحديد المشاكل وحلّها في حال مواجهة خطأ أثناء نشر المهام أو صيانتها أو تشغيلها باستخدام "خدمة التجميع"، يُرجى استخدام نموذج الدعم الفني هذا.
- يُرجى الانتقال إلى لوحة البيانات العامة للحالة للاطّلاع على المشاكل المعروفة.