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