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

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

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

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

اختَر عميلك:

لكي يكون الحدث صالحًا، يجب أن يتضمّن 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 للتأكّد من عملية التنفيذ.