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

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

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

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

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

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

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

تتشابه جميع حقول الطلب الأخرى.

ننصحك باتّباع الأسلوب التالي للتحقّق من الصحة:

• استخدِم عمليات تحقّق صارمة من صحة البيانات أثناء التطوير باستخدام أحد الخيارَين التاليَين:
  • التحقّق من صحة الطلبات باستخدام أداة إنشاء الأحداث
  • أرسِل الطلبات إلى خادم التحقّق مع ضبط validation_behavior على ENFORCE_RECOMMENDATIONS.
• في مرحلة الإنتاج، أرسِل الطلبات بدون ضبط validation_behavior للحدّ من البيانات التي يرفضها Measurement Protocol.

مثال على حدث غير صالح

يعرض الرمز التالي حدثًا غير صالح يتم إرساله إلى خادم التحقّق من الصحة في Measurement Protocol:

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

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

مثال على حدث صالح

يعرض الرمز التالي حدثًا صالحًا يتم إرساله إلى خادم التحقّق من صحة Measurement Protocol. سيؤدي هذا الطلب إلى عرض مصفوفة validationMessages فارغة في الردّ، كما هو موضّح في قسم ردّ التحقّق من الصحة.

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    app_instance_id: "APP_INSTANCE_ID",
    validation_behavior: "ENFORCE_RECOMMENDATIONS",
    events: [{
      name: "level_up",
      params: {
        level: 2,
        character: "MyHero"
      },
    }]
  })
});

رد التحقّق

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

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

في ما يلي استجابة خادم التحقّق لطلب لا يتضمّن أي مشاكل في التحقّق:

{
  "validationMessages": []
}

الردّ

ValidationMessage

ValidationCode