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

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

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

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

  • أصل إعداد التقارير هو المصدر الذي يضبط عنوانَي المصدر والعامل الخاص بإعداد تقارير تحديد المصدر. ويتم إرسال جميع التقارير التي ينشئها المتصفّح إلى هذا المصدر. في هذه الإرشادات، نستخدم https://adtech.example كمثال على مصدر الإبلاغ.
  • تقرير تحديد المصدر (التقرير باختصار) هو التقرير النهائي (على مستوى الحدث أو القابل للتجميع) الذي يحتوي على بيانات القياس التي طلبتها.
  • يحتوي تقرير تصحيح الأخطاء على بيانات إضافية عن تقرير تحديد المصدر أو عن مصدر أو حدث عامل تشغيل. لا يعني تلقّي تقرير تصحيح الأخطاء بالضرورة أنّ شيء ما يعمل بشكل غير صحيح. هناك نوعان من تقارير تصحيح الأخطاء.
  • تقرير تصحيح الأخطاء الانتقالي هو تقرير تصحيح أخطاء يتطلّب ضبط ملف تعريف الارتباط حتى يتم إنشاؤه وإرساله. لن تتوفّر تقارير تصحيح الأخطاء الانتقالية في حال عدم ضبط ملف تعريف ارتباط، وعند إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية نهائيًا. إنّ جميع تقارير تصحيح الأخطاء الموضَّحة في هذا الدليل هي تقارير تصحيح أخطاء انتقالية.
  • تتتبّع تقارير تصحيح الأخطاء الناجحة إنشاء تقرير تحديد المصدر بنجاح. ترتبط ارتباطًا مباشرًا بتقرير تحديد المصدر. تتوفّر تقارير تصحيح الأخطاء الناجحة منذ إصدار Chrome 101 (نيسان/أبريل 2022).
  • بإمكان تقارير تصحيح الأخطاء المطوَّلة تتبُّع التقارير غير المتوفّرة ومساعدتك في تحديد سبب عدم توفّرها. وهي تشير إلى الحالات التي لم يسجِّل فيها المتصفّح مصدرًا أو أدّى إلى بدء حدث، ما يعني أنّه لن ينشئ تقرير تحديد مصدر)، والحالات التي يتعذّر فيها إنشاء تقرير تحديد المصدر أو إرساله لسببٍ ما. تتضمّن تقارير تصحيح الأخطاء المطوَّلة حقل type يصف سبب عدم إنشاء حدث مصدر أو حدث عامل تشغيل أو تقرير تحديد مصدر. تتوفّر تقارير تصحيح الأخطاء المطوَّلة اعتبارًا من الإصدار 109 من Chrome (استقرار في كانون الثاني/يناير 2023).
  • مفاتيح تصحيح الأخطاء هي معرّفات فريدة يمكنك ضبطها على كل من الجانب المصدر وجانب المشغّل. وتمكّنك مفاتيح تصحيح الأخطاء من ربط الإحالات الناجحة المستندة إلى ملفات تعريف الارتباط والإحالات الناجحة المستندة إلى الإحالة. عند إعداد نظامك لإنشاء تقارير تصحيح الأخطاء وإعداد مفاتيح تصحيح الأخطاء، سيضمِّن المتصفّح مفاتيح تصحيح الأخطاء هذه في جميع تقارير تحديد المصدر وتقارير تصحيح الأخطاء.

لمزيد من المفاهيم والمصطلحات الرئيسية المُستخدَمة في مستنداتنا، يُرجى الرجوع إلى مسرد مصطلحات "مبادرة حماية الخصوصية".

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

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

كيفية تحليل الخسارة وتحديد المشاكل وحلّها في عملية الدمج

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

نظرة عامة

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

استخدِم مفاتيح تصحيح الأخطاء (زوج <source_debug_key, trigger_debug_key>) لربط الإحالات الناجحة المستندة إلى ملفات تعريف الارتباط بتقارير تصحيح أخطاء النجاح. بالنسبة إلى كل إحالة ناجحة من ملف تعريف الارتباط، هل تلقّيت تقرير تصحيح أخطاء للنجاح المقابل في وقت الإحالة الناجحة؟

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

