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