Bu hızlı başlangıç, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve etkinlikleri günlüğe kaydetmeye nasıl başlayacağınızı gösterir.
Google Analytics, uygulamanıza ilişkin kullanım ve davranış verilerini toplar. SDK iki temel bilgi türünü günlüğe kaydeder:
- Etkinlikler: Kullanıcı eylemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda olup bitenler.
- Kullanıcı özellikleri: Dil tercihi veya coğrafi konum gibi kullanıcı tabanınızın bölümlerini tanımlamak için tanımladığınız özellikler.
Analytics, bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder; bunları etkinleştirmek için herhangi bir kod eklemenize gerek yoktur.
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 etkin olmadığı mevcut bir Firebase projesini kullanıyorsanız uygulamanızın Entegrasyonlar sekmesine gidin.
etkinleştirmek için > Proje ayarları'na 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
Modülünüzün (uygulama düzeyi) Gradle dosyasına (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Analytics kitaplığı bağımlılığını ekleyin Android için. Kitaplık sürümlerini kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.6.0")) // Add 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'yi kullandığınızda uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
Kotlin'e özgü bir kütüphane modülü mü arıyorsunuz? Ekim 2023'ten itibaren (Firebase BoM 32.5.0) hem Kotlin hem de Java geliştiricileri ana kütüphane modülüne güvenebilecekler (ayrıntılar için bu girişimle ilgili SSS'ye bakın).(Alternatif) BoM'yi kullanmadan Firebase kitaplığı bağımlılıklarını ekleyin
Firebase BoM'yi kullanmamayı tercih ederseniz her Firebase kitaplığı 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 tüm sürümlerin uyumlu olmasını sağlayan BoM'yi kullanmanızı önemle tavsiye ettiğimizi unutmayın.
dependencies { // Add 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.5.0") }
Etkinliğinizin üst kısmında
com.google.firebase.analytics.FirebaseAnalytics
nesnesini bildirin:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
onCreate()
yönteminde başlatın:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Olayları günlüğe kaydetmeye başlayın
FirebaseAnalytics
örneğini oluşturduktan sonra logEvent()
yöntemini kullanarak 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 mümkün olan maksimum ayrıntıyı sağlamak ve gelecekte kullanıma sunulacak özelliklerden ve entegrasyonlardan yararlanmak için, önerilen etkinlikleri önceden belirlenmiş parametrelerle birlikte göndermelisiniz. Bu bölümde önceden tanımlanmış bir olayın günlüğe kaydedilmesi gösterilmektedir; olayların günlüğe kaydedilmesi hakkında daha fazla bilgi için bkz . Olayların günlüğe kaydedilmesi .
Aşağıdaki kod, bir kullanıcı uygulamanızdaki belirli bir öğeyi tıkladığında bir SELECT_CONTENT
olayını günlüğe kaydeder.
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") }
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);
Olayların düzgün bir şekilde günlüğe kaydedildiğinin doğrulanmasına yardımcı olmak amacıyla olayların SDK tarafından günlüğe kaydedilmesini izlemek için ayrıntılı günlüğe kaydetmeyi etkinleştirebilirsiniz. Buna hem otomatik hem de manuel olarak kaydedilen olaylar dahildir.
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, etkinliklerinizi Android Studio logcat'ta görüntüleyerek etkinliklerin gönderildiğini anında doğrulamanıza yardımcı olur.
Sonraki adımlar
- Her Analytics raporunu anlayın.
- Olaylarınızı doğrulamak için DebugView'ı kullanın.
- Verilerinizi Firebase konsolunda keşfedin.
- Etkinlikler ve kullanıcı özelliklerine ilişkin kılavuzları keşfedin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin .