Google Analytics, uygulamanız için kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü günlüğe kaydeder:
- Olaylar: Kullanıcı eylemleri, sistem olayları veya hatalar gibi uygulamanızda neler oluyor.
- Kullanıcı özellikleri: Dil tercihi veya coğrafi konum gibi kullanıcı tabanınızın bölümlerini açıklamak için tanımladığınız nitelikler.
Analytics, bazı olayları ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder; etkinleştirmek için herhangi bir kod eklemeniz gerekmez.
Sen başlamadan önce
Henüz yapmadıysanız, Android projenize Firebase'i ekleyin ve Firebase projenizde Google Analytics'in etkinleştirildiğinden emin olun:
Yeni bir Firebase projesi oluşturuyorsanız, proje oluşturma iş akışı sırasında Google Analytics'i etkinleştirin.
Google Analytics'in etkinleştirilmediği mevcut bir Firebase projesini kullanıyorsanız, etkinleştirmek için Entegrasyonlar > Proje ayarları sekmesine gidin.
Projenizde Google Analytics'i etkinleştirdiğinizde, Firebase uygulamalarınız Google Analytics veri akışlarına bağlanır.
Analytics SDK'sını uygulamanıza ekleyin
Firebase Android BoM kullanarak, modülünüzdeki (uygulama düzeyi) Gradle dosyanızdaki (genellikle
app/build.gradle
) Analytics Android kitaplığının bağımlılığını bildirin.Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.0.2') // 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 Android BoM'u kullanarak uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
(Alternatif) BoM kullanmadan Firebase kitaplık bağımlılıklarını bildirin
Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.
Uygulamanızda birden fazla Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için BoM'yi kullanmanızı şiddetle tavsiye ettiğimizi unutmayın; bu, tüm sürümlerin uyumlu olmasını sağlar.
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:21.0.0' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.0.2') // 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 Android BoM'u kullanarak uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
(Alternatif) BoM kullanmadan Firebase kitaplık bağımlılıklarını bildirin
Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.
Uygulamanızda birden fazla Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için BoM'yi kullanmanızı şiddetle tavsiye ettiğimizi unutmayın; bu, tüm sürümlerin uyumlu olmasını sağlar.
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:21.0.0' }
Etkinliğinizin en üstünde
com.google.firebase.analytics.FirebaseAnalytics
nesnesini bildirin:Java
private FirebaseAnalytics mFirebaseAnalytics;
Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
onCreate()
yönteminde başlatın:Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Olayları günlüğe kaydetmeye başla
Bir FirebaseAnalytics
örneği oluşturduktan sonra, logEvent()
yöntemiyle olayları günlüğe kaydetmeye başlayabilirsiniz.
Tüm uygulamalar için belirli etkinlikler önerilir ; diğerleri belirli iş türleri veya sektörler için önerilir. Raporlarınızda maksimum ayrıntıyı sağlamak ve kullanıma sunuldukça gelecekteki özelliklerden ve entegrasyonlardan yararlanmak için önerilen etkinlikleri öngörülen parametreleriyle birlikte göndermelisiniz. Bu bölüm, önceden tanımlanmış bir olayın günlüğe kaydedilmesini gösterir, günlüğe kaydetme hakkında daha fazla bilgi için, Olayları günlüğe kaydetme bölümüne bakın.
Aşağıdaki kod, bir kullanıcı uygulamanızdaki belirli bir öğeyi tıkladığında bir SELECT_CONTENT
olayını günlüğe kaydeder.
Java
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);
Kotlin+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") }
Olayların düzgün bir şekilde günlüğe kaydedildiğini doğrulamaya yardımcı olmak için olayların SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlüğe kaydetmeyi etkinleştirebilirsiniz. Bu, hem otomatik hem de manuel olarak günlüğe kaydedilen olayları içerir.
Bir dizi adb
komutuyla ayrıntılı günlük kaydını etkinleştirebilirsiniz:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
Bu komut, olaylarınızı Android Studio logcat'te görüntüler ve olayların gönderildiğini hemen doğrulamanıza yardımcı olur.
Sonraki adımlar
- Olaylarınızı doğrulamak için DebugView'ı kullanın.
- Firebase konsolunda verilerinizi keşfedin.
- Etkinlikler ve kullanıcı özellikleriyle ilgili kılavuzları keşfedin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin.