نظرة عامة على إعداد تقارير الإحالة للويب

يمكنك قياس الحالات التي تؤدّي فيها نقرة على إعلان أو مشاهدته إلى إحالة ناجحة، مثل عملية شراء على موقع إلكتروني للمعلِن.

لمن هذا؟

ستجد هنا أساسيات إعداد تقارير تحديد المصدر وبعض المفاهيم الأساسية، ولكن ليس كثيرًا من التفاصيل الفنية.

• إذا كنت تعمل في مجال تكنولوجيا الإعلان أو الإعلان، ستتعرّف على الطريقة التي توفّر بها واجهة برمجة التطبيقات هذه إمكانات تفعِّلها ملفات تعريف الارتباط التابعة لجهات خارجية. راجِع حالات الاستخدام لواجهة برمجة التطبيقات، التي تحتوي على مزيد من التفاصيل حول كيفية إنشاء التقارير.
• إذا كنت مطوّرًا أو مهندس برامج، يمكنك الانتقال إلى النظرة العامة الكاملة على النظام أو تجربة واجهة برمجة التطبيقات والمشاركة فيها.

لا يحتاج المعلنون والناشرين الذين يعتمدون على منصّات تكنولوجيا الإعلان لقياس الإحالات الناجحة إلى استخدام واجهة برمجة التطبيقات مباشرةً. قد تكون مهتمًا بالتعرّف على آلية عمل Attribution Reporting إذا كانت تقنية الإعلان تخطط للدمج مع واجهة برمجة التطبيقات هذه.

ما هي Attribution Reporting API؟

في الوقت الحالي، يعتمد قياس الإحالات الناجحة للإعلانات غالبًا على ملفات تعريف الارتباط التابعة لجهات خارجية. تحظر المتصفّحات الوصول إلى ملفات تعريف الارتباط التابعة لجهات خارجية لأنّها يمكن استخدامها لتتبُّع المستخدمين في المواقع الإلكترونية وإعاقة خصوصية المستخدم.

تتيح Attribution Reporting API هذه القياسات بطريقة تحافظ على الخصوصية، بدون استخدام ملفات تعريف الارتباط التابعة لجهات خارجية.

وتمكّن واجهة برمجة التطبيقات هذه المعلنين ومزوّدي تقنية الإعلان من قياس الإحالات الناجحة في الحالات التالية:

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

إذا لم تكن معتادًا على بعض هذه المصطلحات أو المفاهيم، يُرجى الرجوع إلى مسرد مصطلحات "مبادرة حماية الخصوصية".

تجربة واجهة برمجة التطبيقات

• اختبِر محليًا في متصفحك. اضبط علامة تطلب من متصفّح Chrome تفعيل ميزات تجريبية محدّدة.

إذا كنت مهتمًا بتجربة واجهة برمجة التطبيقات، انتقِل إلى Attribution Reporting: التجربة والمشاركة.

التغييرات في واجهة برمجة التطبيقات

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

• تربط التقارير على مستوى الحدث نقرة معيّنة على إعلان أو عرضها (على جانب الإعلان) بالبيانات على جانب الإحالة الناجحة. بيانات جانب الإحالة الناجحة محدودة للغاية، والبيانات غير واضحة (مما يعني أنه بالنسبة إلى نسبة صغيرة من الحالات، يتم إرسال بيانات عشوائية بدلاً من التقارير الحقيقية). يحافظ ذلك على خصوصية المستخدم عن طريق منع دمج هوية المستخدم على مواقع إلكترونية أخرى. لتوفير حماية إضافية للخصوصية، يتم إرسال التقارير بشكل متأخر.
• لا ترتبط التقارير الموجزة بحدث معيّن على جانب الإعلان. توفِّر هذه التقارير بيانات إحالات ناجحة أكثر ثراءً وأعلى دقة من التقارير على مستوى الحدث. تساعد مزيجًا من أساليب الخصوصية في تقليل مخاطر ضم الهوية عبر المواقع الإلكترونية.

