يمكنك قياس الحالات التي تؤدّي فيها نقرة على إعلان أو مشاهدة إلى إحالة ناجحة، مثل عملية شراء على الموقع الإلكتروني الخاص بالمعلن.
لمن هذا؟
ستجد هنا أساسيات إعداد تقارير تحديد المصدر وبعض التقارير الأساسية ولكن ليس الكثير من التفاصيل الفنية.
- إذا كنت تعمل في مجال الإعلان أو تكنولوجيا الإعلان، ستتمكّن من التعرّف على كيفية استخدام واجهة برمجة التطبيقات هذه. توفِّر إمكانيات تم تفعيلها من خلال ملفات تعريف الارتباط التابعة لجهات خارجية. التحقُّق من الإجابة حالات استخدام واجهة برمجة التطبيقات، والتي تعرض مزيدًا من التفاصيل حول كيفية يتم إنشاء التقارير.
- إذا كنت مطوّرًا أو مهندس برامج، يُرجى الانتقال إلى نظرة عامة كاملة على النظام أو التجربة والمشاركة مع واجهة برمجة التطبيقات.
المعلنون والناشرين الذين يعتمدون على منصّات تكنولوجيا الإعلان لإجراء الإحالات الناجحة. لا تحتاج عمليات القياس إلى استخدام واجهة برمجة التطبيقات مباشرةً. مواضيع قد تهمّك التعرّف على آلية عمل "تقارير تحديد المصدر" إذا كانت تكنولوجيا الإعلانات تريد دمج باستخدام واجهة برمجة التطبيقات هذه.
ما هي Attribution Reporting API؟
غالبًا ما يعتمد قياس الإحالات الناجحة للإعلانات على جهات خارجية ملفات تعريف الارتباط. تقيد المتصفحات الوصول إلى ملفات تعريف الارتباط التابعة لجهات خارجية وذلك بسبب تُستخدم لتتبُّع المستخدمين في المواقع الإلكترونية وإعاقة خصوصية المستخدم.
تتيح Attribution Reporting API هذه القياسات للحفاظ على الخصوصية، وذلك بدون استخدام ملفات تعريف الارتباط الخاصة بجهات خارجية.
تتيح واجهة برمجة التطبيقات هذه للمعلنين ومزوّدي تقنية الإعلان قياس الإحالات الناجحة في في الحالات التالية:
- النقرات ومشاهدات الإعلان.
- الإعلانات في إطار iframe تابع لجهة خارجية، مثل الإعلانات على موقع ناشر يستخدم علامة مزود تقنية إعلان تابع لجهة خارجية
- الإعلانات في سياق الطرف الأول، مثل الإعلانات على إحدى شبكات التواصل الاجتماعي أو على شبكة بحث أو الصفحة نتائج محرك بحث Google أو الناشرين الذين يعرضون إعلاناتهم الخاصة.
إذا لم تكن معتادًا على بعض هذه المصطلحات أو المفاهيم، فراجع مسرد مصطلحات "مبادرة حماية الخصوصية"
تجربة واجهة برمجة التطبيقات
- اختبِر محليًا في متصفحك. ضَع علمًا. التي تطلب من متصفّح Chrome تفعيل ميزات تجريبية محدّدة الجديدة.
إذا كنت مهتمًا بتجربة واجهة برمجة التطبيقات، يُرجى الانتقال إلى تقارير تحديد المصدر: إجراء التجارب والمشاركة.
التغييرات في واجهة برمجة التطبيقات
- تتبُّع تغييرات واجهة برمجة التطبيقات
- يمكنك الاطّلاع على سبب شحن Attribution Reporting API في النصف الأول من عام 2023.
مدى التوفّر
الاقتراح | الحالة |
---|---|
رحلة الإحالة الناجحة: تحويل التطبيقات إلى الويب شرح على الويب وشرح Android إعلان القائمة البريدية |
متوفّرة في Chrome وAndroid لمرحلة التجربة والتقييم |
رحلة الإحالة الناجحة: جميع الأجهزة شرح |
تمت أرشفة هذا الاقتراح. لا توجد خطط حالية للتنفيذ. |
منع تقارير التجميع غير الصالحة باستخدام ميزة "التحقّق من التقارير" شرح |
من المتوقّع حدوثها في Chrome في النصف الأول من عام 2024 |
ستظل القائمة المسموح بها التلقائية لسياسة الأذونات Attribution Reporting API قائمة * إشعار القائمة البريدية. |
متوفّرة في Chrome في الربع الأول من عام 2023 |
ملف epsilon قابل للضبط على مستوى الحدث لإعداد التقارير مشكلة في GitHub |
متوفّرة في Chrome في الربع الرابع من عام 2023 |
المساحة المتروكة لحمولة التقارير القابلة للتجميع شرح محدّث |
متوفّرة في Chrome في الربع الرابع من عام 2023 |
المرحلة 1 Lite المرنة على مستوى الحدث شرح الإعدادات المرنة على مستوى الحدث |
ستتوفّر هذه الميزة في Chrome في الربع الرابع من عام 2023.
إمكانية تخصيص عدد تقارير الإحالة وعدد/طول فترات إعداد التقارير. ستتوفّر هذه الميزة في Chrome خلال الربع الأول من عام 2024 إمكانية تخصيص عدد وحدات بت من بيانات عامل التشغيل |
دعم تصحيح الأخطاء في إعداد تقارير الإحالة بعد إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية طلب الملاحظات على GitHub |
من المتوقّع حدوثها في Chrome في النصف الأول من عام 2024 |
دعم Attribution Reporting API وخدمة التجميع في Google Cloud Attribution Reporting API Explainer شرح خدمة التجميع |
متوفّرة في Chrome في النصف الثاني من عام 2023 |
حالات الاستخدام والميزات
تتيح Attribution Reporting API الوصول إلى أنواع مختلفة من الإحصاءات نوعان من التقارير التي يمكن إرسالها إلى أحد المعلنين أو تقنية إعلان تابعة لجهة خارجية المستخدم. يمكن استخدام هذين النوعين من التقارير في وقت واحد وتُعدّ مكمّلة
- تربط التقارير على مستوى الحدث إعلانًا معيّنًا. النقر أو العرض (على جانب الإعلان) مع البيانات على جانب الإحالة الناجحة. البيانات جانب التحويل محدودة للغاية، والبيانات غير واضحة (مما يعني أن في نسبة صغيرة من الحالات، يتم إرسال بيانات عشوائية بدلاً من التقارير الحقيقية). يحافظ ذلك على خصوصية المستخدم عن طريق منع ضم هوية المستخدم عبر المواقع. لتوفير حماية إضافية للخصوصية، يتم إرسال التقارير بشكل متأخر.
- ولا يتم ربط التقارير الموجزة بحدث محدّد في جانب الإعلان توفّر هذه التقارير بيانات تحويل أكثر ثراءً ودقة مقارنةً بالتقارير على مستوى الحدث تساعد مزيجًا من أساليب الخصوصية في تقليل وخطر دمج الهوية عبر المواقع.
التقارير على مستوى الحدث
تربط التقارير على مستوى الحدث بين النقرة على الإعلان أو المشاهدة وبيانات الإحالات الناجحة التقريبية.
![تقرير على مستوى الحدث](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=0000&hl=ar)
news.example
(المرفق برقم تعريف المستخدم Bo_Doe في news.example
) أدّى إلى إجراء عملية شراء في shop.example
.تكون التقارير على مستوى الحدث مناسبة لما يلي:
- التحسين: الإجابة عن أسئلة مثل "كيف يمكنني تحسين عائد الاستثمار؟". وعلى وجه الخصوص، يمكن استخدام هذه التقارير لتحسين أداء الإعلانات موضع الإعلان، كمعرّفات فريدة مرتبطة بالإعلان في التقارير. يمكن أن توفّر التقارير على مستوى الحدث بيانات تدريب لنماذج تعلُّم الآلة.
- التقارير التقريبية، التي تحتاج فيها إلى القليل جدًا من المعلومات حول تحويل. الحد الحالي هو 3 وحدات بت من بيانات الإحالات الناجحة للنقرات⏤هذا يعني أنّه يمكن تعيين إحالة ناجحة واحدة من ثماني فئات⏤ وبت 1 طرق العرض. ترميز بيانات جانب الإحالة الناجحة الدقيقة، مثل لا تتوفّر إمكانية تحديد سعر معيّن أو وقت إحالة ناجحة في التقارير على مستوى الحدث.
- رصد الاحتيال: يمكن أن تكون البيانات الواردة في بعض التقارير مفيدة في حالات الاحتيال الإعلاني. التحليل والتحليل، من خلال السماح لك بفهم الأنماط التي يمكن يُستخدم لتحديد نشاط غير مرغوب فيه أو غير صالح.
التقارير الموجزة
تقدم التقارير الموجزة (المعروفة سابقًا باسم التقارير المجمَّعة) مزيدًا من التفاصيل بيانات الإحالات الناجحة والمزيد من المرونة لدمج بيانات النقرات أو الإحالات الناجحة البيانات.
مزيد من المعلومات عن التقارير الموجزة
![مثال على الإحصاءات من تقارير الملخّص](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=0000&hl=ar)
news.example
إلى تسجيل 518 إحالة ناجحة في shoes.example
، وإجمالي إنفاق 38174 دولار أمريكي. نصف الإحالات الناجحة كانت من مستخدمين في مدينة نيويورك بالولايات المتحدة الأمريكية.تكون التقارير الموجزة هي الأنسب للإبلاغ عن حالات الاستخدام. وتساعد هذه التقارير الإجابة عن أسئلة مثل: "ما عائد الاستثمار؟"
استخدام التقارير الموجزة للتحسين، على سبيل المثال، لتحسين "قيمة الشراء"، وهي غير متوافقة مع التقارير على مستوى الحدث (لأنّ بيانات التحويل تقريبية جدًا)—هو مجال من مجالات البحث النشط.
ميزات أخرى
تشمل الميزات الأخرى لواجهة برمجة التطبيقات هذه ما يلي:
- تحديد المصدر من تطبيقات إلى مواقع إلكترونية: مشاهدة إعلان في أحد التطبيقات أو النقر عليه وإجراء إحالة ناجحة على الويب.
دعم المتصفح
- لم يشارك كل من Firefox وEdge الإشارات.
- Safari وWebkit سلبية واقترحنا واجهة برمجة تطبيقات مختلفة لقياس الإحالات الناجحة للإعلانات، باسم النقرة الخاصة. القياس:
وبالرغم من اختلاف واجهتي برمجة التطبيقات، إلا أن Chrome وWebKit يعملان معًا في لتبسيط تجربة المطوّر، على سبيل المثال من خلال التوافق مع بأسماء السمات وفي علامة بنية JSON للتقارير
تختلف مجموعة ميزات Attribution Reporting API عن مجموعة ميزات Private Click Measurement API مُقترَحة من Safari وWebKit. ومن أبرزها استخدام Attribution Reporting API:
- يُتاح قياس بعد رؤية الإعلان فقط.
- ويمكن تقديم التقارير على مستوى الحدث.
- تحتوي التقارير الموجزة على معلومات غنية عن كلّ من جانب النقر/العرض والإحالة الناجحة.
- يمكن للجهات الخارجية، مثل منصات تكنولوجيا الإعلان، تلقّي التقارير نيابةً عن الناشرين والمعلنين
إعدادات المتصفِّح
- يمكن للمستخدمين إيقاف واجهة برمجة التطبيقات من خلال إعدادات المستخدم على
chrome://settings/adPrivacy
- واجهة برمجة التطبيقات غير نشطة في وضع التصفّح المتخفّي.
- لا تكون واجهة برمجة التطبيقات نشطة في حال إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية.
كيف يمكن للمواقع الإلكترونية التحكّم في إمكانية الوصول إليها؟
إذا كانت واجهة برمجة التطبيقات متوفرة في متصفح معيّن، فستتوفّر بشكل تلقائي في أي موقع إلكتروني معيّن، سواء في المستندات ذات المستوى الأعلى أو النصوص البرمجية، وفي إطارات iframe نفسها من المصدر.
الجهات الخارجية العشوائية، مثل إطارات iframe للإعلانات المتعددة المصادر التي لم يتم تمت إضافتها إلى الصفحة باستخدام نص برمجي لديه إمكانية الوصول من المستوى الأعلى — لا يمكن استخدام واجهة برمجة التطبيقات بدون علم الناشر أو المعلن: في إطارات iframe هذه، يجب تفعيل Attribution Reporting API صراحةً مع الأذونات .
<iframe src="..." allow="attribution-reporting"></iframe>
يمكن للجهات الخارجية التي تملك إذن الوصول من المستوى الأعلى والتي تضيف إطارات iframe من مصادر متعددة إلى إحدى الصفحات تنفيذ ذلك. أيضًا تفعيل Attribution Reporting API سياسة الأذونات
يمكن لأي موقع إيقاف Attribution Reporting API لجميع الأطراف، بما في ذلك: نصوص برمجية ذات وصول من المستوى الأعلى، عن طريق إرسال عنوان استجابة HTTP:
Permissions-Policy: attribution-reporting=()
كيف تعمل Attribution Reporting API؟
تتيح Attribution Reporting API قياس حدثَين مرتبطَين. معًا: حدث على الموقع الإلكتروني للناشر، مثل عرض مستخدم أو النقر عليه مع إعلان، مع تحويل لاحق على موقع أحد المعلنين.
التقارير على مستوى الحدث
![تقرير على مستوى الحدث](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=0000&hl=ar)
يطابق المتصفّح النقرات أو المشاهدات مع بيانات الإحالات الناجحة التي تحدّدها إحدى تقنيات الإعلانات.
وفي وقت لاحق، يرسل المتصفّح التقارير الناتجة إلى نقطة نهاية محدّدة مسبقًا، مع بعض التأخير والتشويش.
التقارير الموجزة
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=0000&hl=ar)
يتم إنشاء التقارير التلخيصية على النحو التالي:
- ينقر المستخدم على إعلان تم إعداده بشكل خاص أو يعرضه. ويسجِّل المتصفّح، على جهاز المستخدم المحلي، هذا الحدث، إلى جانب بيانات إعداد تحديد المصدر المحدَّدة مسبقًا.
- وفي وقت لاحق، عندما يُجري المستخدم إحالة ناجحة، يطابق المتصفّح حدث النقر أو المشاهدة التفصيلية هذا (المعروف باسم حدث مصدر تحديد المصدر) مع بيانات الإحالات الناجحة التفصيلية (المعروفة باسم بيانات مشغّل تحديد المصدر). تحدِّد شركة تكنولوجيا الإعلان أبعاد التفاصيل التي تم تسجيلها مسبقًا، ويتّبِع المتصفّح منطقًا معيّنًا يتم تحديده من خلال تقنية الإعلان. ويعمل المتصفّح على إخراج هذه البيانات في تقرير قابل للتجميع.
- يتم تشفير التقارير القابلة للتجميع بواسطة المتصفح وإرسالها إلى أحد خوادم تقنية الإعلان. من خادم تكنولوجيا الإعلان، يتم إرسال التقارير القابلة للتجميع إلى خدمة التجميع لإنشاء تقرير ملخّص.
- بعد ذلك، يتم توفير التقارير الموجزة لتقنية الإعلان. تجدر الإشارة إلى أنّ التقارير الموجزة لا تتأخر إلى درجة أنّ التقارير على مستوى الحدث نفسها.
يمكنك قراءة المزيد من المعلومات عن التقارير الموجزة.
الخصوصية
على عكس ملفات تعريف الارتباط التابعة لجهات خارجية، لا تعمل Attribution Reporting API تسمح لشركات الإعلان بالحصول على رؤى حول الإحالات الناجحة بدون تتبُّع نشاط الفرد في جميع المواقع الإلكترونية
لنأخذ شخصًا يدعى يوسف. يرى أمجد إعلانًا أثناء القراءة
الأخبار على news.example
. بعد أسبوع، يشتري بوب حذاءً على
shoes.example
في الوقت الحالي، سيتم تتبُّع هذه الإحالة الناجحة من خلال جهة خارجية.
ملف تعريف ارتباط مُستخدَم باعتباره معرّفًا لعدة مواقع إلكترونية.
باستخدام ملفات تعريف الارتباط التابعة لجهات خارجية، يمكن لشركة تكنولوجيا الإعلان الوصول إلى العديد من
تفاصيل حول نشاط يوسف على news.example
وفي
shoes.example
يمكن لتقنية الإعلان دمج هذه الأجزاء من
المعلومات معًا لإنشاء ملف تعريف مفصل لبوب،
بما في ذلك موقع يوسف وعادات التصفح
القراءات المفضلة في news.example
. يمكن لهذا الملف الشخصي أيضًا
تتضمن عمليات الشراء والنشاط وبيانات بطاقة الائتمان على
shoes.example
يُعدّ هذا العنصر المشترك بين مواقع إلكترونية مفيدًا لقياس
الإحالات الناجحة للإعلانات. لكنه يعيق خصوصية المستخدم:
يتم تتبع نشاط يوسف على المواقع الإلكترونية بمستوى عالٍ من التفاصيل.
![عرض جنبًا إلى جنب للويب اليوم (الهوية المشتركة) وشبكة الويب المستقبلية (هوية مقسَّمة)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=0000&hl=ar)
يتم دمج كمية صغيرة من المعلومات
على المواقع الإلكترونية، بما يكفي لقياس الإحالات الناجحة، وليس
لتتبع نشاط يوسف عبر المواقع بالتفصيل. يوسف
سيبقى النشاط على news.example
وshoes.example
منفصلة.
إجراءات الحماية في كل نوع تقرير
تربط التقارير على مستوى الحدث معرّفًا على مستوى الإعلان بكمية صغيرة من بيانات جانب الإحالة الناجحة. وفي حين أنها توفر معلومات عبر الموقع حول إحالة ناجحة، تكون معلومات جانب الإحالة الناجحة عامة جدًّا لدرجة أنّه لا يمكن ضم المستخدم هويتك عبر المواقع.
توفّر التقارير الموجزة إحصاءات تفصيلية، ولكن على مستوى مجمّع فقط. لأن محتويات يتم تشفير هذه التقارير القابلة للتجميع عند إرسالها إلى تقنية الإعلان، أي معلومات من التقارير بدون استخدام خدمة التجميع. خدمة التجميع فقط يوفر الوصول إلى التجميعات الصاخبة.
يتم فرض إجراءات حماية إضافية للخصوصية، مثل قيود المعدل، على كليهما على مستوى الحدث وتقارير إجمالية
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=0000&hl=ar)
بالتفصيل: التقارير على مستوى الحدث والخصوصية
تقدِّم التقارير على مستوى الحدث إحصاءات عن الإحالات الناجحة بدون تتبُّع المستخدِمين على مستوى المواقع، وذلك من خلال اتباع آليات الخصوصية التالية:
- لا يتم استخدام معرّف المواقع الإلكترونية المتعددة ولا يوجد نشاط تصفُّح مفصل على مواقع إلكترونية متعددة الجهاز.
- تربط التقارير على مستوى الحدث 64 وحدة بت من المعلومات على جانب الإعلان.
(
news.example
) مع وحدة بت واحدة أو 3 بت فقط على جانب الإحالة الناجحة (shop.example
). 64 بت هي معلومات كافية ليتم تعيينها إلى معرف مستخدم فردي، ولكن لا يمكن ربط هذه الـ 64 بت إلا القليل من المعلومات على مواقع إلكترونية متعددة: وحدة بت واحدة أو 3 بت، وهي ليست كافية للاحتفاظ بها المعرف.- ولا تعتبر وحدات 64 بت في جانب الإعلان معلومات جديدة. يمكن أن يكون رقم تعريف المستخدم
المتاحة على جانب الإعلان اليوم.
news.example
أوadtech.example
على علم بنشاط مستخدم معيّن علىnews.example
.
- ولا تعتبر وحدات 64 بت في جانب الإعلان معلومات جديدة. يمكن أن يكون رقم تعريف المستخدم
المتاحة على جانب الإعلان اليوم.
- يتم تطبيق إجراءات حماية إضافية لمنع إساءة الاستخدام والتتبُّع على مواقع إلكترونية متعددة:
- يتم إرسال التقارير مع مهلة.
- تكون بيانات الإحالات الناجحة مزعجة: في نسبة معيّنة من الوقت، يتم إنشاء تقارير مزيّفة.
- يكون عدد تقارير الإحالات الناجحة المحدّدة المصدر محدودًا لكل نقرة أو مشاهدة.
بالتفصيل: ملخص التقارير والخصوصية
تربط التقارير التلخيصية حدث نقرة أو مشاهدة ببيانات الإحالات الناجحة التفصيلية. توفِّر هذه الحملات إحصاءات عن الإحالات الناجحة بدون تتبُّع المستخدِمين على المواقع الإلكترونية، وذلك باستخدام آليات الخصوصية التالية:
- لا يتم استخدام معرّف مواقع إلكترونية متعددة.
- يمكن أن تقدم كل عملية إحالة مساهمات متعددة في الملخص الناتج إبلاغ. يمكن لأي مستخدم تشغيل عمليات إحالة متعددة لفرد معين النقرة (أو المشاهدة) والإحالة الناجحة.
- يتم تجميع البيانات حتى مستوى العديد من الأحداث (العديد من المستخدمين) يمكن مراقبة الأحداث الفردية بدقة. عند النظر إلى البيانات المجمعة، كلما زاد مستوى التفاصيل، يزداد التشويش النسبي على هذه البيانات أيضًا. شرائح من البيانات التي تجمع عددًا كبيرًا من الأحداث والمستخدمين أكثر دقة للحفاظ على فائدتها.
- التقارير الأولية التي تربط بين حدث نقرة أو عرض تفصيلي تكون بيانات الإحالات الناجحة مشفّرة ولا يمكن لشركة تكنولوجيا الإعلان قراءتها. يمكن فقط لخدمة التجميع قراءة هذه البيانات.
- يتم تطبيق إجراءات حماية إضافية لمنع إساءة الاستخدام والتتبُّع على مواقع إلكترونية متعددة:
- يتم إرسال التقارير مع تأخيرات عشوائية.
- تكون الاستعلامات المتعلقة بشرائح مختلفة من البيانات محدودة بمعدل.
التفاعل مع الملاحظات ومشاركتها
- للأسئلة حول واجهة برمجة التطبيقات: إنشاء مشكلة على مستودع واجهة برمجة التطبيقات.
- متابعة آخر الأخبار والإشعارات حول واجهة برمجة التطبيقات على القائمة البريدية لتقارير تحديد المصدر.
- إذا كانت لديك أسئلة تقنية، الإبلاغ عن خطأ في Chromium.
- للأسئلة المتعلقة بالتنفيذ والتكامل وأفضل الممارسات العامة: إنشاء مشكلة ضِمن مستودع دعم المطوّرين ضمن "مبادرة حماية الخصوصية"