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

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

لا توجد أحداث

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

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

• هل تستخدِم 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.

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

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

  firebase_app_id يختلف عن app_instance_id.

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

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

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

  app_instance_id يختلف عن firebase_app_id.

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

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

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

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

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