تحقّق من هذا قبل أن تظهر بياناتك في Appnaly

يقرأ Appnaly بيانات Google Analytics الموجودة لديك بالفعل. تأكّد أولًا من أن تطبيقك يرسل بيانات فعليًا إلى Firebase Analytics.

كيف تصل بياناتك إلى Appnaly

  1. تطبيقك
  2. Firebase Analytics
  3. Google Analytics (GA4)
  4. Appnaly

يقع Appnaly في نهاية هذه السلسلة. وإذا تعطّلت خطوة قبله فلن يجد ما يقرأه.

أربعة أمور فقط للتحقّق منها

  • هل Google Analytics مُفعَّل في مشروع Firebase الخاص بك؟
  • هل حزمة Firebase Analytics SDK مُدمجة في تطبيقك؟
  • هل ترى مستخدمين أو أحداثًا حقيقية في Google Analytics؟
  • هل يستطيع حساب Google الذي ربطته بـ Appnaly رؤية خاصية Analytics تلك؟

1. تحقّق من Google Analytics داخل Firebase

افتح في وحدة تحكّم Firebase المشروع الذي تريد تحليله، ثم انتقل إلى إعدادات المشروع ← عمليات الدمج ← Google Analytics. تأكّد من أنه مُفعَّل ومرتبط بخاصية GA4. وإذا كان مُعطَّلًا، فعّله من هناك.

لا يستطيع Appnaly إنشاء هذه البيانات نيابة عنك. يجب أن يكون مشروع Firebase مرتبطًا بـ GA4 أولًا.

فتح وحدة تحكّم Firebase

2. تأكّد من أن تطبيقك يجمع البيانات

ربط Firebase بـ GA4 وحده لا ينتج بيانات استخدام. يجب أيضًا أن تكون حزمة Firebase Analytics SDK مُعدّة بشكل صحيح داخل التطبيق نفسه.

  • مشروع Firebase مرتبط بتطبيق Flutter الخاص بك
  • تم إعداد firebase_core
  • تمت إضافة firebase_analytics ويجري استخدامه
  • تُنفَّذ Firebase.initializeApp() فعليًا عند بدء التشغيل
  • ملفات إعداد Firebase لنظامي Android وiOS في مكانها

3. تأكّد من وصول البيانات فعلًا

قبل النظر في Appnaly، تأكّد من ظهور البيانات في Firebase أو Google Analytics. انتقل إلى وحدة تحكّم Firebase ← Analytics ← الوقت الفعلي، أو استخدم DebugView أثناء التطوير. شغّل تطبيقك، وتنقّل بين الشاشات أو أطلق حدثًا، ثم راقب ظهور مستخدم مباشر أو حدث.

إذا لم تظهر البيانات في Firebase أو GA4، فلن تظهر في Appnaly أيضًا.

فتح Google Analytics

4. تحقّق من مصدر بيانات تطبيقك

في Google Analytics، انتقل إلى الإدارة ← مصادر البيانات وتأكّد من إدراج تطبيقك. من مصادر البيانات هذه يبني Appnaly قائمة التطبيقات التي يمكنك الاختيار منها.

مثال

  • MotionFitiOScom.example.motionfit
  • MotionFitAndroidcom.example.motionfit

أسماء مُختلَقة، وليست تطبيقاتك.

5. اتصل بحساب Google الصحيح

لا يعرض Appnaly سوى خصائص Google Analytics التي يُسمح لحساب Google المتصل بقراءتها. وقد لا تظهر تطبيقاتك في الحالات التالية.

  • تتم إدارة Analytics بحساب Google آخر
  • الحساب الحالي لا يملك صلاحية على خاصية GA4 تلك
  • مشروع Firebase غير مرتبط بـ GA4

تحقّق أولًا مما إذا كان الحساب المسجَّل دخوله في وحدة تحكّم Firebase هو نفسه الذي تربط به Analytics في Appnaly — أو على الأقل حسابًا يملك صلاحية قراءة خاصية GA4 تلك.

إذا وصلت إلى هنا فأنت جاهز

  • مشروع Firebase مرتبط بـ GA4
  • حزمة Analytics SDK في التطبيق تعمل
  • البيانات ظاهرة في الوقت الفعلي أو في DebugView
  • مصدر بيانات GA4 موجود
  • حساب Google الخاص بك يستطيع قراءته

مشكلات شائعة

لا أرى أي تطبيق في Appnaly.

تحقّق أولًا من ثلاثة أمور: هل سجّلت الدخول بحساب Google مختلف، وهل يستطيع ذلك الحساب قراءة خاصية GA4، وهل Firebase مرتبط بـ GA4 أصلًا.

التطبيق يظهر لكن عدد المستخدمين صفر.

راجع أولًا الوقت الفعلي في Firebase أو Google Analytics. فإذا لم تكن لدى GA4 نفسه بيانات، فلن تكون لدى Appnaly كذلك.

التطبيق موجود في Firebase لكنه غير موجود في Appnaly.

تحقّق مما إذا كان مشروع Firebase مرتبطًا بخاصية GA4 في Google Analytics.

هل عليّ تفعيل واجهة برمجية في Google Cloud؟

لا. لست بحاجة إلى تفعيل Google Analytics Admin API ولا Google Analytics Data API في مشروعك الخاص. يتولّى Appnaly جانب الواجهات البرمجية على خادمه.

البيانات لا تظهر على الفور.

تعالج Google أرقام الوقت الفعلي وتقارير GA4 النهائية وفق جدولين مختلفين، لذا قد يتأخّر أحدهما عن الآخر. ولا يختلق Appnaly أرقامًا لسدّ هذه الفجوة.