مقدمة عن تقارير تصحيح أخطاء إعداد تقارير تحديد المصدر

الجزء 1 من 3 حول تصحيح أخطاء Attribution Reporting تعرَّف على أهمية تصحيح الأخطاء ومتى يجب استخدام تقارير تصحيح الأخطاء في الاختبار.

أهمية تقارير تصحيح الأخطاء

إذا كنت تختبر واجهة برمجة التطبيقات Attribution Reporting API، عليك التأكّد من أنّ عملية الدمج تعمل بشكل سليم، وفهم الثغرات في نتائج القياس بين عملية التنفيذ المستندة إلى ملفات تعريف الارتباط وعملية التنفيذ باستخدام Attribution Reporting، وتحديد المشاكل وحلّها في عملية الدمج.

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

مسرد المصطلحات

الجوانب الرئيسية لتقارير تصحيح الأخطاء

نوعان من تقارير تصحيح الأخطاء

يتوفّر نوعان من تقارير تصحيح الأخطاء. استخدِم كليهما، لأنّهما يخدمان حالات استخدام مختلفة.

تقارير تصحيح الأخطاء الناجحة

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

تتوفّر تقارير تصحيح الأخطاء الخاصة بالنجاح منذ الإصدار 101 من Chrome (أبريل 2022).

تقارير تصحيح الأخطاء المطوَّلة

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

  • الحالات التي سجّل فيها المتصفّح مصدرًا بنجاح
  • الحالات التي لم يسجّل فيها المتصفّح مصدرًا أو حدثًا مشغّلاً بنجاح، ما يعني أنّه لن ينشئ تقرير تحديد مصدر.
  • الحالات التي يتعذّر فيها إنشاء تقرير تحديد المصدر أو إرساله لسبب ما

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

تتوفّر تقارير تصحيح الأخطاء التفصيلية منذ الإصدار 109 من Chrome (كانون الثاني/يناير 2023)، باستثناء تقارير تصحيح الأخطاء التفصيلية لنجاح تسجيل المصدر التي تمت إضافتها لاحقًا في الإصدار 112 من Chrome.

راجِع أمثلة على التقارير في الجزء 2: إعداد تقارير تصحيح الأخطاء.

لاستخدام تقارير تصحيح الأخطاء، يجب أن يضبط مصدر إعداد التقارير ملف تعريف ارتباط.

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

يتم إرسال تقارير تصحيح الأخطاء على الفور

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

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

يتم إرسال تقارير تصحيح الأخطاء المفصّلة فور تسجيل المصدر أو المشغّل.

تتضمّن تقارير تصحيح الأخطاء مسارات نقاط نهاية مختلفة

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

  • نقطة النهاية لتقارير تصحيح الأخطاء الناجحة على مستوى الحدث
  • نقطة نهاية لتقارير تصحيح الأخطاء الناجحة، قابلة للتجميع
  • نقطة النهاية لتقارير تصحيح الأخطاء التفصيلية، على مستوى الحدث والقابلة للتجميع

يمكنك الاطّلاع على مزيد من المعلومات في الجزء 2: إعداد تقارير تصحيح الأخطاء.

حالات الاستخدام

التحقّق الأساسي من عملية الدمج في الوقت الفعلي

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

تعرَّف على كيفية إجراء ذلك في الجزء 3: كتاب وصفات تصحيح الأخطاء.

تحليل الخسائر

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

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

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

تعرَّف على كيفية إجراء تحليل الخسارة في الجزء 3: دليل تصحيح الأخطاء.

تحديد المشاكل وحلّها

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

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

التحقّق من الإعدادات المتقدّمة

تتيح لك بعض ميزات Attribution Reporting API تخصيص سلوكيات واجهة برمجة التطبيقات. قواعد الفلترة وقواعد إزالة التكرار وقواعد الأولوية هي بعض الأمثلة.

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

الاختبار المحلي باستخدام التقارير القابلة للتجميع

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

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

إعادة معالجة تقارير "خدمة تجميع البيانات"

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

  • محاولة تصحيح أخطاء "خدمة تجميع البيانات"
  • تجربة استراتيجيات تجميع مختلفة
  • تجربة قيم مختلفة لـ epsilon

استرداد البيانات

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

التالي

الجزء 2: إعداد تقارير تصحيح الأخطاء