خدمة التجميع

تُنشئ خدمة التجميع تقارير موجزة عن بيانات الإحالات الناجحة التفصيلية وقياسات مدى الوصول من التقارير الأولية القابلة للتجميع. بصفتك جهة تقنية عرض إعلانات، يمكنك استخدام Attribution Reporting API وPrivate Aggregation API، وهما نقطتا الدخول الرئيسيتان للجمع على جانب العميل، لتوجيه التقارير إلى خدمة التجميع وتلقّي تقرير تلخيصي في الردّ.

تفترض هذه الصفحة أنّك خبير في مجال تكنولوجيا الإعلان، وهي تتناول ما يلي:

حالة التنفيذ

مدى التوفّر

الاقتراح الحالة
خدمة "ميزانية الخصوصية" على مستوى خدمات السحابة الإلكترونية
شرح
متاح
إتاحة "خدمة تجميع البيانات" لخدمة Amazon Web Services (AWS) في كلّ من Attribution Reporting API وPrivate Aggregation API
شرح
متاح
إتاحة خدمة التجميع في Google Cloud على مستوى Attribution Reporting API وPrivate Aggregation API
شرح
متاح
تسجيل المواقع الإلكترونية في "خدمة تجميع البيانات" وتجميع البيانات من مصادر متعدّدة يتضمّن تسجيل الموقع الإلكتروني ربط الموقع الإلكتروني بحسابات السحابة الإلكترونية (AWS أو Google Cloud Platform). لتجميع مصادر متعددة، يجب أن تكون من الموقع الإلكتروني نفسه.
الأسئلة الشائعة على GitHub
مستندات Site aggregation API
متاح
سيتم الاحتفاظ بقيمة epsilon لخدمة التجميع كنطاق يصل إلى 64، لتسهيل التجربة والملاحظات حول المَعلمات المختلفة.
إرسال ملاحظات حول ARA epsilon
إرسال ملاحظات حول الإصدار التجريبي من "إعلانات المنتجات داخل التطبيق"
متوفرة. سنرسل إشعارًا مسبقًا إلى المنظومة المتكاملة قبل تعديل قيم نطاق "الخطأ المعياري".
فلترة أكثر مرونة للمساهمات في طلبات بحث "خدمة تجميع البيانات"
شرح
متاح
عملية استرداد الميزانية بعد الكوارث (الأخطاء وإعدادات الضبط الخاطئة وما إلى ذلك)
شرح
متوفّرة
آلية لمراجعة النسبة المئوية لأرقام التعريف المشترَكة التي استعادتها تقنية عرض الإعلانات باستخدام ميزة استرداد الميزانية وتعليق عمليات الاسترداد المستقبلية لعمليات الاسترداد المفرطة المخطّط لها في النصف الأول من عام 2025
شركة Accenture التي تعمل كأحد المنسقين في AWS
مدوّنة المطوّرين
متاح
جهة مستقلة تعمل كمنسق على Google Cloud
مدوّنة المطوّرين
متاح
إتاحة "خدمة تجميع البيانات" لميزة "إعداد تقارير تصحيح الأخطاء المجمّعة" في Attribution Reporting API
شرح
متاح

المصطلحات والمفاهيم الرئيسية

إذا كنت تفكر في استخدام "خدمة التجميع" في سير عملك، قد تقدّم لك المصطلحات والمفاهيم التالية إحصاءات حول ما يمكن أن تقدّمه عملية التجميع الجديدة لفريقك.

مسرد المصطلحات

التقارير القابلة للتجميع

可汇总的报告是从单个用户设备发送的经过加密的报告。这些报告包含有关跨网站用户行为和转化的数据。转化(有时称为归因触发器事件)和相关指标由广告客户或广告技术平台定义。每个报告均已加密,以防止各方访问底层数据。

详细了解可汇总的报告

إعداد تقارير الحسابات القابلة للتجميع

دفتر حسابات موزَّع، يقع في كلا المنسّقين، يتتبّع ميزانية الخصوصية المخصّصة ويفرض قاعدة "عدم السماح بنسخ البيانات". هذه هي آلية الحفاظ على الخصوصية، التي يتمّ تحديد موقعها وتشغيلها ضمن المنظّمات، والتي تضمن عدم مرور أيّ تقارير من خلال خدمة التجميع بما يتجاوز ميزانية الخصوصية المخصّصة.

اطّلِع على مزيد من المعلومات عن كيفية ارتباط استراتيجيات تجميع البيانات بالتقارير القابلة للتجميع.

ميزانية محاسبية للتقارير القابلة للتجميع

إشارات إلى الميزانية تضمن عدم معالجة التقارير الفردية أكثر من مرة

خدمة تجميع البيانات

خدمة تديرها تكنولوجيا الإعلان تعالج التقارير القابلة للتجميع لإنشاء تقرير تلخيصي.

يمكنك الاطّلاع على مزيد من المعلومات حول الخلفية المتعلّقة بخدمة التجميع في الشرح وقائمة الأحكام الكاملة.

الإقرار

آلية لمصادقة هوية البرنامج، عادةً باستخدام التجزئة cryptographic أو التوقيعات. بالنسبة إلى اقتراح خدمة التجميع، تتطابق شهادة الاعتماد مع الرمز المبرمَج الذي يتم تنفيذه في خدمة التجميع التي تديرها تكنولوجيا الإعلان مع الرمز البرمجي المفتوح المصدر.