في حال عدم ظهوره: يعني ذلك أنّه لم يتم تسجيل الإحالة الناجحة في تقارير تحديد المصدر. استخدِم زوج <source_debug_key, trigger_debug_key> (أو مفتاح تصحيح أخطاء المصدر في حال عدم توفّر مفتاح تصحيح أخطاء المشغّل) لربط الإحالات الناجحة الناتجة عن ملفات تعريف الارتباط بتقارير تصحيح الأخطاء التفصيلية. بالنسبة إلى كلّ إحالة ناجحة من هذه الإحالات الناجحة، هل تلقّيت في وقت معيّن (مصدر أو وقت التفعيل) تقرير تصحيح أخطاء مفصّلاً ملائمًا؟

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

  • إذا تلقّيت تقرير تصحيح أخطاء مفصّلاً، اطّلِع على حقل type.

    • إذا كان type هو source-success: هذا يعني أنّه تم تسجيل المصدر بنجاح، ولكن لم يتم تسجيل العامل المشغِّل. لتضييق نطاق سبب عدم توفّر تقرير تصحيح أخطاء النجاح، ابحث عن تقرير تصحيح أخطاء مفصّل مطابق من أي نوع آخر⏤سيشير هذا التقرير إلى مشكلة في جانب المشغّل.

    • إذا كان type أي شيء آخر: لم يتم تسجيل المصدر أو العامل المشغِّل. type يوضّح لك السبب. لن يتوفّر تقرير تحديد المصدر المقابل (وتقرير تصحيح أخطاء النجاح). استنادًا إلى type تقرير تصحيح الأخطاء التفصيلي، يمكنك استخدام هذه المعلومات كنقطة بيانات لتحليل الخسارة (بمعنى آخر، لا داعي لاتخاذ أي إجراء)، أو يمكنك الإبلاغ عن خطأ أو تحديد المشاكل وحلّها في عملية التنفيذ. راجِع سيناريو تقرير تصحيح الأخطاء المفصّل لمعرفة التفاصيل.

السيناريوهات المحتمَلة

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

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

من المتوقّع أن تتلقّى لاحقًا تقرير تحديد مصدر لهذه الإحالة الناجحة⏤مع بعض الاستثناءات:

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

تقرير تصحيح أخطاء مفصّل من النوع source-success

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

هناك استثناء واحد:

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

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

  • حدود الخصوصية
  • حدود التخزين
  • القواعد المخصّصة
  • مشكلة في التنفيذ في الرمز البرمجي
  • خطأ في المتصفّح

بعض هذه الرسائل متوقّعة. يعتمد الإجراء الذي يجب اتّخاذه على type لكل تقرير مفصّل. راجِع مرجع التقارير المفصّلة.

لا تتوفّر تقارير تصحيح الأخطاء.

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

  • الإعدادات المفضّلة للمستخدم (أوقف المستخدم ملفات تعريف الارتباط التابعة لجهات خارجية)
  • عدم توفّر ملفّ تعريف ارتباط أو مفاتيح تصحيح الأخطاء (تم محو مفتاح تصحيح الأخطاء بسبب عدم توفّر ملفّ تعريف ارتباط) في chrome://attribution-internals، افتح علامة التبويب السجلّات وتحقّق مما إذا كانت هناك أي مشكلة تظهر فيها.
  • مشاكل الشبكة التي حدثت في المصدر أو وقت التفعيل، ولكن ليس عند إرسال تقرير تحديد المصدر

هل تتلقّى تقارير تحديد المصدر؟

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

  • مشكلة أساسية في الدمج راجِع كيفية تحديد وحلّ هذه المشاكل في مقالة حلّ المشاكل الأساسية في عملية الدمج.
  • مشاكل محتملة في الشبكة
  • الإعدادات المفضّلة للمستخدم في إعدادات المتصفّح، مثل "مبادرة حماية الخصوصية"، غير مفعّلة

مرجع تقارير تصحيح الأخطاء المفصّلة

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

اكتمال تسجيل المصدر بنجاح

تم تسجيل مصدر بنجاح.

source-success
التفاصيل ونص التقرير

تقارير القيود المفروضة على الخصوصية

