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

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

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

اختر عميلك:

ولكي يكون الحدث صالحًا، يجب أن يحتوي على 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.

على سبيل المثال، يتمّ إرسال حدث refund في ما يلي:

const firebaseAppId = `<firebase_app_id_value>`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  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_value>`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  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 للتحقّق من صحة عملية التنفيذ