Google Analytics הוא מנוע הניתוח של Firebase. כשאתה משתמש ב-Analytics ו-Crashlytics ביחד באפליקציה שלך, אתה מקבל תכונות שעוזרות לך לייצר בעיות ולעקוב אחר נתוני קריסה בפירוט רב יותר, כגון משתמשים ללא קריסות, פירורי לחם שעוקבים אחר אירועים ספציפיים לפני קריסה, ו-BigQuery, שבהם אתה יכול לדמיין את מדדי המפתח של האפליקציה שלך.
מדריך זה מתאר כיצד להוסיף Analytics לאפליקציה שמוגדרת בה Crashlytics (אם עדיין לא עשית זאת, הוסף את Crashlytics לאפליקציה שלך ).
שלב 1: הוסף קובץ תצורה של Firebase
הוסף את קובץ התצורה של Firebase Android לאפליקציה שלך:
פתח את הגדרות הפרויקט שלך. בכרטיס האפליקציות שלך , בחר את שם החבילה של האפליקציה שעבורה אתה צריך קובץ תצורה.
לחץ על הורד את google-services.json כדי להשיג את קובץ התצורה של Firebase Android שלך (
google-services.json
).- תוכל להוריד שוב את קובץ התצורה של Firebase Android בכל עת.
- ודא שקובץ התצורה אינו מצורף עם תווים נוספים, כמו
(2)
.
העבר את קובץ התצורה שלך לספריית המודול (ברמת האפליקציה) של האפליקציה שלך.
כדי להפעיל מוצרי Firebase באפליקציה שלך, הוסף את הפלאגין google-services לקבצי Gradle שלך.
בקובץ Gradle ברמת השורש (ברמת הפרויקט) (
<project>/build.gradle.kts
או<project>/build.gradle
), הוסף כללים כדי לכלול את הפלאגין Gradle שירותי Google. בדוק שיש לך גם את מאגר Maven של גוגל.Kotlin
plugins { id("com.android.application") version "7.3.0" apply false // ... // Add the dependency for the Google services Gradle plugin id("com.google.gms.google-services") version "4.4.0" apply false }
Groovy
plugins { id 'com.android.application' version '7.3.0' apply false // ... // Add the dependency for the Google services Gradle plugin id 'com.google.gms.google-services' version '4.4.0' apply false }
בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל
<project>/<app-module>/build.gradle.kts
או<project>/<app-module>/build.gradle
), החל את הפלאגין Gradle של שירותי Google.Kotlin
plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
Groovy
plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' // ... }
שלב 2: הוסף את ה-SDK של Analytics לאפליקציה שלך
בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל
<project>/<app-module>/build.gradle.kts
או<project>/<app-module>/build.gradle
), הוסף את התלות של ספריית Analytics עבור אנדרואיד. אנו ממליצים להשתמש ב- Firebase Android BoM כדי לשלוט בגירסאות של הספרייה.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.6.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.
מחפש מודול ספרייה ספציפי לקוטלין? החל מאוקטובר 2023 (Firebase BoM 32.5.0) , מפתחי Kotlin ו-Java יכולים להיות תלויים במודול הספרייה הראשי (לפרטים, עיין בשאלות הנפוצות לגבי יוזמה זו ).(אלטרנטיבי) הוסף תלות בספריית 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.5.0' }
הכריז על האובייקט
com.google.firebase.analytics.FirebaseAnalytics
בראש הפעילות שלך:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
אתחל אותו בשיטת
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
הצעדים הבאים
- השתמש ב- DebugView כדי לאמת את האירועים שלך.
- חקור את הנתונים שלך במסוף Firebase.
- חקור את המדריכים על אירועים ומאפייני משתמשים.
- למד כיצד לייצא את הנתונים שלך ל- BigQuery.