هذه التقارير متوقّعة. وتشير هذه الرسائل إلى قيود الخصوصية التي تم فرضها للحد من تسرُّب هوية المستخدم على مستوى المواقع الإلكترونية.

source-destination-limit
التفاصيل ونص التقرير
source-noised
التفاصيل ونص التقرير
trigger-attributions-per-source-destination-limit
التفاصيل ونص التقرير
trigger-reporting-origin-limit
التفاصيل ونص التقرير
trigger-event-noise
التفاصيل ونص التقرير
trigger-event-excessive-reports
يتمّ إنشاء هذا التقرير إذا كان عدد التقارير يتجاوز الحدّ الأقصى المسموح به. يمكنك تسجيل إحالة ناجحة واحدة على الأكثر لكلّ مشاهدة، وثلاث إحالات ناجحة لكلّ نقرة. تجدر الإشارة إلى أنّه يمكنك ضبط التقارير التي تريد تلقّيها من خلال ضبط الأولويات. التفاصيل ونص التقرير

تقارير حدود مساحة التخزين

هذه التقارير متوقّعة. وتشير إلى قيود مساحة التخزين لمنع الاستخدام المفرط للموارد.

source-storage-limit
التفاصيل ونص التقرير
trigger-event-storage-limit
التفاصيل ونص التقرير
trigger-aggregate-storage-limit
التفاصيل ونص التقرير

تقارير القواعد المخصّصة

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

trigger-no-matching-filter-data
التفاصيل ونص التقرير
trigger-event-no-matching-configuration
التفاصيل ونص التقرير
trigger-event-deduplicated
التفاصيل ونص التقرير
trigger-aggregate-deduplicated
التفاصيل ونص التقرير
trigger-event-low-priority
التفاصيل ونص التقرير
trigger-event-report-window-passed
التفاصيل ونص التقرير
trigger-aggregate-report-window-passed
التفاصيل ونص التقرير

التقارير التفصيلية الأخرى

قد تشير هذه التقارير إلى مشاكل محتملة في التنفيذ في الرمز البرمجي.

trigger-no-matching-source
قد تكون هذه مشكلة في التنفيذ. تأكَّد من عدم حدوث أيّ خطأ في إعداد <reporting origin, destination>. وقد يكون هذا أيضًا سلوكًا متوقّعًا لواجهة برمجة التطبيقات. على سبيل المثال، قد يكون المستخدم قد أزال البيانات في مرحلة ما بعد التفاعل مع إعلان وقبل إجراء إحالة ناجحة، أو أجرى المستخدم إحالة ناجحة بدون رؤية إعلان مرتبط بها مطلقًا. التفاصيل ونص التقرير
trigger-aggregate-no-contributions
من المحتمل أنّ هذا ليس السلوك الذي تريد أن يتبعه الرمز البرمجي. تحديد المشاكل وحلّها في رمز تسجيل المشغّل، والتأكّد من صحة إعدادات المساهمات التفاصيل ونص التقرير
trigger-aggregate-insufficient-budget
من المحتمل أنّ هذا ليس السلوك الذي تريد أن يتبعه الرمز البرمجي. تحقّق جيدًا من رمز تسجيل العامل المشغِّل للتأكّد من أنّ مجموع جميع المساهمات لا يتجاوز ميزانية المساهمات. التفاصيل ونص التقرير

أخطاء غير متوقّعة (أخطاء محتملة في المتصفّح)

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

source-unknown-error
التفاصيل ونص التقرير
trigger-unknown-error
التفاصيل ونص التقرير

مثال على تحليل الخسائر

الخطوة 1: الإعداد والتعيين باستخدام ملفات تعريف الارتباط

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

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

الخطوة 2: تحديد عمليات التسجيل الناجحة والتقارير غير المتوفّرة

في هذا المثال، لنفترض أنّك تتبّعت 100 إحالة ناجحة باستخدام نظامك المستنِد إلى ملفات تعريف الارتباط.

في كل مرة تسجِّل فيها إحالة ناجحة مستندة إلى ملف تعريف ارتباط، ابحث عن تقرير تصحيح أخطاء النجاح (الذي يتم إرساله على الفور) الذي يتضمّن زوج <source_debug_key, trigger_debug_key> نفسه مثل هذه الإحالة الناجحة المستندة إلى ملف تعريف الارتباط.

