התחל עם 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 לאפליקציה שלך

  1. באמצעות Firebase Android BoM , הכריז על התלות של ספריית Android של Analytics בקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle ).

    Java

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

    (אלטרנטיבי) הכרזה על תלות בספריית 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:20.0.2'
    }
    

    קוטלין+KTX

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

    (אלטרנטיבי) הכרזה על תלות בספריית 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:20.0.2'
    }
    

  2. הכריז על האובייקט com.google.firebase.analytics.FirebaseAnalytics בראש הפעילות שלך:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    קוטלין+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. אתחל אותו בשיטת onCreate() :

    Java

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

    קוטלין+KTX

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

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

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

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

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

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

קוטלין+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")
}

אתה יכול להפעיל רישום מילולי כדי לנטר רישום אירועים על ידי ה-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, ועוזרת לך לאמת מיד שאירועים נשלחים.

הצעדים הבאים