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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

لا توجد أحداث

إذا لم تظهر أحداثك في "إحصاءات 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. يحدِّد هذا المعرّف بشكل فريد مثيل مستخدم معيّن لأحد عملاء الويب. ستكون هذه القيمة مختلفة لكل مستخدم من مستخدمي تطبيقك. اطّلِع على هذه الأمثلة لمعرفة كيفية استرداد هذه القيمة.

عدم توفّر أحداث وضع العلامات من جهة الخادم

يتيح لك تثبيت أداة "إدارة العلامات من Google" من جهة الخادم باستخدام مزوّد Measurement Protocol إرسال الأحداث بتنسيق Measurement Protocol إلى حاويات. بعد ذلك، تُرسِل الحاوية هذه الأحداث إلى "إحصاءات Google" باستخدام الآلية نفسها المستخدَمة في جميع أحداث أداة "إدارة العلامات من Google" الأخرى.

إذا كنت تريد جميع ميزات Measurement Protocol، أرسِل الأحداث مباشرةً إلى Measurement Protocol بدلاً من الحاوية.