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

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

لمن هذا؟

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

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

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

ما هي Attribution Reporting API؟

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

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

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

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

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

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

  • اختبِر محليًا في متصفحك. ضَع علمًا. التي تطلب من متصفّح 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 (المرفق برقم تعريف المستخدم Bo_Doe في news.example) أدّى إلى إجراء عملية شراء في shop.example.

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

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

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

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

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

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

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

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

ميزات أخرى

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

.

دعم المتصفح

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

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

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

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

إنشاء تقرير الملخّص

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

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

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

الخصوصية

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

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

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

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

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