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

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

مَنِ الشَّخْصُ الْمَطْلُوبْ إِرْسَالُ التَّذْكِيرْ إِلَيْهِ؟

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

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

ما هي Attribution Reporting API؟

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

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

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

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

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

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

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

إذا كنت مهتمًا بتجربة واجهة برمجة التطبيقات، يمكنك الانتقال إلى تقارير تحديد المصدر: التجربة والمشاركة.

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

توفّر الخدمة

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

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

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

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

تقرير على مستوى الحدث
مثال على تقرير على مستوى الحدث: أدى رقم تعريف النقرة 200400600 على news.example (مرفق برقم تعريف المستخدم Bob_Doe في news.example) إلى إجراء عملية شراء في shop.example.

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

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

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

توفّر التقارير الموجزة (المعروفة سابقًا باسم التقارير المجمّعة) بيانات إحالات ناجحة أكثر تفصيلاً ومرونة أكبر في دمج بيانات النقرات أو المشاهدات وبيانات الإحالات الناجحة.

اطّلِع على مزيد من المعلومات عن تقارير الملخّص.

مثال على الإحصاءات من التقارير التلخيصية
في ما يلي مثال على الإحصاءات من التقارير الموجزة: نتجت عن CampaignID 1234567 على news.example 518 إحالة ناجحة في shoes.example، وإجمالي إنفاق 38174 دولار أمريكي. كان نصف الإحالات الناجحة من المستخدمين في نيويورك بالولايات المتحدة الأمريكية.

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

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

ميزات أخرى

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

.

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

على الرغم من اختلاف واجهتَي برمجة التطبيقات، إلّا أنّ 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 بت إلّا بمعلومات صغيرة جدًا من مواقع إلكترونية متعددة: 1 بت أو 3 بت، وهي معلومات غير كافية للاحتفاظ بمعرّف.
    • ولا تُعد وحدات 64 بت الخاصة بجانب الإعلان معلومات جديدة. يمكن أن يتوفر رقم تعريف المستخدم بالفعل على جانب الإعلان اليوم. سبق أن اطّلعَت news.example أو adtech.example على نشاط مستخدم معيّن على news.example.
  • يتم تطبيق إجراءات حماية إضافية لمنع إساءة الاستخدام وتتبُّع المواقع الإلكترونية المختلفة:
    • يتم إرسال التقارير مع تأخير.
    • بيانات الإحالات الناجحة غير واضحة: في نسبة معيّنة من الوقت، يتم إنشاء تقارير مزيفة.
    • يكون عدد تقارير الإحالات الناجحة المنسوبة محدودًا لكل نقرة أو مشاهدة.

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

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

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

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