بدء استخدام "إحصاءات Google"

iOS + Android Web Flutter

يوضح لك هذا Quickstart كيفية إضافة Google Analytics إلى تطبيقك والبدء في تسجيل الأحداث.

يجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجل SDK نوعين أساسيين من المعلومات:

• الأحداث: ما يحدث في تطبيقك ، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
• خصائص المستخدم: السمات التي تحددها لوصف أجزاء من قاعدة المستخدمين ، مثل تفضيلات اللغة أو الموقع الجغرافي.

يقوم برنامج Analytics تلقائيًا بتسجيل بعض الأحداث وخصائص المستخدم ؛ لا تحتاج إلى إضافة أي كود لتمكينهم.

قبل ان تبدأ

أضف Firebase إلى مشروع Android الخاص بك وتأكد من تمكين Google Analytics في مشروع Firebase ، إذا لم تكن قد قمت بذلك بالفعل:

• إذا كنت تنشئ مشروع Firebase جديدًا ، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.

• إذا كنت تستخدم مشروع Firebase حالي لم يتم تمكين Google Analytics فيه ، فانتقل إلى علامة التبويب "التكامل" في settings > إعدادات المشروع لتمكينه.

عند تمكين Google Analytics في مشروعك ، يتم ربط تطبيقات Firebase بتدفقات بيانات Google Analytics.

أضف Analytics SDK إلى تطبيقك

1. في ملف Gradle (على مستوى التطبيق) الوحدة النمطية الخاصة بك (عادةً <project>/<app-module>/build.gradle ) ، أضف التبعية لمكتبة Analytics Android. نوصي باستخدام Firebase Android BoM للتحكم في إصدارات المكتبة.

   Kotlin+KTX

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:32.1.0')
   
       // Add the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx'
   }
   

   باستخدام Firebase Android BoM ، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

   (بديل) أضف تبعيات مكتبة Firebase بدون استخدام BoM

   إذا اخترت عدم استخدام Firebase BoM ، فيجب عليك تحديد كل إصدار من إصدارات مكتبة Firebase في سطر التبعية الخاص بها.

   لاحظ أنه إذا كنت تستخدم مكتبات Firebase متعددة في تطبيقك ، فإننا نوصي بشدة باستخدام BoM لإدارة إصدارات المكتبة ، مما يضمن توافق جميع الإصدارات.

   dependencies {
       // Add the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx:21.3.0'
   }
   

   Java

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:32.1.0')
   
       // Add the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics'
   }
   

   باستخدام Firebase Android BoM ، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

   (بديل) أضف تبعيات مكتبة Firebase بدون استخدام BoM

   إذا اخترت عدم استخدام Firebase BoM ، فيجب عليك تحديد كل إصدار من إصدارات مكتبة Firebase في سطر التبعية الخاص بها.

   لاحظ أنه إذا كنت تستخدم مكتبات Firebase متعددة في تطبيقك ، فإننا نوصي بشدة باستخدام BoM لإدارة إصدارات المكتبة ، مما يضمن توافق جميع الإصدارات.

   dependencies {
       // Add the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics:21.3.0'
   }
   

2. قم بتعريف كائن com.google.firebase.analytics.FirebaseAnalytics أعلى نشاطك:

   Kotlin+KTX

   private lateinit var firebaseAnalytics: FirebaseAnalytics
   MainActivity.kt

   Java

   private FirebaseAnalytics mFirebaseAnalytics;
   MainActivity.java

3. قم بتهيئته في طريقة onCreate() :

   Kotlin+KTX

   // Obtain the FirebaseAnalytics instance.
   firebaseAnalytics = Firebase.analytics
   MainActivity.kt

   Java

   // Obtain the FirebaseAnalytics instance.
   mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
   MainActivity.java

بدء تسجيل الأحداث

بعد إنشاء مثيل FirebaseAnalytics ، يمكنك البدء في تسجيل الأحداث باستخدام طريقة logEvent() .

يوصى بأحداث معينة لجميع التطبيقات ؛ ينصح البعض الآخر لأنواع أعمال أو قطاعات معينة. يجب عليك إرسال الأحداث المقترحة جنبًا إلى جنب مع معلماتها المحددة ، لضمان أقصى قدر من التفاصيل المتاحة في تقاريرك والاستفادة من الميزات وعمليات الدمج المستقبلية عند توفرها. يوضح هذا القسم تسجيل حدث محدد مسبقًا ، لمزيد من المعلومات حول تسجيل الأحداث ، راجع أحداث السجل .

تسجل الشفرة التالية حدث SELECT_CONTENT عندما ينقر المستخدم على عنصر معين في تطبيقك.

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

يمكنك تمكين التسجيل المطول لمراقبة تسجيل الأحداث بواسطة SDK للمساعدة في التحقق من تسجيل الأحداث بشكل صحيح. يتضمن هذا كلاً من الأحداث التي تم تسجيلها تلقائيًا ويدويًا.

يمكنك تمكين التسجيل المطول بسلسلة من أوامر adb :

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

يعرض هذا الأمر الأحداث الخاصة بك في Android Studio logcat ، مما يساعدك على التحقق فورًا من إرسال الأحداث.

الخطوات التالية

• استخدم DebugView للتحقق من الأحداث الخاصة بك.
• استكشف بياناتك في وحدة تحكم Firebase.
• استكشف أدلة الأحداث وخصائص المستخدم.
• تعرّف على كيفية تصدير بياناتك إلى BigQuery.