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

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

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

ويمكنك استدعاء خادم التحقق من الصحة مباشرةً أو استخدام إحصاءات 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. خادم التحقق من الصحة:

const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      // Event names must start with an alphabetic character.
      name: '_badEventName',
      params: {},
    }]
  })
});

رد التحقق من الصحة

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

{
  "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 تم تقديم الاسم نفسه أكثر من مرة في الطلب.