الجزء 3 من 3 حول تصحيح أخطاء تقارير تحديد المصدر الاطّلاع على تعليمات حول كيفية استخدام تقارير تصحيح الأخطاء
في كتاب الطبخ هذا، ستجد تعليمات حول كيفية استخدام تقارير تصحيح الأخطاء لحالات الاستخدام المختلفة الموضّحة في الجزء 1: مقدمة إلى تقارير تصحيح الأخطاء.
مسرد المصطلحات
- أصل إعداد التقارير هو المصدر الذي يضبط عنوانَي المصدر والعامل الخاص بإعداد تقارير تحديد المصدر.
ويتم إرسال جميع التقارير التي ينشئها المتصفّح إلى هذا المصدر. في هذه الإرشادات، نستخدم
https://adtech.example
كمثال على مصدر الإبلاغ. - تقرير تحديد المصدر (التقرير باختصار) هو التقرير النهائي (على مستوى الحدث أو القابل للتجميع) الذي يحتوي على بيانات القياس التي طلبتها.
- يحتوي تقرير تصحيح الأخطاء على بيانات إضافية عن تقرير تحديد المصدر أو عن مصدر أو حدث عامل تشغيل. لا يعني تلقّي تقرير تصحيح الأخطاء بالضرورة أنّ شيء ما يعمل بشكل غير صحيح. هناك نوعان من تقارير تصحيح الأخطاء.
- تقرير تصحيح الأخطاء الانتقالي هو تقرير تصحيح أخطاء يتطلّب ضبط ملف تعريف الارتباط حتى يتم إنشاؤه وإرساله. لن تتوفّر تقارير تصحيح الأخطاء الانتقالية في حال عدم ضبط ملف تعريف ارتباط، وعند إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية نهائيًا. إنّ جميع تقارير تصحيح الأخطاء الموضَّحة في هذا الدليل هي تقارير تصحيح أخطاء انتقالية.
- تتتبّع تقارير تصحيح الأخطاء الناجحة إنشاء تقرير تحديد المصدر بنجاح. ترتبط ارتباطًا مباشرًا بتقرير تحديد المصدر. تتوفّر تقارير تصحيح الأخطاء الناجحة منذ إصدار Chrome 101 (نيسان/أبريل 2022).
- بإمكان تقارير تصحيح الأخطاء المطوَّلة تتبُّع التقارير غير المتوفّرة ومساعدتك في تحديد سبب عدم توفّرها. وهي تشير إلى الحالات التي لم يسجِّل فيها المتصفّح مصدرًا أو أدّى إلى بدء حدث، ما يعني أنّه لن ينشئ تقرير تحديد مصدر)، والحالات التي يتعذّر فيها إنشاء تقرير تحديد المصدر أو إرساله لسببٍ ما.
تتضمّن تقارير تصحيح الأخطاء المطوَّلة حقل
type
يصف سبب عدم إنشاء حدث مصدر أو حدث عامل تشغيل أو تقرير تحديد مصدر. تتوفّر تقارير تصحيح الأخطاء المطوَّلة اعتبارًا من الإصدار 109 من Chrome (استقرار في كانون الثاني/يناير 2023). - مفاتيح تصحيح الأخطاء هي معرّفات فريدة يمكنك ضبطها على كل من الجانب المصدر وجانب المشغّل. وتمكّنك مفاتيح تصحيح الأخطاء من ربط الإحالات الناجحة المستندة إلى ملفات تعريف الارتباط والإحالات الناجحة المستندة إلى الإحالة. عند إعداد نظامك لإنشاء تقارير تصحيح الأخطاء وإعداد مفاتيح تصحيح الأخطاء، سيضمِّن المتصفّح مفاتيح تصحيح الأخطاء هذه في جميع تقارير تحديد المصدر وتقارير تصحيح الأخطاء.
لمزيد من المفاهيم والمصطلحات الرئيسية المُستخدَمة في مستنداتنا، يُرجى الرجوع إلى مسرد مصطلحات "مبادرة حماية الخصوصية".
طريقة التنفيذ: التحقّق من عملية الدمج في الوقت الفعلي
- يمكنك إعداد نظامك لإنشاء تقارير تصحيح أخطاء النجاح. اطّلِع على كيفية إجراء ذلك في الجزء 2: إعداد تقارير تصحيح الأخطاء.
- عندما تنشر رمز إعداد تقارير الإحالة، تحقّق في الوقت الفعلي مما إذا كنت تتلقّى بعض تقارير تصحيح أخطاء النجاح على نقطة النهاية الخاصة بك. إذا كان الأمر كذلك، يعني ذلك أنّ إعداد "تقارير تحديد المصدر" يعمل بشكل صحيح.
- لا يتم إرسال تقارير تصحيح الأخطاء الناجحة إلا عند حدوث إحالة ناجحة. بدلاً من ذلك، يمكنك التحقّق من إعداد عملية الدمج بشكلٍ سليم بصرف النظر عن الإحالات الناجحة، أي أنّك تريد التحقّق من تسجيل المصادر بنجاح. لتحقيق ذلك، يمكنك الاعتماد على نجاح تسجيل المصدر تقارير تصحيح الأخطاء المطوَّلة. اطّلِع على كيفية إعدادها في الجزء 2: إعداد تقارير تصحيح الأخطاء.
التعليمات: تحليل الخسارة وتحديد مشاكل الدمج وحلّها
لمقارنة نتائج قياس الإحالات الناجحة المستندة إلى ملفات تعريف الارتباط بتقارير تحديد المصدر، استخدِم مفاتيح تصحيح الأخطاء واربط الإحالات الناجحة لملفات تعريف الارتباط باستخدام تقارير تصحيح الأخطاء. تذكَّر أنّه يتم إرسال تقارير تصحيح الأخطاء فورًا إلى نقطة النهاية.
نظرة عامة
![خطوات تحليل الخسارة](https://developers.google.cn/static/privacy-sandbox/assets/images/steps-a-loss-analysis-92c05fa7a306c.png?authuser=19&hl=ar)
استخدِم مفاتيح تصحيح الأخطاء (زوج واحد <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 تقرير إحالة فقط. قد ترجع تقارير الإحالة العشرة المفقودة إلى سلوك المستخدم.
الخطوة الثالثة: تقييم مختصر للخسارة
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
.
- 10 تقارير (= 10% في المثال) غير متوفّرة بسبب
الخطوة 5: اتّخاذ إجراء وتحديد المشاكل وحلّها
الآن بعد أن فهمت سبب فقدان التقارير، يمكنك اتخاذ إجراء بناءً على هذه الإحصاءات.
يعتمد الإجراء الذي يجب اتخاذه على type
لكل تقرير مطوَّل. راجِع مرجع التقارير المطوّلة للاطّلاع على التفاصيل. مثال:
- يوفّر تطبيق "
pending-destination-limit
" حماية للخصوصية. ما مِن إجراء مطلوب اتّخاذه. يمكنك استخدام هذا الرقم كنقطة بيانات لتتمكّن من الاطّلاع على بياناتك ومراقبتها. - قد يشير الرمز
trigger-aggregate-no-contributions
إلى حدوث مشكلة في التنفيذ من جانبك. تحليل هذا الأمر بشكل أكبر. استخدِم التفاصيل في نص التقرير المطوَّل لتحديد المشاكل وحلّها إذا لزم الأمر. - قد يكون
unknown-error
علامة على وجود خطأ في المتصفح أو خطأ في الشبكة. إذا واجهت هذا الخطأ بشكل متكرّر، يُرجى الإبلاغ عن الخطأ لمطوِّري المتصفِّح.