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

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

Firebase gtag.js

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

تنبيه: لا يتحقق خادم التحقق من صحة api_secret أو قم بمراجعة هذه القيم بعناية يُرجى التأكّد من أنّها صحيحة.

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

يوضِّح هذا الدليل كيفية إرسال الأحداث إلى Measurement Protocol في Google. خادم التحقق من "إحصاءات 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	المصفوفة<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	تم تقديم الاسم نفسه أكثر من مرة في الطلب.