قياس البيانات المجمّعة على مستوى المستخدِمين باستخدام واجهتَي برمجة التطبيقات Attribution Reporting API و Private Aggregation API
حالة التنفيذ
- المشاركة في التقارير التلخيصية لميزة "تحديد المصدر" وتجربتها
ما هو التقرير التلخيصي؟
يتم تجميع تقرير تلخيصي لمجموعة من المستخدمين بحيث لا يمكن ربطه بأي مستخدم فردي. تقدّم التقارير التلخيصية بيانات إحالات ناجحة تفصيلية مع مرونة في بيانات النقرات والمشاهدات. لا تعتمد التقارير التلخيصية على ملفّات تعريف الارتباط أو الآليات التابعة لجهات خارجية والتي يمكن استخدامها لتحديد هوية مستخدِمين فرديين على مستوى المواقع الإلكترونية.
يتم إنشاء التقارير الموجزة في سياقَين:
- قياس الإعلانات: يمكن لتكنولوجيات الإعلان إنشاء تقارير تلخيصية باستخدام تقارير تحديد المصدر لقياس الحالات التي تؤدي فيها النقرة على الإعلان أو مشاهدته إلى إحالة ناجحة على موقع المعلِن الإلكتروني، مثل عملية بيع أو اشتراك. يمكن أيضًا لتقنيات الإعلان إنشاء تقارير تلخيصية لمزادات Protected Audience API التي تستخدم ميزة "التجميع الخاص".
- إعداد التقارير العامة على مستوى المواقع الإلكترونية: يسجِّل المطوّرون البيانات على مستوى المواقع الإلكترونية في "مساحة التخزين المشتركة"، ويمكنهم إعداد تقارير عن هذه البيانات باستخدام ميزة "التجميع الخاص". وهناك العديد من الاستخدامات لهذه الميزة، مثل الحصول على إحصاءات عن الخصائص الديمغرافية للمستخدمين وتسجيل مرات الوصول الفريدة للمحتوى.
يتم طلب التقارير التلخيصية بشكلٍ مختلف لكلّ من "تقارير تحديد المصدر" و"التجميع الخاص". قبل أن تتمكّن من التعرّف على كيفية إنشاء التقارير، عليك أولاً معرفة ما هو التجميع وكيفية استخدام التقارير التلخيصية لتلبية احتياجات القياس.
المفاهيم الرئيسية
تصميم عملية جمع البيانات
من المبادئ الرئيسية للتقارير التلخيصية هي قرارات التصميم المبكّرة. يمكنك تحديد نوع البيانات التي تريد جمعها وفي أي فئات. تقدّم تقارير النتائج إحصاءات عن حملاتك أو نشاطك التجاري.
يوفّر تقرير الإخراج بيانات مفصّلة للإحالات الناجحة على جميع المواقع الإلكترونية ومرونة في دمج بيانات النقرات والمشاهدات مع بيانات الإحالات الناجحة. يمكنك أيضًا اعتبار المخرجات النهائية كمدخلات للأدوات التي تستخدمها لاتخاذ القرارات.
اسأل نفسك: ما هي المعلومات التي أريد معرفتها عن تفاعل المستخدمين مع المحتوى الخاص بي؟
الإحالات الناجحة من الإعلانات
على سبيل المثال، إذا أنشأت تقارير تلخيصية لتحديد عدد الإحالات الناجحة التي أدّت إلى قيمة إجمالي الإنفاق، قد يساعد ذلك فريقك في تحديد ما يجب أن تستهدفه حملتك الإعلانية التالية لزيادة إجمالي الإنفاق.
التفاعل على مستوى جميع المواقع الإلكترونية
على سبيل المثال، إذا كنت تنشئ تقارير تلخيصية لتحديد عدد الأشخاص الذين قرأوا المحتوى الخاص بك على موقع إلكتروني تابع لجهة خارجية، قد يساعد ذلك فريقك في تحديد كيفية التعاون مع هذه الجهة الخارجية لزيادة التفاعل وتشجيع القرّاء على زيارة موقعك الإلكتروني مباشرةً.
ما هي المعلومات التي يتم تسجيلها في المتصفّح؟
التقرير القابل للتجميع هو البيانات الأولية التي يتم تسجيلها من متصفّح المستخدِم، والتي تتضمّن مجموعة محدّدة مسبقًا من الحِزم (أو مفاتيح التجميع). تعتمد كيفية تحديد هذه المعايير على قرارات التصميم التي تتّخذها.
تقدّم التقارير التلخيصية مجموعة من البيانات المجمّعة إلى جانب بيانات تحويل مفصّلة.
الإحالات الناجحة من الإعلانات
يحدّد المعلِن أو شركة تكنولوجيا الإعلان الإحالات الناجحة، وقد تختلف حسب الحملات الإعلانية المختلفة. يمكن أن تقيس إحدى الحملات عدد النقرات على الإعلانات التي تبعها شراء أحد المستخدِمين للسلعة المُعلَن عنها. يمكن أن تقيس حملة أخرى عدد مشاهدات الإعلانات التي أدّت إلى زيارات موقع المعلِن الإلكتروني.
على سبيل المثال، يُطلق مقدّم تكنولوجيا إعلانية حملة إعلانية على news.example، حيث تمثّل الإحالة الناجحة مستخدمًا ينقر على إعلان عن أحذية ويُكمل عملية شراء أحذية على shoes.example.
تتلقّى تقنية الإعلان تقريرًا تلخيصيًا لهذه الحملة الإعلانية التي تحمل رقم التعريف 1234567، والذي يشير إلى أنّه تم تسجيل 518 إحالة ناجحة على shoes.example في 12 كانون الثاني (يناير) 2022، بإجمالي إنفاق قدره 38,174 دولار أمريكي. %60 من الإحالات الناجحة كانت من مستخدمين اشتروا أحذية رياضية زرقاء برمز التخزين التعريفي للمنتج 9872 و%40 من مستخدمين اشتروا صندلًا أصفر برمز التخزين التعريفي للمنتج 2643. رقم تعريف الحملة هو بيانات تفصيلية على جانب الإعلان، في حين أنّ رموز التخزين التعريفية للمنتجات هي بيانات تفصيلية للإحالات الناجحة. إنّ عدد الإحالات الناجحة وإجمالي الإنفاق هما بيانات مجمّعة.
التفاعل على مستوى جميع المواقع الإلكترونية
قبل أن تتمكّن من تسجيل البيانات، عليك تحديد المعلومات التي تريد جمعها، وتحديد الإحالات الناجحة التي تتوقّعها من أي عملية دمج معيّنة على مستوى المواقع الإلكترونية، وتحديد نوع التقرير الذي تريد جمعه.
هناك عدد من حالات الاستخدام المحتمَلة، موضّحة بالتفصيل في مستندات "التجميع الخاص". لنطّلِع على مثال واحد:
قد تحتاج إلى قياس الخصائص الديمغرافية للمستخدمين الذين شاهدوا المحتوى الخاص بك على مواقع إلكترونية مختلفة. يمكن أن تقدّم ميزة "التجميع الخاص" إجابة، مثل "يتراوح عمر 317 مستخدمًا فريدًا تقريبًا بين 18 و45 عامًا، وهم من ألمانيا". أولاً، حدِّد المعلومات التي تريد جمعها على وجه التحديد (مثل العمر والموقع الجغرافي). بعد ذلك، استخدِم مساحة التخزين المشتركة لجمع بيانات الخصائص الديمغرافية المحدّدة هذه من موقع إلكتروني تابع لجهة خارجية. في وقت لاحق، يمكنك إرسال تقرير من خلال "التجميع الخاص" يتضمّن سمتَي الفئة العمرية والبلد المشفَّرة في مفتاح التجميع.
كيف يتم تسجيل البيانات قبل تجميعها؟
تتألف التقارير التلخيصية من بيانات مجمّعة من مجموعة من الأجهزة الفردية. على الرغم من أنّه لا يمكن مراقبة إجراءات مستخدم فردي ومراجعتها، تتم عملية الجمع نفسها لكل شخص.
يتم تشفير إجراءات المستخدِم الفردي وجمعها في ملف ناتج يمكن تجميعه. تتضمّن هذه التقارير أيضًا قدرًا صغيرًا من البيانات الوصفية غير المشفّرة ذات الصلة بالمعالجة المجمّعة.
بالنسبة إلى بيانات تقارير تحديد المصدر، يتم تسجيل التقارير القابلة للتجميع على النحو التالي:
- يزور أحد المستخدِمين موقعًا إلكترونيًا لناشر ويشاهد إعلانًا أو ينقر عليه، ما يُعرف باسم حدث مصدر الإحالة الناجحة.
- وبعد بضع دقائق أو أيام، يُجري المستخدِم إحالة ناجحة، ويُعرف ذلك باسم حدث بدء تحديد المصدر. على سبيل المثال، يمكن تعريف الإحالة الناجحة على أنّها عملية شراء منتج.
- يطابق برنامج المتصفّح النقرة على الإعلان أو مشاهدته بحدث الإحالة الناجحة. استنادًا إلى هذه المطابقة، ينشئ المتصفّح تقريرًا قابلاً للتجميع باستخدام منطق محدّد أنشأه مقدّم تقنية إعلانية.
- ويشفِّر المتصفّح هذه البيانات، وبعد تأخير قصير، يرسلها إلى خادم تكنولوجيا الإعلانات لجمعها. يجب أن يعتمد خادم تكنولوجيا الإعلان على خدمة تجميع للوصول إلى الإحصاءات التي تمّت إزالة الضوضاء منها.
بالنسبة إلى "التجميع الخاص"، يظهر على النحو التالي:
- تحدّد الجهة الخارجية ما تريد قياسه وتكتب البيانات في "مساحة التخزين المشتركة" لتتم قراءتها في وقت لاحق.
- يُشغِّل المستخدِم حدثًا يتطابق مع ما تريد الجهة الخارجية قياسه. على سبيل المثال، عندما يزور المستخدِم موقعًا إلكترونيًا يتضمّن محتوى مضمّنًا، يمكن للجهة الخارجية قراءة البيانات في "مساحة التخزين المشتركة" واستخدام ميزة "التجميع الخاص" لإرسال تقارير قابلة للتجميع ومشفّرة إلى خادمك لجمعها.
التقارير القابلة للتجميع في حِزم
قبل معالجة التقارير المجمّعة التي تم جمعها وتجميعها في تقرير تلخيصي، يجب تجميعها. الحزمة هي مجموعة استراتيجية من التقارير القابلة للتجميع.
تحتوي التقارير القابلة للتجميع على قدر صغير من البيانات غير المشفّرة، ويتم تضمينها على أنّها shared_info، ويمكن استخدامها لإنشاء دفعات. ويشمل ذلك الطابع الزمني ومصدر الإبلاغ. لا يمكنك تجميع التقارير استنادًا إلى المعلومات المشفّرة ضمن التقرير.
من الأفضل أن تحتوي الحِزم على العديد من التقارير. يمكنك اختيار إجراء عمليات الأركان الأساسية كل ساعة أو يوم أو أسبوع أو أي وتيرة أخرى من اختيارك. يمكن أن تتغيّر هذه الاستراتيجية لأحداث معيّنة حيث يُتوقّع حدوث عدد أكبر من الزيارات.
على سبيل المثال، عند تجميع التقارير القابلة للتجميع لواجهة برمجة التطبيقات "Attribution Reporting API"، يمكنك تعديل استراتيجية التجميع لتصبح كل ساعة في يوم التخفيضات الكبيرة، حيث تتوقّع زيادةً في عدد الإحالات الناجحة الناتجة عن الإعلانات.
باستخدام Private Aggregation API، قد تحتاج إلى تغيير استراتيجيتك في يوم نشر بيان صحفي كبير عن محتوى معيّن مضمّن في مواقع إلكترونية تابعة لجهات خارجية.
معالجة البيانات باستخدام خدمة التجميع
تعمل خدمة التجميع على فك تشفير البيانات المجمّعة من التقارير القابلة للتجميع ودمجها، وإضافة تشويش، وعرض التقرير النهائي الملخّص. تعمل هذه الخدمة في بيئة تنفيذ موثوقة (TEE) يتم نشرها على خدمة سحابة إلكترونية تتيح التدابير الأمنية اللازمة لحماية هذه البيانات.
التقارير الموجزة التي تتضمّن تقارير تحديد المصدر
لكي يتمكّن مقدّمو تكنولوجيا الإعلان من استرداد تقرير تلخيصي، يجب اتّخاذ الخطوات التالية:
- يجمع مزوّد تقنية الإعلان تقارير قابلة للتجميع من متصفحات المستخدِمين الفرديين.
- يُجمِّع مزوّد تقنية الإعلان التقارير القابلة للتجميع ويرسل الحِزم إلى خدمة التجميع.
- تُحدِّد خدمة التجميع جدولاً زمنيًا لشدَّد عامل لجمع البيانات.
- يعمل عامل التجميع على فك تشفير البيانات من التقارير التي يمكن تجميعها وتجميعها، بالإضافة إلى البيانات التي تم تشويشها.
- تُعيد خدمة التجميع التقرير الملخّص إلى مزوّد تقنية الإعلان.
يمكن أن تستخدم تكنولوجيا الإعلان التقرير التلخيصي لتحديد عروض الأسعار وتقديم التقارير إلى عملائها. المخطّط بترميز JSON هو التنسيق المقترَح للتقارير التلخيصية.
التقارير الموجزة التي تتضمّن التجميع الخاص
- قراءة البيانات على جميع المواقع الإلكترونية التي جمعتها ميزة "مساحة التخزين المشتركة" وإنشاء مفتاح تجميع لتجميع البيانات
- استخدِم واجهة برمجة التطبيقات Private Aggregation API من إحدى وحدات عمل "مساحة التخزين المشتركة" باستخدام مفتاح التجميع والقيمة التي تريد تجميعها. ينشئ المتصفّح تقريرًا مشفّرًا قابلاً للتجميع من الإدخال الذي تقدّمه ويرسله إلى الخادم لجمعه.
- تجميع التقارير القابلة للتجميع وإرسالها إلى خدمة التجميع لمعالجتها
- تعالج خدمة التجميع التقارير المجمّعة، ثم تضيف ضوضاء.
- تُعيد خدمة التجميع التقرير الملخّص إلى مقدّم الطلب.
التفاعل مع الملاحظات ومشاركتها
تشكّل التقارير التلخيصية جزءًا أساسيًا من اقتراحات القياس في "مبادرة حماية الخصوصية". وكما هو الحال مع اقتراحات "مبادرة حماية الخصوصية" الأخرى، يتم توثيق هذا الاقتراح ومناقشته بشكل علني على GitHub.
- مناقشة Attribution Reporting API
- مناقشة Private Aggregation API
- دعم المطوّرين: يمكنك طرح الأسئلة والانضمام إلى المناقشات في مستودع دعم المطوّرين في "مبادرة حماية الخصوصية".