התחל לעבוד עם Google Analytics

התחלה מהירה זו מראה לך כיצד להוסיף את Google Analytics לאפליקציה שלך ולהתחיל ברישום אירועים.

Google Analytics אוספת נתוני שימוש והתנהגות עבור האפליקציה שלך. ה- SDK רושם שני סוגים עיקריים של מידע:

אירועים: מה קורה באפליקציה שלך, כגון פעולות משתמש, אירועי מערכת או שגיאות.
מאפייני משתמש: מאפיינים שאתה מגדיר לתיאור פלחים בבסיס המשתמשים שלך, כגון העדפת שפה או מיקום גיאוגרפי.

Analytics רושם אוטומטית כמה אירועים ומאפייני משתמש ; אתה לא צריך להוסיף שום קוד כדי לאפשר אותם.

לפני שאתה מתחיל

אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט Android שלך וודא ש- Google Analytics מופעל בפרויקט Firebase שלך:

אם אתה יוצר פרויקט Firebase חדש, הפעל את Google Analytics במהלך זרימת העבודה של יצירת הפרויקט.
אם אתה משתמש בפרויקט Firebase קיים שאינו פעיל ב- Google Analytics, עבור לכרטיסייה שילובים שלך> הגדרות פרויקט כדי להפעיל אותו.

כאשר אתה מפעיל את Google Analytics בפרויקט שלך, אפליקציות Firebase שלך מקושרות לזרמי נתונים של Google Analytics.

הוסף את ה- SDK של Analytics לאפליקציה שלך

באמצעות Firebase Android BoM , הצהירו על התלות בספריית אנדרואיד Analytics במודול (ברמת האפליקציה) קובץ Gradle (בדרך כלל app/build.gradle ).
ג'אווה
```
dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:28.1.0')

    // Declare 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 , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- Firebase.
(חלופי) הצהיר על תלות בספריית Firebase מבלי להשתמש ב- BoM
אם תבחר לא להשתמש ב- Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.
שים לב שאם אתה משתמש בספריות Firebase מרובות באפליקציה שלך, אנו ממליצים בחום להשתמש ב- BoM לניהול גרסאות ספרייה, מה שמבטיח שכל הגרסאות תואמות.
```
dependencies {
    // Declare 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:19.0.0'
}
```
Kotlin + KTX
```
dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:28.1.0')

    // Declare 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 , היישום שלך ישתמש תמיד בגרסאות תואמות של ספריות Android ל- Firebase.
(חלופי) הצהיר על תלות בספריית Firebase מבלי להשתמש ב- BoM
אם תבחר לא להשתמש ב- Firebase BoM, עליך לציין כל גרסת ספריית Firebase בשורת התלות שלה.
שים לב שאם אתה משתמש בספריות Firebase מרובות באפליקציה שלך, אנו ממליצים בחום להשתמש ב- BoM לניהול גרסאות ספרייה, מה שמבטיח שכל הגרסאות תואמות.
```
dependencies {
    // Declare 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:19.0.0'
}
```
הכריזו על האובייקט com.google.firebase.analytics.FirebaseAnalytics בראש הפעילות שלכם:
ג'אווה
```
private FirebaseAnalytics mFirebaseAnalytics;MainActivity.java
```
Kotlin + KTX
```
private lateinit var firebaseAnalytics: FirebaseAnalyticsMainActivity.kt
```

אתחל אותו בשיטת onCreate() :

ג'אווה

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

Kotlin + KTX

// Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analyticsMainActivity.kt

התחל לרשום אירועים

לאחר שיצרת מופע FirebaseAnalytics , תוכל להתחיל לרשום אירועים בשיטת logEvent() .

אירועים מסוימים מומלצים לכל האפליקציות ; אחרים מומלצים לסוגי עסק או אנכיות ספציפיות. עליך לשלוח אירועים מוצעים יחד עם הפרמטרים שנקבעו להם, כדי להבטיח פירוט מקסימלי זמין בדוחות שלך וליהנות מתכונות ושילובים עתידיים ככל שהם יהיו זמינים. סעיף זה מדגים רישום אירוע שהוגדר מראש, לקבלת מידע נוסף אודות רישום אירועים, ראה יומן אירועים .

הקוד הבא רושם אירוע SELECT_CONTENT כאשר משתמש לוחץ על אלמנט ספציפי באפליקציה שלך.

ג'אווה

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

Kotlin + KTX

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

באפשרותך לאפשר רישום מילולי כדי לפקח על רישום אירועים על ידי 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

פקודה זו מציגה את האירועים שלך ב- logicat של Android Studio, ומסייעת לך לוודא מיד שהאירועים נשלחים.

הצעדים הבאים

השתמש בתצוגת DebugView כדי לאמת את האירועים שלך.
גלה את הנתונים שלך במסוף Firebase.
חקור את המדריכים בנושא אירועים ונכסי משתמש.
למד כיצד לייצא את הנתונים שלך ל- BigQuery.