مزيد من المعلومات حول الإقرار

مساهمة الربط
منسق

الكيانات المسؤولة عن إدارة المفاتيح وإعداد التقارير القابلة للتجميع يحافظ "المنسق" على قائمة بنتائج التجزئة لإعدادات خدمة التجميع المعتمَدة، كما يضبط أذونات الوصول إلى مفاتيح فك التشفير.

الضوضاء وتغيير الحجم

التشويش الإحصائي الذي تتم إضافته إلى التقارير التلخيصية أثناء عملية التجميع للحفاظ على الخصوصية وضمان أن تقدّم التقارير النهائية معلومات قياس مخفية الهوية

اطّلِع على مزيد من المعلومات حول آلية الضوضاء الإضافية، التي يتم استخراجها من توزيع لابلاس.

مصدر الإبلاغ

接收可汇总报告的实体,也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。

رقم التعريف المشترَك

计算值,由 shared_inforeporting_origindestination_site(仅限 Attribution Reporting API)、source_registration-time(仅限 Attribution Reporting API)、scheduled_report_time 和版本组成。

如果多个报告在 shared_info 字段中具有相同的属性,则应具有相同的共享 ID。共享 ID 在可汇总报告的会计核算中发挥着重要作用。

详细了解可信服务器

تقرير موجز

نوع تقرير Attribution Reporting API وPrivate Aggregation API يتضمّن التقرير التلخيصي بيانات مستخدِمين مجمّعة، ويمكن أن يحتوي على بيانات إحالات ناجحة مفصّلة مع إزالة الضوضاء. تتكوّن التقارير الموجزة من تقارير مجمّعة. وتسمح هذه التقارير بمزيد من المرونة وتقدّم نموذج بيانات أكثر ثراءً من التقارير على مستوى الحدث، ويُرجى العلم أنّ ذلك ينطبق بشكل خاص على بعض حالات الاستخدام، مثل قيم الإحالات الناجحة.

بيئة التنفيذ الموثوقة (TEE)

إعدادات آمنة لمعدّات الكمبيوتر والبرامج تسمح للجهات الخارجية بالتحقّق من الإصدارات الدقيقة للبرامج التي تعمل على الجهاز بدون الخوف من الكشف عنها وبيئات التنفيذ الموثوقة تسمح للجهات الخارجية بالتأكّد من أنّ البرامج تفعل بالضبط ما يدّعيه المصنّع، لا أكثر ولا أقل.

لمزيد من المعلومات عن TEEs المستخدَمة في اقتراحات مبادرة حماية الخصوصية، يُرجى الاطّلاع على الشرح المفصّل لخدمات Protected Audience API والشرح المفصّل لخدمة التجميع.

حالات استخدام التجميع

راجِع تجارب المطوّرين التالية لقياس الإعلانات ومكتبات عملاء القياس المقابلة لها.

حالة الاستخدام نقطة الإدخال الوصف
تحسين عروض الأسعار 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) استخدِم التقارير المجمّعة لتسجيل توزيع قيم عروض الأسعار للمزادات.

الخطوات التي يجب اتّباعها

يوضّح الرسم البياني التالي "خدمة التجميع" أثناء العمل. سنركّز على العملية الكاملة من وقت استلام التقارير من الويب والأجهزة الجوّالة إلى وقت إنشاء التقرير الملخّص في "خدمة التجميع".

مسار خدمة تجميع البيانات بالكامل
مسار خدمة تجميع البيانات بالكامل
  1. استرجاع المفتاح العام لإنشاء تقارير مشفّرة
  2. يتم إرسال التقارير القابلة للتجميع والمشفَّرة إلى خوادم تكنولوجيا الإعلان لتجميعها وتحويلها إلى حِزم.
  3. يُجمِّع خادم تكنولوجيا الإعلان التقارير (بتنسيق avro) ويرسلها إلى "خدمة التجميع". (يجب إكمال هذا الإجراء).
  4. يسترجع Worker Aggregation التقارير المجمّعة لفك تشفيرها.
  5. يستردّ "مشغّل التجميع" مفاتيح فك التشفير من "المنسق".
  6. يفكّ رمز التقارير عامل التجميع لأغراض التجميع وإخفاء الهوية.
  7. تتحقّق خدمة محاسبة التقارير القابلة للتجميع ممّا إذا كانت هناك ميزانية خصوصية كافية لإنشاء تقرير تلخيصي للتقارير القابلة للتجميع المحدّدة.
  8. أرسِل تقريرًا نهائيًا ملخّصًا.

يعرض المخطّط البياني العلاقات العالية المستوى التي تربط "خدمة التجميع" بواجهات برمجة التطبيقات الرئيسية لقياس الأداء على مستوى العميل: 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.
  • لطلب الدعم الفني لتحديد المشاكل وحلّها في حال مواجهة خطأ أثناء نشر المهام أو صيانتها أو تشغيلها باستخدام "خدمة التجميع"، يُرجى استخدام نموذج الدعم الفني هذا.
  • يُرجى الانتقال إلى لوحة البيانات العامة للحالة للاطّلاع على المشاكل المعروفة.