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

اختيار المنصّة:

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

يمكنك طلب خادم التحقّق مباشرةً، أو استخدام أداة إنشاء الأحداث في "إحصاءات Google 4". تتيح لك "أداة إنشاء الأحداث" في "إحصاءات Google 4" إنشاء أحداث بشكل تفاعلي، واستخدام خادم التحقّق من صحة 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 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 تم تقديم الاسم نفسه أكثر من مرة في الطلب.