يصف هذا المستند كيفية تصحيح الأخطاء واستكشاف أخطاء مكون Google Analytics الإضافي لـ Unity.
تصحيح الأخطاء واستكشاف الأخطاء وإصلاحها
إذا اتّبعت دليل المطوّر ولم تظهر لك أي بيانات في تقارير "إحصاءات Google"، راجِع الاقتراحات والاعتبارات التالية:
- قد يستغرِق بدء إعداد تقارير البيانات في "إحصاءات Google" فترةً تتراوح بين 24 و48 ساعة. إذا تأكّدت من صحة عملية التنفيذ، انتظر لمدة 48 ساعة على الأقل لتحديد ما إذا كان هذا التأخير هو سبب عدم ظهور أي بيانات.
- يسمح لك إعداد التقارير في الوقت الفعلي بمراقبة النشاط أثناء حدوثه على موقعك الإلكتروني أو تطبيقك. ويمكن استخدام ذلك للتأكد سريعًا من وصول النتائج. تجدر الإشارة إلى أنه يتم أحيانًا تعليق إعداد التقارير في الوقت الفعلي بشكلٍ مؤقت في الملفات الشخصية التي لم تصل إليها مؤخرًا، ولكن تتم إعادة تفعيل "الوقت الفعلي" بعد الانتقال إلى تقرير الوقت الفعلي في ذلك الملف الشخصي. لمزيد من التفاصيل، اطّلِع على مقالة المساعدة في الوقت الفعلي.
- اضبط مستوى السجلّ على
VERBOSE
للحصول على معلومات إضافية عن المَعلمات الناقصة أو المشاكل الأخرى التي قد تمنع إرسال نتائجك. انقر على GAv4 في التسلسل الهرمي للألعاب، ثم اختَر مستوى السجلّ في القائمة المنسدلة.
- تأكَّد من أنّك ضبطت الإعدادات المسبقة بشكل صحيح. من المهم أن يكون لديك رقم تعريف الموقع/التتبُّع واسم التطبيق الصحيحَين. تأكّد من أنك تطّلِع على تقارير الموقع المقابل.
- تأكَّد من ضبط فترة الإرسال على قيمة معقولة. وعند ضبطها على صفر أو قيمة سالبة، سيؤدي ذلك إلى إيقاف إرسال النتائج تمامًا، في حين ستمنع القيمة الكبيرة من عرض النتائج في التقارير في الوقت الفعلي (ستظل قابلة للعرض في التقارير الأخرى). القيمة التلقائية للمكون الإضافي هي 5 ثوانٍ.
- على أجهزة Android التي تم تثبيت "خدمات Google Play" عليها، يتم تفعيل الإرسال التلقائي ولا يكون الإرسال اليدوي متاحًا. راجِع مستند Android Dispatch للحصول على تفاصيل إضافية.
- تأكَّد من إزالة العلامة من علامة التشغيل التجريبي. هذه العلامة معدّة لاختبار لعبتك، وفي حال وضع علامة عليها، ستمنع إرسال جميع النتائج إلى "إحصاءات Google".
بالنسبة إلى المشاكل العامة المتعلقة بالتكوين والإصدار، يُرجى الاطّلاع على ما يلي:
- قبل استخدام
GoogleAnalyticsV4
في النصوص البرمجية، تأكَّد من أنّه تم إعداد الإعدادات المسبقة وفي التدرّج الهرمي للكائنات. وبخلاف ذلك، قد تظهر علامةNullReferenceException
. - إذا ظهرت لك أخطاء في الروابط عند إنشاء نظام التشغيل iOS، اتّبِع خطوات الإعداد والضبط في iOS لإضافة المكتبات المطلوبة تلقائيًا عند الإنشاء.
- في حال ظهور أخطاء في الأذونات على نظام التشغيل Android، يُرجى اتّباع خطوات إعداد Android وضبطه للتعرّف على كيفية تعديل ملف AndroidManifest.xml.
مراجع إضافية
إذا كنت لا تزال تواجه مشاكل ويتعذّر عليك troubleshoot، يمكنك تجربة ما يلي:
- اطلب المساعدة بشأن Stack Overflow: google-analytics.
- افتح مشكلة إذا كنت تعتقد أن هناك خطأ في المكوّن الإضافي.