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