الجزء 1 من 3 أجزاء حول تصحيح أخطاء تقارير تحديد المصدر تعرَّف على أهمية تصحيح الأخطاء وحالات استخدام تقارير تصحيح الأخطاء في الاختبار.
أهمية تقارير تصحيح الأخطاء
إذا كنت تختبر Attribution Reporting API، عليك التحقّق من أنّ عملية الدمج تعمل بشكلٍ سليم، وفهم الفجوات في نتائج القياس بين تنفيذك بالاستناد إلى ملفّات تعريف الارتباط وتنفيذك لميزة "إعداد تقارير الإحالات الناجحة"، وتحديد أي مشاكل في عملية الدمج وحلّها.
يجب استخدام تقارير تصحيح الأخطاء لإكمال هذه المهام. لذلك، ننصحك بشدة بإعدادها.
مسرد المصطلحات
الجوانب الرئيسية لتقارير تصحيح الأخطاء
نوعان من تقارير تصحيح الأخطاء
يتوفّر نوعان من تقارير تصحيح الأخطاء. استخدِم كليهما، لأنّهما يلبّيان حالات استخدام مختلفة.
تقارير تصحيح الأخطاء للنجاح
تتتبّع تقارير تصحيح أخطاء النجاح عمليات إنشاء تقارير تحديد المصدر بنجاح. ترتبط بشكل مباشر بتقرير إحالة.
أصبحت تقارير تصحيح أخطاء عمليات التنفيذ الناجحة متاحة منذ إصدار Chrome 101 (نيسان/أبريل 2022).
تقارير تصحيح الأخطاء المفصّلة
تمنحك تقارير تصحيح الأخطاء المفصّلة المزيد من المعلومات عن المصدر والأحداث المشغّلة، ما يتيح لك التأكّد من تسجيل المصادر بنجاح أو تتبُّع التقارير المفقودة وتحديد سبب فقدانها (تعذُّر في المصدر أو أحداث التفعيل، أو تعذُّر عند إرسال التقرير أو إنشائه). تشير تقارير تصحيح الأخطاء المفصّلة إلى ما يلي:
- الحالات التي سجّل فيها المتصفّح مصدرًا بنجاح
- الحالات التي لم يسجّل فيها المتصفّح مصدرًا أو حدثًا مشغّلاً بنجاح، ما يعني أنّه لن يُنشئ تقرير تحديد مصدر.
- الحالات التي تعذّر فيها إنشاء تقرير تحديد المصدر أو إرساله لسبب ما
تتضمّن تقارير تصحيح الأخطاء التفصيلية حقل type الذي يصف إما تسجيل مصدر ناجح أو سبب عدم إنشاء تقرير مصدر أو عامل تشغيل أو مصدر إحالة.
أصبحت تقارير تصحيح الأخطاء المفصّلة متاحة منذ الإصدار 109 من Chrome (كانون الثاني/يناير 2023)، باستثناء تقارير تصحيح الأخطاء المفصّلة لنجاح تسجيل المصدر التي تمت إضافتها لاحقًا في الإصدار 112 من Chrome.
راجِع أمثلة التقارير في الجزء 2: إعداد تقارير تصحيح الأخطاء.
تستند تقارير تصحيح الأخطاء إلى ملفات تعريف الارتباط.
لاستخدام تقارير تصحيح الأخطاء، يجب أن يضبط مصدر إعداد التقارير ملفّ تعريف ارتباط.
إذا كان المصدر الذي تم ضبطه لتلقّي التقارير تابعًا لجهة خارجية، سيكون ملف تعريف الارتباط هذا تابعًا لجهة خارجية. وهذا يعني أنّه لا يتم إنشاء تقارير تصحيح الأخطاء إلا إذا كانت ملفات تعريف الارتباط التابعة لجهات خارجية مسموحًا بها في متصفّح المستخدم.
يتم إرسال تقارير تصحيح الأخطاء على الفور
يُرسِل المتصفّح تقارير تصحيح الأخطاء على الفور إلى مصدر إعداد التقارير. ويختلف ذلك عن تقارير الإحالة التي يتم إرسالها بعد تأخّر.
يتم إنشاء تقارير تصحيح أخطاء النجاح وإرسالها فور إنشاء تقرير تحديد المصدر المقابل، أي عند تسجيل العامل المشغِّل.
يتم إرسال تقارير تصحيح الأخطاء المفصّلة على الفور عند تسجيل المصدر أو عامل التفعيل.
تحتوي تقارير تصحيح الأخطاء على مسارات نقاط نهاية مختلفة
مثل تقارير تحديد المصدر، يتم إرسال جميع تقارير تصحيح الأخطاء إلى مصدر إعداد التقارير. يتم إرسال تقارير تصحيح الأخطاء إلى ثلاث نقاط نهاية منفصلة لمصدر إعداد التقارير:
- نقطة نهاية لتقارير تصحيح أخطاء النجاح، على مستوى الحدث
- نقطة نهاية لتقارير تصحيح أخطاء النجاح، يمكن تجميعها
- نقطة نهاية لتقارير تصحيح الأخطاء المفصّلة على مستوى الحدث وقابلة للتجميع
اطّلِع على مزيد من المعلومات في الجزء 2: إعداد تقارير تصحيح الأخطاء.
حالات الاستخدام
فحص أساسي للدمج في الوقت الفعلي
يتم إرسال تقارير تصحيح الأخطاء إلى نقطة النهاية على الفور، على عكس تقارير تحديد المصدر التي يتم تأخيرها لحماية خصوصية المستخدم. استخدِم تقارير تصحيح الأخطاء كإشارة في الوقت الفعلي تفيد بأنّ عملية الدمج مع واجهة برمجة التطبيقات Attribution Reporting API تعمل بشكل صحيح.
تعرَّف على كيفية إجراء ذلك في الجزء 3: دليل تصحيح الأخطاء.
تحليل الخسائر
على عكس ملفات تعريف الارتباط التابعة لجهات خارجية، تتضمّن واجهة برمجة التطبيقات لميزة "إعداد تقارير تحديد المصدر" إجراءات حماية مضمّنة للخصوصية، وهي مصمّمة لتحقيق التوازن بين الفائدة والخصوصية. وهذا يعني أنّه باستخدام واجهة برمجة التطبيقات Attribution Reporting API، قد لا تتمكّن من جمع كل بيانات القياس التي يمكنك جمعها باستخدام ملفات تعريف الارتباط. لن تؤدي بعض الإحالات الناجحة التي يمكنك تتبُّعها باستخدام ملفات تعريف الارتباط التابعة لجهات خارجية إلى إنشاء تقرير تحديد مصدر.
على سبيل المثال، بالنسبة إلى التقارير على مستوى الحدث، يمكنك تسجيل إحالة ناجحة واحدة كحدّ أقصى لكل مرّة ظهور. وهذا يعني أنّه لكلّ مرّة ظهور معيّنة للإعلان، ستحصل على تقرير تحديد مصدر واحد فقط، بغضّ النظر عن عدد المرّات التي يُجري فيها المستخدِم إحالة ناجحة.
استخدِم تقارير تصحيح الأخطاء للاطّلاع على الاختلافات بين نتائج القياس المستندة إلى ملفات تعريف الارتباط والنتائج التي تحصل عليها باستخدام واجهة برمجة التطبيقات Reporting API لتحديد المصدر. حدِّد الإحالات الناجحة التي يتم تسجيلها وعدد الإحالات الناجحة التي لا يتم تسجيلها، وعلى وجه التحديد الإحالات الناجحة التي لا يتم تسجيلها وسبب ذلك.
تعرَّف على كيفية إجراء تحليل الخسارة في الجزء 3: دليل تصحيح الأخطاء.
تحديد المشاكل وحلّها
على الرغم من أنّ الخسارة الناتجة عن إجراءات حماية الخصوصية أو الموارد متوقّعة، قد تكون الخسارة الأخرى غير مقصودة. يمكن أن تؤدي الأخطاء في عملية التنفيذ أو الأخطاء في المتصفّح نفسه إلى عدم توفّر التقارير.
يمكنك استخدام تقارير تصحيح الأخطاء لرصد مشكلة في التنفيذ وحلّها من جانبك، أو لتسجيل خطأ محتمل لدى فِرق المتصفّحات. تعرَّف على كيفية إجراء ذلك في الجزء 3: دليل تصحيح الأخطاء.
التحقّق من الإعدادات المتقدّمة
تتيح لك بعض ميزات Attribution Reporting API تخصيص سلوكيات واجهة برمجة التطبيقات. وتشمل الأمثلة على ذلك قواعد الفلترة وقواعد إزالة التكرار وقواعد الأولوية.
عند استخدام هذه الميزات، استخدِم تقارير تصحيح الأخطاء للتحقّق من أنّ منطقك يؤدي إلى السلوك المقصود في مرحلة الإنتاج، بدون انتظار تقارير تحديد المصدر. تعرَّف على كيفية إجراء ذلك في الجزء 3: دليل تصحيح الأخطاء.
الاختبار على مستوى التطبيق باستخدام تقارير قابلة للتجميع
على عكس تقارير تحديد المصدر القابلة للتجميع والمشفَّرة، تتضمّن تقارير تصحيح الأخطاء القابلة للتجميع حمولة غير مشفَّرة.
استخدِم تقارير تصحيح الأخطاء القابلة للتجميع للتحقّق من محتوى التقارير القابلة للتجميع، وإنشاء تقارير تلخيصية باستخدام أداة التجميع المحلية للاختبار.
إعادة معالجة تقارير "خدمة تجميع البيانات"
من المزايا الأخرى لاستخدام وضع تصحيح الأخطاء أنّه يتيح لك معالجة التقارير مرة أخرى. لذلك، لمعالجة التقارير أكثر من مرة، تأكَّد من تفعيل تقارير تصحيح الأخطاء. قد تحتاج إلى إعادة معالجة التقارير في الحالات التالية:
- محاولة تصحيح أخطاء "خدمة تجميع البيانات"
- تجربة استراتيجيات تجميع مختلفة
- تجربة قيم مختلفة لدالة epsilon
استرداد البيانات
ننصحك بتفعيل وضع تصحيح الأخطاء في تكنولوجيات الإعلان لتلقّي تقارير تصحيح الأخطاء حتى تتمكّن من استرداد بيانات إعداد التقارير. يكون ذلك مفيدًا في حالات حدوث مشاكل في "خدمة التجميع"، مثل الخدمات غير المتوفّرة أو غير المتفاعلة التي قد تؤدي إلى تعذّر إنشاء التقرير التلخيصي.