تحديد المشاكل وحلّها

يوضح هذا الدليل الخطوات الشائعة لاستكشاف الأخطاء وإصلاحها لإصلاح أخطاء التنفيذ الشائعة.

No events

إذا كانت أحداثك لا تظهر في "إحصاءات Google"، هناك بعض المشاكل الشائعة التي يجب البحث عنها.

اختَر عميلك أولاً:

Firebase gtag.js

• هل تستخدم api_secret الصحيح؟

  تأكَّد من استخدام api_secret للبث الصحيح. في حال إعداد Measurement Protocol لأحداث بث متعددة، سيكون لكل بث سري خاص به.

• هل api_secret لا تزال صالحة؟

  للمساعدة في مكافحة المحتوى غير المرغوب فيه، يمكنك إبطال api_secret. تأكَّد من أنّ قيمة api_secret التي تستخدمها لا تزال صالحة. من المحتمل أن يكون مستخدم آخر لديه إمكانية الوصول إلى البث قد أبطل إمكانية الوصول إليه عن طريق الخطأ.

• هل تم نسخ api_secret بشكل صحيح؟

  api_secret حسّاس لحالة الأحرف. تأكّد مرّة أخرى من أنّ عنصر api_secret في واجهة مستخدم "إحصاءات Google" يتطابق تمامًا مع العنوان الذي تستخدمه في الترميز.

• لا تستخدِم advertising_id.

  القيمة advertising_id غير متوافقة كمعرّف جهاز صالح. استخدِم app_instance_id إذا كنت تستخدم Firebase وclient_id إذا كنت تستخدم gtag.js.

المعرّفات غير الصالحة

بما أنّ Measurement Procotol يتوافق مع أرقام التعريف من حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase" وgtag.js، تأكّد من استخدام رقم التعريف الصحيح. تتغير أرقام التعريف التي عليك استخدامها بناءً على ما إذا كنت تستخدم حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase" أو gtag.js. ويوضّح ما يلي أرقام التعريف التي يجب استخدامها:

حزمة تطوير البرامج (SDK) الخاصة بإصدار "إحصاءات Google لبرنامج Firebase"

إذا كنت تستخدِم حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase"، تكون أرقام التعريف التي عليك استخدامها:

• firebase_app_id: تضمين هذا المعرّف في مَعلمات طلب البحث للطلب يُعرِّف هذا المعرّف تطبيقك في Firebase بشكل فريد. سيكون لدى جميع مستخدمي تطبيقك القيمة firebase_app_id نفسها. يمكن العثور عليها في وحدة تحكُّم Firebase ضمن:
  إعدادات المشروع > الإعدادات العامة > تطبيقاتك > رقم تعريف التطبيق

• app_instance_id: أدرِج هذا المعرّف في نص POST الخاص بالطلب. يحدِّد رقم التعريف هذا عملية تثبيت معيّنة لتطبيق Firebase بشكلٍ فريد. وستختلف هذه القيمة لكل عملية تثبيت لتطبيقك. وفي ما يلي طرق طلب هذه القيمة لكل نظام أساسي لمنصة Firebase:

  • Android: getAppInstanceId()
  • Kotlin: getAppInstanceId()
  • Swift: appInstanceID()
  • Objective-C - appInstanceID
  • C++ - GetAnalyticsInstanceId()
  • Unity - GetAnalyticsInstanceIdAsync()

يجب عدم استخدام ما يلي:

• firebase_instance_id: يجب عدم تضمين هذا المعرّف في طلبك. يُستخدم رقم التعريف هذا لتحديد مثيل معيّن من التطبيق، ولكنه خاص بمنصة Firebase. ويتم استخدامه لمهام مثل رسائل "المراسلة عبر السحابة الإلكترونية من Firebase".

gtag.js

في حال استخدام gtag.js، تكون أرقام التعريف التي عليك استخدامها هي:

• measurement_id: تضمين هذا المعرّف في مَعلمات طلب البحث للطلب ويُعرِّف رقم التعريف هذا مصدر البيانات بشكلٍ فريد. سيحصل جميع مستخدمي موقعك الإلكتروني على سمة measurement_id نفسها يمكن العثور عليها في واجهة مستخدم "إحصاءات Google" ضمن:
  المشرف > مصادر البيانات > اختيار مصدر بياناتك > رقم تعريف القياس
• client_id: أدرِج هذا المعرّف في نص POST الخاص بالطلب. ويحدد هذا المعرّف بشكلٍ فريد مثيل مستخدم معيّن من عميل الويب. ستختلف هذه القيمة لكل مستخدم للتطبيق. يمكنك الاطّلاع على هذه الأمثلة حول كيفية استرداد هذه القيمة.