התחלת השימוש ב-Google Analytics


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

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

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

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

לפני שמתחילים

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

  • אם אתם יוצרים פרויקט חדש ב-Firebase, צריך להפעיל את Google Analytics במהלך תהליך יצירת הפרויקט.

  • אם אתם משתמשים בפרויקט קיים ב-Firebase שלא מופעל בו Google Analytics, תוכלו להפעיל אותו בכרטיסייה Integrations בקטע > Project settings.

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

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

  1. בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל <project>/<app-module>/build.gradle.kts או <project>/<app-module>/build.gradle), מוסיפים את התלות בספרייה Analytics ל-Android. מומלץ להשתמש ב-Firebase Android BoM כדי לשלוט בגרסאות הספרייה.

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:33.5.1"))
    
        // 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, האפליקציה תמיד תשתמש בגרסאות תואמות של ספריות Android של Firebase.

    (חלופה)  מוסיפים יחסי תלות לספריות של 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:22.1.2")
    }
    מחפשים מודול ספרייה ספציפי ל-Kotlin? החל מ-אוקטובר 2023 (Firebase BoM 32.5.0), מפתחי Kotlin ומפתחי Java יוכלו להסתמך על מודול הספרייה הראשי (פרטים נוספים זמינים בשאלות הנפוצות לגבי היוזמה הזו).

  2. מגדירים את האובייקט com.google.firebase.analytics.FirebaseAnalytics בחלק העליון של הפעילות:

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. מאתחלים אותו בשיטה onCreate():

    Kotlin+KTX

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

    Java

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

התחלת הרישום של אירועים ביומן

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

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

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

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")
}

Java

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);

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

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

השלבים הבאים