Hazır uygulamanıza Firebase için Google Analytics'i ekleme

Anlık veya yüklü bir uygulamanın başarısını izlemek her geliştirici için önemlidir. Fabric Answers, Localytics ve Mixpanel dahil olmak üzere çeşitli analiz kitaplıkları Google Play Anında ile uyumludur.

Mevcut analiz çözümünüz listede yer almıyorsa veya Google Play Anında ile çalışmadığını fark ederseniz telemetri çözümünüz olarak Firebase için Google Analytics'i kullanmayı düşünebilirsiniz. Bu sayfada, hazır uygulama projesinde Firebase için Google Analytics'in nasıl ayarlanacağı açıklanmaktadır.

Hazır uygulama projesine Firebase için Google Analytics'i ekleme

1. Firebase için Google Analytics'e başlama kılavuzunda açıklanan talimatları uygulayarak Firebase SDK'sını uygulamanıza ekleyin.
2. google-services eklentisinin en son sürümünü kullanın.
3. google-services.json dosyasını her modüle yerleştirin.

4. Aşağıdaki satırı her modülün build.gradle dosyasına ekleyin:

   Groovy

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

   Kotlin

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

Firebase için Google Analytics'i hazır uygulama projenize ekledikten sonra, Firebase için Google Analytics API'lerini yüklenebilir bir uygulama projesinde olduğu gibi kullanabilirsiniz.

Firebase için Google Analytics API'lerini kullanma hakkında daha fazla bilgi edinmek için Firebase için Google Analytics'i kullanmaya başlama belgelerine bakın.

Yüklü ve hazır uygulama verilerini ayırt etme

Hem yüklü uygulamanız hem de hazır uygulamanız aynı paket adını paylaştığından her birinden toplanan etkinlikleri ve verileri ayırt etmek isteyebilirsiniz. Analytics'te anlık ve yüklü uygulamalarınızı ayırt etmek için app_type kullanıcı özelliği ayarlayın. Anlık uygulama için "instant", yüklü uygulama için "installed" değerini kullanın.

Aşağıdaki kod snippet'inde, bir Analytics örneği alan ve ardından bir kullanıcı özelliği ayarlayan bir etkinlik gösterilmektedir. Kodun, uygulamanın bağlamını belirlemek için onCreate(android.os.Bundle) yönteminde PackageManagerCompat.isInstantApp() kullandığını unutmayın.

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 kullanıcı özelliğini ayarladıktan sonra Analytics konsolunun Etkinlikler sekmesinde bir etkinlik seçebilir ve ardından etkinliği app_type değerine göre filtreleyebilirsiniz. Elde edilen veri projeksiyonu, hazır uygulamanızda veya yüklü uygulamanızda belirtilen etkinliğin sayısını gösterir.

Firebase için Google Analytics'te etkinlikleri günlüğe kaydetme ve görüntüleme hakkında daha fazla bilgi edinmek için Etkinlikleri Günlüğe Kaydetme başlıklı makaleyi inceleyin.

Analytics etkinliklerini yorumlama

Analytics, anlık uygulamalar için değerli olan çeşitli metrikleri izlemenize olanak tanır. Aşağıdaki tabloda, Analytics'teki ilgili etkinlik adı veya özellik de dahil olmak üzere anlık uygulamanızla ilgili metrikler açıklanmaktadır.

Analytics'te toplayabileceğiniz etkinliklerle ilgili sabitler hakkında daha fazla bilgi için FirebaseAnalytics.Event başlıklı makaleyi inceleyin.