التقارير على مستوى الحدث

تربط التقارير على مستوى الحدث بين النقرة على الإعلان أو المشاهدة وبيانات الإحالات الناجحة التقريبية.

تكون التقارير على مستوى الحدث مناسبة لما يلي:

• التحسين: أجب عن أسئلة مثل "كيف يمكنني تحسين عائد الاستثمار؟" وعلى وجه الخصوص، يمكن استخدام هذه التقارير لتحسين موضع الإعلان، إذ يمكن توفير أرقام تعريف فريدة من جانب الإعلان في التقارير. يمكن أن توفّر التقارير على مستوى الحدث بيانات تدريب لنماذج تعلُّم الآلة.
• التقارير التقريبية، التي تحتاج فيها إلى القليل جدًا من المعلومات حول الإحالة الناجحة. الحد الحالي هو 3 وحدات بت من بيانات الإحالات الناجحة للنقرات⏤، يعني ذلك أنّه يمكن تخصيص إحدى الفئات الثماني وحدات بت واحدة للملفات الشخصية⏤بتة واحدة. لا يمكن ترميز البيانات الدقيقة إلى جانب الإحالة الناجحة، مثل سعر معيّن أو وقت الإحالة الناجحة، في التقارير على مستوى الحدث.
• رصد الاحتيال: يمكن أن تكون البيانات الواردة في بعض التقارير مفيدة لرصد الاحتيال الإعلاني وتحليله، من خلال السماح لك بفهم الأنماط التي يمكن استخدامها لتحديد النشاط غير المرغوب فيه أو غير الصالح.

التقارير الموجزة

توفِّر التقارير التلخيصية (المعروفة سابقًا باسم التقارير المجمَّعة) بيانات إحالات ناجحة أكثر تفصيلاً ومرونة أكبر لدمج بيانات النقرات أو العرض وبيانات الإحالات الناجحة.

مزيد من المعلومات عن التقارير الموجزة

تكون التقارير الموجزة هي الأنسب للإبلاغ عن حالات الاستخدام. تساعد هذه التقارير في الإجابة عن أسئلة مثل: "ما عائد الاستثمار الخاص بي؟"

يُعدّ استخدام التقارير التلخيصية للتحسين، على سبيل المثال، التحسين لزيادة قيمة الشراء، وهي غير متوافقة مع التقارير على مستوى الحدث (لأنّ بيانات الإحالات الناجحة تقريبية جدًا)، أحد مجالات البحث النشط.

ميزات أخرى

تشمل الميزات الأخرى لواجهة برمجة التطبيقات هذه ما يلي:

• تحديد المصدر من تطبيق إلى موقع إلكتروني: يمكنك مشاهدة إعلان في أحد التطبيقات أو النقر عليه وتحويله على الويب.

.

المتصفحات المتوافقة

• لم يشارك كل من Firefox وEdge الإشارات.
• متصفّح Safari وWebkit سلبي واقترحا واجهة برمجة تطبيقات مختلفة لقياس الإحالات الناجحة للإعلانات، تُسمى قياس النقرات الخاصة.

على الرغم من اختلاف واجهتَي برمجة التطبيقات، يعمل Chrome وWebKit معًا بشكل مفتوح لتبسيط تجربة المطوّرين، على سبيل المثال من خلال المواءمة بين أسماء السمات وبنية JSON للتقارير.

تختلف مجموعة ميزات Attribution Reporting 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 إمكانية قياس حدثَين مرتبطَين معًا: حدث على الموقع الإلكتروني للناشر، مثل مشاهدة مستخدم لإعلان أو النقر عليه، مع إحالة ناجحة لاحقة على موقع إلكتروني لأحد المعلنين.

التقارير على مستوى الحدث

التقارير الموجزة

يتم إنشاء التقارير التلخيصية على النحو التالي:

