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

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

لا يعرض 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

وتبقى جميع حقول الطلبات الأخرى كما هي. اطّلِع على مرجع بروتوكول للحصول على مزيد من المعلومات حول إنشاء طلب صالح.

يعرض الرمز التالي حدثًا غير صالح يتم إرساله إلى خادم التحقّق في 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 تم تقديم الاسم نفسه أكثر من مرة في الطلب.