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

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

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

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

• The reporting origin is the origin that sets the Attribution Reporting source and trigger headers. All reports generated by the browser are sent to this origin. In this guidance, we use https://adtech.example as the example reporting origin.
• An attribution report (report for short) is the final report (event-level or aggregatable) that contains the measurement data you've requested.
• A debug report contains additional data about an attribution report, or about a source or trigger event. Receiving a debug report does not necessarily mean that something is working incorrectly! There are two types of debug reports
• A transitional debug report is a debug report that requires a cookie to be set in order to be generated and sent. Transitional debug reports will be unavailable if a cookie is not set, and once third-party cookies are deprecated. All debug reports described in this guide are transitional debug reports.
• Success debug reports track successful generation of an attribution report. They relate directly to an attribution report. Success debug reports have been available since Chrome 101 (April 2022).
• Verbose debug reports can track missing reports and help you determine why they're missing. They indicate cases where the browser did not record a source or trigger event, (which means it will not generate an attribution report), and cases where an attribution report can't be generated or sent for some reason. Verbose debug reports include a type field that describes the reason why a source event, trigger event or attribution report was not generated. Verbose debug reports are available starting in Chrome 109 (Stable in January 2023).
• Debug keys are unique identifiers you can set on both the source side and the trigger side. Debug keys enable you to map cookie-based conversions and attribution-based conversions. When you've set up your system to generate debug reports and set debug keys, the browser will include these debug keys in all attribution reports and debug reports.

For more concepts and key terms used throughout our documentation, refer to the Privacy Sandbox glossary.

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

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

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

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

نظرة عامة

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

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

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

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

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

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

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

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

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

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

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

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

تقرير تصحيح الأخطاء المطوَّل من النوع 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 تقرير تصحيح أخطاء ناجحًا غير متوفّر. وهذا يعني أنّه لم يتم تسجيل هذه الإحالات الناجحة الـ 30 (التي تم تتبُّعها في عملية التنفيذ المستندة إلى ملفات تعريف الارتباط) باستخدام واجهة برمجة التطبيقات Attribution Reporting. لن تتلقّى تقارير تحديد المصدر لهذه الأحداث.

بما أنّ لديك 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 إلى خطأ في المتصفّح أو الشبكة. إذا تكرّرت هذه المشكلة، يُرجى الإبلاغ عن خطأ لمطوّري المتصفّح.