התחל לעבוד עם 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. באמצעות BOM Firebase אנדרואיד , להכריז על התלות של הספרייה אנדרואיד Analytics במודול שלך (ברמת האפליקציה) קובץ Gradle (בדרך כלל app/build.gradle ).

    ג'אווה

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

    קוטלין+KTX

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

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

    ג'אווה

    private FirebaseAnalytics mFirebaseAnalytics;

    קוטלין+KTX

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

    ג'אווה

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

    Kotlin+KTX

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

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

לאחר שיצרת 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);

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

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

הצעדים הבאים