הוספה של Google Analytics for Firebase לאפליקציה ללא התקנה

חשוב לכל מפתח לעקוב אחרי ההצלחה של אפליקציה, בין אם היא אפליקציה ללא התקנה או אפליקציה שמותקנת. כמה ספריות לניתוח נתונים תואמות ל-Google Play Instant, כולל Fabric Answers,‏ Localytics ו-Mixpanel.

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

הוספת Google Analytics for Firebase לפרויקט של אפליקציה מיידית

1. מוסיפים את Firebase SDK לאפליקציה לפי ההוראות שמפורטות במדריך לתחילת העבודה עם Google Analytics for Firebase.
2. משתמשים בגרסה העדכנית של הפלאגין google-services.
3. ממקמים את קובץ ה-google-services.json בכל מודול.

4. מוסיפים את השורה הבאה לקובץ build.gradle של כל מודול:

   מגניב

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }

   Kotlin

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }

אחרי שמוסיפים את Google Analytics for Firebase לפרויקט של האפליקציה המיידית, אפשר להשתמש בממשקי ה-API של Google Analytics for Firebase כמו בפרויקט של אפליקציה שאפשר להתקין.

מידע נוסף על השימוש בממשקי ה-API של Google Analytics for Firebase זמין במסמכי תחילת העבודה עם Google Analytics for Firebase.

ההבדל בין נתונים של אפליקציות מותקנות לבין נתונים של אפליקציות ללא התקנה

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

בקטע הקוד הבא מוצגת פעילות שמקבלת מופע של Analytics ואז מגדירה מאפיין משתמש. שימו לב שהקוד משתמש ב-PackageManagerCompat.isInstantApp() בשיטה onCreate(android.os.Bundle) כדי לקבוע את ההקשר של האפליקציה.

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

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

מידע נוסף על תיעוד אירועים וצפייה בהם ב-Google Analytics for Firebase זמין במאמר תיעוד אירועים.

פירוש אירועים ב-Analytics

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

מידע נוסף על הקבועים של אירועים שאפשר לאסוף ב-Analytics זמין במאמר בנושא FirebaseAnalytics.Event.