تُنشئ "خدمة التجميع" تقارير موجزة لبيانات الإحالات الناجحة التفصيلية وقياسات مدى الوصول من التقارير الأولية القابلة للتجميع. تتضمّن تقنيات الإعلان نقطتَي دخول رئيسيتين للجمع من جهة العميل لتوجيه التقارير إلى "خدمة التجميع"، إما من خلال Attribution Reporting API أو Private Aggregation API.
حالة التنفيذ
- تم نقل خدمة التجميع الآن إلى مرحلة التوفّر للجمهور العام.
- يمكن استخدام خدمة التجميع مع Attribution Reporting API وPrivacy 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 وشرح خدمة التجميع. |
| المنسّقون |
المنسّق هو كيان مسؤول عن إدارة المفاتيح ومحاسبة التقارير المجمَّعة. ويحتفظ المُنسِّق بقائمة من تجزئات عمليات الضبط الموافَق عليها لخدمة التجميع ويضبط إمكانية الوصول إلى مفاتيح فك التشفير. |
| رقم التعريف المشترك |
قيمة محسوبة تتألف من: shared_info وreporting_origin وdestination_site (متوفّرة لواجهة برمجة التطبيقات Attribution Reporting API فقط) وsource_registration-time (متوفّرة لواجهة برمجة التطبيقات Attribution Reporting API فقط) وscheduled_report_time وversion.
وهذا يعني أنّ تقارير متعدّدة تنتمي إلى رقم التعريف المشترك نفسه في حال كانت تتضمّن السمات نفسها الواردة في الحقل shared_info. ويلعب هذا الدور دورًا مهمًا في "تجميع التقارير المحاسبية".
مزيد من المعلومات عن "الخوادم الموثوق بها"
|
| تقرير موجز |
التقرير الموجز هو نوع تقرير "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 وPrivacy Aggregation API (Chrome) | استخدام ميزة عرض الإعلان على مواقع إلكترونية ومعلومات ديمغرافية لقياس مدى الوصول إلى الجمهور حسب الخصائص الديمغرافية. |
| تحليل مسار الإحالات الناجحة | Shared Storage API & Private Aggregation API (Chrome) | تخزين متغيّرات الإحالات الناجحة ومشاهدات الإعلان على مواقع إلكترونية متعددة لإجراء تحليل مجمّع لمسار الإحالات الناجحة |
| تحسين العلامة التجارية والإحالات الناجحة | Shared Storage API وPrivacy Aggregation API (Chrome) | إعداد تقارير عن المجموعات التجريبية/المجموعات الأساسية ومعلومات الاستطلاعات لقياس تأثير العلامة التجارية والزيادة |
| تصحيح أخطاء المزاد | Protected Audience API وPrivacy 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 المقدَّمة على توفير جميع مكوّنات خدمة السحابة الإلكترونية اللازمة وضبطها.
خدمة الواجهة الأمامية
خدمة السحابة الإلكترونية المُدارة: وظيفة السحابة الإلكترونية (Google Cloud) / بوابة واجهة برمجة التطبيقات (Amazon Web Services)
Frontend Service هي بوابة بدون خادم تُستخدَم كنقطة دخول لطلبات البيانات من واجهة برمجة التطبيقات Aggregation API لإنشاء المهام واسترداد حالتها. وهي مسؤولة عن تلقّي الطلبات من مستخدمي "خدمة التجميع" والتحقّق من مَعلمات الإدخال وبدء عملية جدولة مهام التجميع.
تتوفّر واجهتَا برمجة تطبيقات في خدمة الواجهة الأمامية:
| نقطة نهاية | الوصف |
|---|---|
createJob |
تؤدي واجهة برمجة التطبيقات هذه إلى تشغيل مهمة خدمة تجميع. فهو يتطلب معلومات لتشغيل مهمة، مثل معرّف الوظيفة وتفاصيل مساحة تخزين الإدخال وتفاصيل مساحة تخزين النتائج وأصل إعداد التقارير وغير ذلك. |
getJob |
تعرض واجهة برمجة التطبيقات هذه حالة الوظيفة لمعرّف وظيفة محدّد. يوفّر معلومات عن حالة المهمة، مثل "تم استلامها" أو "قيد التقدّم" أو "انتهت". بالإضافة إلى ذلك، إذا تم انتهاء المهمة، يتم عرض نتيجة المهمة، بما في ذلك أي رسائل خطأ واجهتها أثناء تنفيذ المهمة. |
يمكنك الاطّلاع على وثائق واجهة برمجة التطبيقات Aggregation Service API.
قائمة انتظار المهام
خدمة السحابة الإلكترونية المُدارة: 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. يمكن العثور على مزيد من المعلومات حول تغيير الحجم التلقائي في النصوص البرمجية الشكلية التالية. [Amazon Web Services / Google Cloud]
يُطلِق Aggregation Worker طلبًا إلى خدمة "محاسبة التقارير القابلة للتجميع" من أجل محاسبة التقارير القابلة للتجميع. تضمن خدمة محاسبة التقارير القابلة للتجميع عدم تنفيذ المهام إلا ما دامت لم تتجاوز حدّ ميزانية الخصوصية. (راجِع قاعدة "عدم السماح بالنُسخ المكرّرة"). إذا كانت الميزانية متاحة، يتم إنشاء تقرير تلخيصي باستخدام القيم المجمّعة التي تتضمّن بيانات غير مرغوب فيها. اقرأ تفاصيل إضافية بشأن محاسبة التقارير القابلة للتجميع.
يعدّل "عامل التجميع" البيانات الوصفية للمهمة في قاعدة بيانات البيانات الوصفية للوظائف، بما في ذلك رموز إرجاع الوظائف المناسبة وعدّادات الأخطاء في حال حدوث أخطاء جزئية في التقارير. يمكن للمستخدمين استرجاع الحالة باستخدام واجهة برمجة التطبيقات لاسترداد حالة المهمة (getJob).
للحصول على وصف أكثر تفصيلاً عن "خدمة تجميع البيانات"، يُرجى الاطّلاع على هذا التفسير.
الخطوات التالية
بعد الاطّلاع على أهم تفاصيل "خدمة التجميع"، حان وقت نشر نسختك الخاصة من "خدمة التجميع" من خلال Google Cloud أو Amazon Web Services. يمكنك الاطّلاع على قسم "البدء" أو إذا كنت بحاجة إلى مزيد من المعلومات حول كيفية تشغيل "خدمة التجميع" المنشورة، يمكنك اتّباع هذا الرابط للاطّلاع على مزيد من المعلومات حول تشغيل "خدمة التجميع".
تحديد المشاكل وحلّها
يُرجى الرجوع إلى مستند رموز الأخطاء الشائعة والتخفيف منها للحصول على أوصاف أكثر تفصيلاً لرسائل الخطأ، والسبب المحتمَل للخطأ الذي تواجهه، والخطوات التالية للتخفيف من تأثيره.
الحصول على الدعم وتقديم الملاحظات
- إذا كانت لديك مشاكل فنية أو أسئلة حول المنتجات أو ملاحظات أو طلبات ميزات، يمكنك إنشاء مشكلة في مستودع GitHub.
- إذا كانت لديك أسئلة يجب فيها تقديم معلومات حسّاسة أو خاصة لتحديد المشاكل وحلّها، يُرجى التواصل معنا على العنوان aggregation-service-support@google.com.
- يُرجى الانتقال إلى لوحة البيانات العامة للحالة للاطّلاع على المشاكل المعروفة.