التحقق من صحة النتائج - Measurement Protocol

يصف هذا المستند كيفية التحقق من صحة نتائج بروتوكول القياس في "إحصاءات Google".

نظرة عامة

لا يعرض Measurement Protocol في "إحصاءات Google" رموز أخطاء HTTP، حتى إذا كانت نتيجة Measurement Protocol مكتوبة بشكلٍ غير صحيح أو تفتقد إلى المعلَمات المطلوبة. لضمان تنسيق النتائج بشكلٍ صحيح ومن أنّها تحتوي على جميع المَعلمات المطلوبة، يمكنك اختبارها مقارنةً بخادم التحقّق من الصحة قبل نشرها في مرحلة الإنتاج.

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

تستخدم أداة إنشاء نتائج Measurement Protocol، وهي أداة تسمح لك بإنشاء نتائج Measurement Protocol والتحقّق منها بشكل تفاعلي، خادم التحقق هذا.

إرسال النتائج للتحقّق من صحتها

يمكن إرسال النتائج إلى خادم التحقّق من صحة Measurement Protocol عبر أي طريقة متاحة حاليًا في Measurement Protocol. الاختلاف الوحيد هو عنوان URL. لإرسال النتائج إلى خادم التحقّق من صحة Measurement Protocol، استخدِم نقطة النهاية /debug/collect بدلاً من /collect. يوضح المثال التالي نتيجة غير صالحة تم إرسالها إلى خادم التحقق من صحة Measurement Protocol:

https://www.google-analytics.com/debug/collect?tid=fake&v=1

ولمزيد من التفاصيل عن كيفية إنشاء نتيجة Measurement Protocol، يُرجى الاطّلاع على مرجع البروتوكول.

ملاحظة مهمة: لن تظهر النتائج المُرسَلة إلى خادم التحقّق من صحة Measurement Protocol في التقارير. وهي تُستخدم لتصحيح الأخطاء فقط.

تفسير الرد

وستكون الردود من خادم التحقُّق من صحة Measurement Protocol بتنسيق JSON. يوضّح المثال التالي الرد على النتيجة الموضحة أعلاه:

{
  "hitParsingResult": [
    {
      "valid": false,
      "hit": "GET /debug/collect?tid=fake\u0026v=1 HTTP/1.1",
      "parserMessage": [
        {
          "messageType": "ERROR",
          "description": "The value provided for parameter 'tid' is invalid. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        },
        {
          "messageType": "ERROR",
          "description": "Tracking Id is a required field for this hit. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        }
      ]
    }
  ]
}

جذر الاستجابة hitParsingResult هو صفيف يتوافق طوله مع عدد النتائج المُرسَلة في الطلب الأصلي. سيحتوي كل كائن في المصفوفة على المفاتيح valid وhit وparserMessage. إذا كانت النتيجة غير صالحة، سيحتوي العنصر parserMessage على مجموعة من العناصر التي تصف مشاكل التحقّق من الصحة. إذا كانت النتيجة صالحة، سيكون parserMessage مصفوفة فارغة.

يوضّح الجدول التالي خصائص كل عنصر في مصفوفة hitParsingResult:

المفتاح	النوع	الوصف
valid	Boolean	true للنتائج الصالحة، وfalse للنتائج غير الصالحة.
hit	string	سلسلة تحتوي على مسار الطلب بالإضافة إلى طريقته وبروتوكوله
parserMessage	Array	قائمة برسائل المحلل. وإذا كانت النتيجة صالحة، ستكون هذه الصفيفة فارغة.
parserMessage.messageType	string	القيم المحتملة هي "INFO" و"WARN" و "ERROR".
parserMessage.description	string	تفاصيل أو خطوات إضافية لحلّ مشكلة التحقّق من الصحة
parserMessage.parameter	string|undefined	تشير هذه السمة إلى المَعلمة (إن وُجدت) التي تسبب مشكلة التحقّق من الصحة.