لنفترض أنّك تلقّيت تقرير تصحيح أخطاء بنجاح لـ 70 من الإحالات الناجحة الناتجة عن ملفات تعريف الارتباط هذه.

  • تشير تقارير النجاح إلى أنّه تم تسجيل عملية الإحالة بنجاح، لذا يمكنك افتراض أنّك ستتلقّى تقرير إحالة يتوافق مع كل تقرير نجاح، مع بعض الاستثناءات.
  • ويمكنك اختيار مراقبة هذه الاستثناءات. ولإجراء ذلك، أثناء إرسال تقارير تحديد المصدر إلى نقطة النهاية خلال الأيام أو الأسابيع المقبلة (حسب تاريخ انتهاء الصلاحية)، ابحث عن تقارير تحديد المصدر التي تحتوي على مفتاحَي تصحيح الأخطاء نفسهما الواردَين في كل تقرير تصحيح أخطاء ناجح. يُرجى الانتظار قليلاً، فقد لا يتم إرسال التقارير على الفور في نهاية كل فترة. لنفترض أنّك عثرت على 60 تقريرًا فقط عن تحديد المصدر. قد يرجع سبب عدم توفّر تقارير تحديد المصدر العشرة إلى سلوك المستخدِم.

الخطوة 3: تقييم موجز للخسارة

100-70 = 30 تقرير تصحيح أخطاء ناجحًا غير متوفّر. وهذا يعني أنّه لم يتم تسجيل هذه الإحالات الناجحة الثلاثين (التي تم تتبُّعها في عملية التنفيذ المستندة إلى ملفات تعريف الارتباط) باستخدام تقارير تحديد المصدر. ولن تتلقّى تقارير تحديد المصدر لهذه الإحالات.

بما أنّ لديك 100 إحالة ناجحة مستندة إلى ملفّات تعريف الارتباط و70 إحالة ناجحة مستندة إلى عملية تحديد المصدر فقط، فإنّ نسبة الخسارة تبلغ %30. لديك الآن تقييم موجز للخسارة.

الخطوة 4: تحليل الأسباب

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

  • لنفترض أنّ هناك 10 مفاتيح لا يتوفّر لها تقرير تصحيح أخطاء مفصّل. تحقّق مما إذا كانت هناك أي مشكلة في الدمج. وإذا لم يكن الأمر كذلك، قد يرجع ذلك إلى سلوك المستخدم.
  • لديك 20 تقريرًا مفصّلاً عن تصحيح الأخطاء. يمكنك الآن تحسين تحليل الخسائر. حلِّل حقل type في كل تقرير مفصّل. على سبيل المثال، قد تلاحظ ما يلي:
    • لا تتوفّر 10 تقارير (=% 10 في مثالنا) بسبب pending destination limit
    • لا يتوفّر 5 تقارير (‎= 5%) بسبب trigger-aggregate-no-contributions.
    • لا يتوفّر 5 تقارير (‎= 5%) بسبب unknown-error.

الخطوة 5: اتّخاذ الإجراءات وتحديد المشاكل وحلّها

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

يعتمد الإجراء الذي يجب اتّخاذه على type لكل تقرير مفصّل. راجِع مرجع التقارير التفصيلية للاطّلاع على التفاصيل. على سبيل المثال:

  • pending-destination-limit هي ميزة حماية الخصوصية. ليس عليك اتّخاذ أي إجراء. استخدِم هذا الرقم كنقطة بيانات لمراقبة مستوى ظهور موقعك الإلكتروني.
  • قد يشير الرمز trigger-aggregate-no-contributions إلى مشكلة في التنفيذ من جانبك. تحليل ذلك بشكل أكبر استخدِم التفاصيل الواردة في نص التقرير التفصيلي لتحديد المشاكل وحلّها إذا لزم الأمر.
  • قد يشير الرمز unknown-error إلى خطأ في المتصفّح أو في الشبكة. إذا تكرّرت هذه المشكلة، يُرجى إبلاغ مطوّري المتصفّح بها.