التحقق من الأحداث

نظرة عامة

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

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

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

ملاحظة مهمة: لن تظهر الأحداث التي تم إرسالها إلى خادم التحقّق في التقارير.

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

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

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

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

يعرض الرمز التالي حدثًا غير صالح يتم إرساله إلى خادم Measurement Protocol.

Firebase gtag.js

ردّ التحقق

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

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

الإجابة

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

رسالة التحقّق

المفتاح	النوع	الوصف
fieldPath	سلسلة	المسار إلى الحقل غير الصالح.
description	سلسلة	وصف للخطأ.
validationCode	رمز التحقّق	رمز التحقّق الذي يتوافق مع الخطأ.

رمز التحقق

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