• ينقر المستخدم على إعلان تم إعداده بشكل خاص أو يعرضه. ويسجِّل المتصفّح، على جهاز المستخدم المحلي، هذا الحدث، إلى جانب بيانات إعداد تحديد المصدر المحدَّدة مسبقًا.
• وفي وقت لاحق، عندما يُجري المستخدم إحالة ناجحة، يطابق المتصفّح حدث النقر أو المشاهدة التفصيلية هذا (المعروف باسم حدث مصدر تحديد المصدر) مع بيانات الإحالات الناجحة التفصيلية (المعروفة باسم بيانات مشغّل تحديد المصدر). تجدر الإشارة إلى أنّ أبعاد التفاصيل التي تم تسجيلها محدّدة مسبقًا من قِبل شركة تعمل في مجال تكنولوجيا الإعلان، ويتّبع المتصفّح منطقًا معيّنًا يتم تحديده من خلال تقنية الإعلان. ومن ثم يُخرج المتصفّح هذه البيانات في تقرير قابل للتجميع.
• يتم تشفير التقارير القابلة للتجميع بواسطة المتصفح وإرسالها إلى أحد خوادم تقنية الإعلان. من خادم تكنولوجيا الإعلان، يتم إرسال التقارير القابلة للتجميع إلى خدمة التجميع لإنشاء تقرير ملخّص.
• بعد ذلك، يتم توفير التقارير الموجزة لتقنية الإعلان. يُرجى العلم أنّ التقارير الموجزة لا تتأخر بالقدر نفسه الذي يتم فيه إنشاء التقارير على مستوى الحدث.

يمكنك قراءة المزيد من المعلومات عن التقارير الموجزة.

الخصوصية

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

لنأخذ شخصًا يدعى يوسف. يشاهد أمجد إعلانًا أثناء قراءة الأخبار على news.example. بعد أسبوع، يشتري يوسف أحذية على shoes.example.

في الوقت الحالي، سيتم تتبُّع هذه الإحالة الناجحة من خلال ملف تعريف ارتباط تابع لجهة خارجية ويُستخدم كمعرّف على عدة مواقع إلكترونية. باستخدام ملفات تعريف الارتباط التابعة لجهات خارجية، يمكن لشركة تكنولوجيا الإعلان الاطّلاع على الكثير من التفاصيل حول نشاط يوسف على news.example وعلى shoes.example. ويمكن لتكنولوجيا الإعلان دمج هذه المعلومات معًا لإنشاء ملف شخصي تفصيلي لبوب، بما في ذلك موقع يوسف وعادات التصفّح والقراءات المفضّلة على news.example. ويمكن أن يتضمن هذا الملف الشخصي أيضًا عمليات الشراء والنشاط وبيانات بطاقة الائتمان على shoes.example. يُعدّ هذا العنصر المشترك على مواقع إلكترونية مفيدًا لقياس الإحالات الناجحة للإعلانات. لكنه يعيق خصوصية المستخدم: يتم تتبع نشاط بوب عبر المواقع بمستوى عالٍ من التفاصيل.

يتم دمج قدر صغير من المعلومات على مستوى المواقع الإلكترونية، وهو ما يكفي لقياس الإحالات الناجحة، ولكن ليس بما يكفي لتتبُّع نشاط "يوسف" على المواقع الإلكترونية بالتفصيل. سيظل نشاط يوسف على news.example وعلى shoes.example منفصلاً.

إجراءات الحماية في كل نوع تقرير

تعمل التقارير على مستوى الحدث على ربط معرِّف على جهة الإعلان بكمية صغيرة من بيانات جهة الإحالة الناجحة. وعلى الرغم من أنّ هذه المعلومات توفّر معلومات على مواقع إلكترونية مختلفة حول إحالة ناجحة معيّنة، فإنّ معلومات جانب الإحالة الناجحة عامة جدًا بحيث يتعذّر عليها ربط هوية المستخدم على جميع المواقع الإلكترونية.

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

يتم فرض إجراءات حماية إضافية للخصوصية، مثل قيود المعدل، على كل من التقارير على مستوى الحدث والتقارير المجمَّعة.

بالتفصيل: التقارير على مستوى الحدث والخصوصية

