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

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

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

Kotlin

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

Java

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 הגדרה
ביקורים session_start הסשן התחיל. האירוע הזה נמצא במעקב אוטומטי.
רכישות פיזיות Firebase.Event.ECOMMERCE_PURCHASE רכישות פיזיות. צריך לעקוב אחרי האירוע הזה במפורש בקוד.
רכישות דיגיטליות in_app_purchase רכישות דיגיטליות מתוך אפליקציות. האירוע הזה נמצא במעקב אוטומטי.
משך הפעילות באפליקציה user_engagement משך הזמן שהאפליקציה נמצאת בחזית. האירוע הזה נמצא במעקב אוטומטי.
הקשר לאפליקציה ללא התקנה app_type אירועים שהועלו מהאפליקציה שפועלים בגרסת ההתקנה המיידית או באפליקציה הקשר מסוים. צריך לעקוב אחרי האירוע הזה במפורש בקוד. ראו הבחנה בין נתונים של אפליקציות מותקנות ואפליקציות ללא התקנה שלמעלה.
מבקרים חוזרים session_start.count וגם app_type קהל של משתמשים שביקרו פעמיים או יותר. צריך להגדיר במפורש לעקוב אחרי האירוע app_type; session_start נמצא במעקב בשבילכם. ראו הבחנה בין נתוני האפליקציה המותקנות לבין נתוני האפליקציה ללא התקנה שלמעלה.

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