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

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

من هم الأشخاص المعنيّون بهذا الإجراء؟

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

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

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

ما هي Attribution Reporting API؟

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

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

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

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

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

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

  • اختبِر التطبيق على جهازك في المتصفّح. ضبط علامة، التي تُعلِم متصفِّح Chrome بتفعيل ميزات تجريبية معيّنة

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

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

مدى التوفّر

الاقتراح الحالة
رحلة الإحالة الناجحة: من التطبيق إلى الويب
شرح الويب وشرح Android
إشعار القائمة البريدية		 متوفّرة في Chrome وAndroid للإصدار التجريبي من التطبيق الأصلي
رحلة الإحالة الناجحة: على جميع الأجهزة
شرح		 تم وضع هذا الاقتراح في الأرشيف. ما مِن خطط حالية لتنفيذ هذه الميزة.
منع التقارير غير الصالحة التي يمكن تجميعها باستخدام ميزة التحقّق من التقارير
شرح 		تم وضع هذا الاقتراح في الأرشيف. لقد نفّذنا trigger_context_id لحالة الاستخدام هذه بدلاً من ذلك.
ستظل قائمة المسموح بها التلقائية لسياسة أذونات Attribution Reporting API هي *
إشعار القائمة البريدية.		 ستتوفّر في Chrome في الربع الأول من عام 2023
إعداد تقارير قابلة للضبط على مستوى الحدث epsilon
مشكلة GitHub		 ستتوفّر في Chrome في الربع الأخير من عام 2023
إضافة بيانات زائدة إلى الحمولة في التقارير القابلة للتجميع
الشرح المعدَّل		 ستتوفّر في Chrome في الربع الأخير من عام 2023
على مستوى الحدث المرن
شرح الإعدادات المرنة على مستوى الحدث		 تتوفّر في Chrome في الربع الأخير من عام 2023
إمكانية تخصيص عدد تقارير تحديد المصدر وعدد فترات إعداد التقارير أو طولها

تتوفّر في Chrome في الربع الأول من عام 2024
إمكانية تخصيص عدد بتات بيانات العامل المشغِّل
إتاحة تقارير تصحيح الأخطاء التفصيلية في ميزة "تقارير الإحالة" والتي لا تعتمد على ملفات تعريف الارتباط التابعة لجهات خارجية
الشرح		 تتوفّر الميزة في Chrome في الربع الثالث من عام 2024.
إتاحة Attribution Reporting API وAggregation Service في Google Cloud
شرح Attribution Reporting API
شرح Aggregation Service		 ستتوفّر في Chrome في النصف الثاني من عام 2023
شرح حول فلترة المساهمات المرنة
 تتوفّر الميزة في Chrome في الربع الثالث من عام 2024.
الفلترة قبل تحديد المصدر: نطاقات تحديد المصدر
الشرح		 تتوفّر الميزة في Chrome في الربع الأخير من عام 2024.

حالات الاستخدام والميزات

توفّر واجهة برمجة التطبيقات Attribution Reporting API إمكانية الوصول إلى أنواع مختلفة من الإحصاءات من خلال نوعَين من التقارير التي يمكن إرسالها إلى المعلِن أو مقدّم تكنولوجيا إعلان تابع لجهة خارجية. يمكن استخدام هذين النوعَين من التقارير معًا، ويكملان بعضهما.

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

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

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

التقرير على مستوى الحدث
مثال على تقرير على مستوى الحدث: أدّت النقرة التي تحمل رقم التعريف 200400600 على news.example (المرتبطة برقم تعريف المستخدم Bob_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.

وسائل الحماية في كل نوع من أنواع التقارير

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

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

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

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

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

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

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

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

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

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