التحقّق من صحة التنفيذ

بعد التحقّق من صحة الأحداث، عليك التحقّق من صحة عملية التنفيذ. يتأكّد خادم التحقّق من صحة البيانات من أنّ أحداثك تتضمّن البنية الصحيحة، ولكن للتأكّد من أنّه يتم إرسالها بشكل صحيح إلى موقعك، عليك اتّباع الخطوات التالية:

إذا لم تظهر لك أحداثك بعد اتّباع هذه الخطوات، راجِع تحديد المشاكل وحلّها لمعرفة أخطاء التنفيذ الشائعة.

إرسال حدث من عميل

اختَر عميلك:

لكي يكون الحدث صالحًا، يجب أن يتضمّن app_instance_id تم استخدامه من قبل لإرسال حدث من ‫SDK "إحصاءات Google لـ Firebase"‬. سجِّل هذا المعرّف من جهة العميل، وأدرِجه في طلبك إلى Measurement Protocol. في إرسال حدث إلى موقعك، نستخدم "app_instance_id" كـ app_instance_id. عليك استبدال ذلك بـ app_instance_id حقيقي وارد من حزمة تطوير البرامج (SDK). راجِع مقالة هل تستخدم app_instance_id الصحيح؟ لمعرفة كيفية التأكّد من أنّك تستخدم قيمة صالحة.

إرسال حدث إلى موقعك

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

على سبيل المثال، يرسل ما يلي حدث ردّ الأموال:

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

fetch(`https://www.google-analytics.com/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",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "value": "9.99",
        "transaction_id": "ABC-123"
      }
    }]
  })
});

الاطّلاع على "العرض في الوقت الفعلي"

بعد إرسال حدث باستخدام Measurement Protocol، راجِع "عرض الوقت الفعلي" لموقعك. تظهر الأحداث عادةً في غضون بضع ثوانٍ.

انتقِل إلى عرض "الوقت الفعلي" من خلال فتح إحصاءات Google، ثم الانتقال إلى التقارير > الوقت الفعلي في شريط التنقّل الأيمن. عليك التركيز على الرسوم البيانية في الأسفل، مثل "عدد الأحداث حسب اسم الحدث" و"الأحداث الرئيسية حسب اسم الحدث".

طريقة العرض في الوقت الفعلي التي تعرض حدثًا

التحقّق من DebugView

إذا لم يوفّر عرض "الوقت الفعلي" تفاصيل كافية للتحقّق من عملية التنفيذ، فعِّل وضع تصحيح الأخطاء في بعض الأحداث التجريبية من خلال تضمين المَعلمات التالية في عملية جمع البيانات params حتى تتمكّن من مراقبة الأحداث ومراجعتها في DebugView:

  1. "debug_mode": true أو "debug_mode": 1
  2. يتم ضبط "engagement_time_msec" على رقم موجب

على سبيل المثال، يرسل ما يلي ردّ أموال مع تفعيل وضع تصحيح الأخطاء:

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

fetch(`https://www.google-analytics.com/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",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "value": "9.99",
        "transaction_id": "ABC-123",
        "engagement_time_msec": 1200,
        "debug_mode": true
      }
    }]
  })
});

بعد إرسال الأحداث مع تفعيل وضع تصحيح الأخطاء، اتّبِع التعليمات الخاصة برصد الأحداث باستخدام DebugView للتحقّق من عملية التنفيذ.