تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

في هذا الدليل، ستجد تعليمات حول كيفية استخدام تقارير تصحيح الأخطاء لحالات الاستخدام المختلفة الموضّحة في الجزء 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.

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

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

ملاحظة: إذا كان type في التقرير التفصيلي يبدأ بالرمز trigger-event، لا يمكن إنشاؤه إلا للأحداث المصدر أو المشغِّلة المرتبطة بالتقارير على مستوى الحدث. إذا كان type في التقرير التفصيلي يبدأ بالرمز trigger-aggregate، لا يمكن إنشاؤه إلا للأحداث المصدر أو المشغِّلة المرتبطة بالتقارير القابلة للتجميع. وفي جميع الحالات الأخرى، يكون ذلك على مستوى الحدث أو لتقرير قابل للتجميع.

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

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

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 تقريرًا فقط عن تحديد المصدر. قد يرجع سبب عدم توفّر تقارير تحديد المصدر العشرة إلى سلوك المستخدِم.

ملاحظة: من المحتمل أن يكون لديك تقارير تحديد مصدر على مستوى الحدث لا ترتبط بإحالة ناجحة مستندة إلى ملفّ تعريف ارتباط. من المرجّح أن تكون هذه تقارير غير مفيدة تم إنشاؤها عشوائيًا من خلال واجهة برمجة التطبيقات. يمكنك التأكّد من ذلك من خلال البحث عن تقارير تصحيح الأخطاء التفصيلية من النوع source-noised التي تحتوي على مفتاح تصحيح أخطاء المصدر نفسه الوارد في تقرير مستوى الحدث.

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