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

يوضّح هذا الدليل الخطوات الشائعة لتحديد المشاكل وحلّها لمعالجة أخطاء التنفيذ الشائعة.

لا توجد أحداث

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

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

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

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

• هل 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 Protocol يتيح استخدام المعرّفات من حزمة تطوير البرامج (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. ويُستخدَم هذا الإجراء للمهام، مثل رسائل FCM.

gtag.js

إذا كنت تستخدِم gtag.js، يجب استخدام المعرّفات التالية:

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