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

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

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