تقدِّم التقارير على مستوى الحدث إحصاءات عن الإحالات الناجحة بدون تتبُّع المستخدِمين على المواقع الإلكترونية، وذلك عن طريق اتّباع آليات الخصوصية التالية:

• لا يتم استخدام أي معرِّف على مواقع إلكترونية مختلفة ولا تتم مغادرة الجهاز لأيّ نشاط تصفُّح تفصيلي على مواقع إلكترونية متعددة.
• تربط التقارير على مستوى الحدث 64 بت من المعلومات على جانب الإعلان (news.example) بت واحد أو 3 بت فقط على جانب الإحالة الناجحة (shop.example). وتمثل 64 بت معلومات كافية لربطها بمعرِّف مستخدم فردي، ولكن لا يمكن ربط هذه البيانات البالغ عددها 64 بت إلا بمعلومات قليلة جدًا من مواقع إلكترونية مختلفة: وحدة بت واحدة أو 3 بت، وهي ليست كافية للاحتفاظ بمعرِّف.
  • ولا تعتبر وحدات 64 بت في جانب الإعلان معلومات جديدة. يمكن أن يكون رقم تعريف المستخدم متاحًا بالفعل على جانب الإعلان اليوم. هناك معرفة لدى news.example أو adtech.example من قبل بنشاط مستخدم معيّن على news.example.
• يتم تطبيق إجراءات حماية إضافية لمنع إساءة الاستخدام والتتبُّع على مواقع إلكترونية متعددة:
  • يتم إرسال التقارير مع مهلة.
  • تكون بيانات الإحالات الناجحة مزعجة: في نسبة معيّنة من الوقت، يتم إنشاء تقارير مزيّفة.
  • يكون عدد تقارير الإحالات الناجحة المحدّدة المصدر محدودًا لكل نقرة أو مشاهدة.

بالتفصيل: ملخص التقارير والخصوصية

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

• لا يتم استخدام معرّف مواقع إلكترونية متعددة.
• يمكن لكل إسناد أن يقدم مساهمات متعددة في تقرير ملخص ناتج. ويمكن لأي مستخدم تشغيل إحالات متعددة لنقرة (أو مشاهدة) وإحالة ناجحة معيّنة.
• ويتم تجميع البيانات على مستوى العديد من الأحداث (عدد المستخدمين)، ولا يمكن مراقبة أحداث فردية بدقة. عند النظر إلى البيانات المجمعة، كلما ازداد مستوى التفاصيل، يزداد كذلك التشويش النسبي. تكون شرائح البيانات التي تجمع الكثير من الأحداث والمستخدمين أكثر دقة للحفاظ على الاستفادة.
• إنّ التقارير الأولية التي تربط بين حدث نقرة أو عرض تفصيلي ببيانات الإحالات الناجحة المفصّلة تكون مشفّرة ولا يمكن لشركة تكنولوجيا الإعلان قراءتها. يمكن فقط لخدمة التجميع قراءة هذه البيانات.
• يتم تطبيق إجراءات حماية إضافية لمنع إساءة الاستخدام والتتبُّع على مواقع إلكترونية متعددة:
  • يتم إرسال التقارير مع تأخيرات عشوائية.
  • تكون الاستعلامات المتعلقة بشرائح مختلفة من البيانات محدودة بمعدل.

التفاعل مع الملاحظات ومشاركتها

• إذا كانت لديك أسئلة حول واجهة برمجة التطبيقات: يمكنك إنشاء مشكلة في مستودع واجهة برمجة التطبيقات.
• يمكنك متابعة آخر الأخبار والإشعارات حول واجهة برمجة التطبيقات في القائمة البريدية لإعداد تقارير Attribution.
• إذا كان لديك أسئلة فنية، يمكنك الإبلاغ عن خطأ في Chromium.
• للأسئلة المتعلّقة بالتنفيذ والدمج وأفضل الممارسات العامة: إنشاء مشكلة في مستودع دعم المطوّرين ضمن "مبادرة حماية الخصوصية"