التحقّق من صحة الأحداث

اختَر النظام الأساسي:

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

يمكنك إما استدعاء خادم التحقّق من الصحة مباشرةً، أو استخدام أداة إنشاء الأحداث في "إحصاءات Google". يتيح لك "منشئ الأحداث" في "إحصاءات Google" إنشاء الأحداث بشكل تفاعلي، ويستخدم خادم التحقّق من صحة Measurement Protocol للتحقّق من صحتها.

يوضّح هذا الدليل كيفية إرسال الأحداث إلى خادم التحقّق من الصحة في Measurement Protocol لخدمة "إحصاءات Google‏ 4" وكيفية تفسير الردّ.

إرسال الأحداث للتحقّق من صحتها

الفرق الوحيد بين طلب الأحداث المُرسَلة إلى Measurement Protocol وخادم التحقّق من الصلاحية في Measurement Protocol هو عنوان URL.

الخادم عنوان URL
Measurement Protocol /mp/collect
خادم التحقّق من الصلاحية في Measurement Protocol /debug/mp/collect

تتشابه جميع حقول الطلب الأخرى.

ننصحك باتّباع الأسلوب التالي للتحقّق من الصحة:

  • استخدِم عمليات تحقّق صارمة من صحة البيانات أثناء التطوير باستخدام أحد الخيارَين التاليَين:
    • التحقّق من صحة الطلبات باستخدام أداة إنشاء الأحداث
    • أرسِل الطلبات إلى خادم التحقّق مع ضبط قيمة validation_behavior على ENFORCE_RECOMMENDATIONS.
  • في مرحلة الإنتاج، أرسِل الطلبات بدون ضبط validation_behavior لتقليل البيانات التي يرفضها Measurement Protocol.

يعرض الرمز التالي حدثًا غير صالح يتم إرساله إلى خادم التحقّق من الصحة في Measurement Protocol:

رد التحقّق

إليك استجابة خادم التحقّق من الصلاحية للحدث السابق:

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

في ما يلي استجابة خادم التحقّق لطلب لا يتضمّن أي مشاكل في التحقّق:

{
  "validationMessages": []
}

الردّ

المفتاح النوع الوصف
validationMessages Array<ValidationMessage> مصفوفة من رسائل التحقّق.

ValidationMessage

المفتاح النوع الوصف
fieldPath سلسلة مسار الحقل الذي كان غير صالح.
description سلسلة تمثّل هذه السمة وصفًا للخطأ.
validationCode ValidationCode رمز التحقّق الذي يتوافق مع الخطأ

ValidationCode

القيمة الوصف
VALUE_INVALID القيمة المقدَّمة لـ fieldPath غير صالحة. يُرجى الاطّلاع على القيود.
VALUE_REQUIRED لم يتم تقديم قيمة مطلوبة لـ fieldPath.
NAME_INVALID الاسم الذي تم تقديمه غير صالح. يُرجى الاطّلاع على القيود.
NAME_RESERVED الاسم المقدَّم هو أحد الأسماء المحجوزة. يُرجى الاطّلاع على الأسماء المحجوزة.
VALUE_OUT_OF_BOUNDS القيمة المُدخَلة كبيرة جدًا. يُرجى الاطّلاع على القيود.
EXCEEDED_MAX_ENTITIES كان هناك عدد كبير جدًا من المَعلمات في الطلب. يُرجى الاطّلاع على القيود.
NAME_DUPLICATED تم تقديم الاسم نفسه أكثر من مرة في الطلب.