Bu hızlı başlangıç kılavuzunda, uygulamanıza Google Analytics nasıl ekleyeceğiniz ve etkinlikleri nasıl günlüğe kaydetmeye başlayacağınız gösterilmektedir.
Google Analytics, uygulamanızla ilgili kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü kaydeder:
- Etkinlikler: Uygulamanızda neler olduğu (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar).
- Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için belirlediğiniz özellikler (ör. dil tercihi veya coğrafi konum).
Analytics bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak kaydeder. Bunları etkinleştirmek için herhangi bir kod eklemeniz gerekmez.
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 etkinleştirin.
Google Analytics'in etkinleştirilmediği mevcut bir Firebase projesi kullanıyorsanız etkinleştirmek için
bölümünün > Proje ayarlarıEntegrasyonlar sekmesine gidin.
Projenizde Google Analytics özelliğini etkinleştirdiğinizde Firebase uygulamalarınız Google Analytics veri akışlarına bağlanır.
Uygulamanıza Analytics SDK'sını ekleyin.
Modülünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Android için Analytics kitaplığının bağımlılığını ekleyin. Kitaplık sürüm oluşturmayı kontrol etmek için Firebase Android BoM kullanmanızı öneririz.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.16.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 kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.
(Alternatif) Firebase kitaplığı bağımlılıklarını BoM kullanmadan ekleyin.
Firebase BoM kullanmamayı tercih ederseniz her 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 kullanmanızı önemle tavsiye ederiz. Bu sayede tüm sürümlerin uyumlu olması sağlanır.
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:22.5.0") }
İşleminizin en başında
com.google.firebase.analytics.FirebaseAnalytics
nesnesini tanımlayın:Kotlin
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
onCreate()
yönteminde başlatın:Kotlin
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Etkinlikleri günlüğe kaydetmeye başlama
FirebaseAnalytics
örneği oluşturduktan sonra logEvent()
yöntemiyle etkinlikleri günlüğe kaydetmeye başlayabilirsiniz.
Bazı etkinlikler tüm uygulamalar için önerilirken bazıları belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum düzeyde ayrıntı sağlamak ve kullanıma sunulacak özellikler ile entegrasyonlardan yararlanmak için önerilen etkinlikleri kendi belirlenen parametreleriyle göndermeniz gerekir. Bu bölümde, önceden tanımlanmış bir etkinliğin nasıl günlüğe kaydedileceği gösterilmektedir. Etkinliklerin günlüğe kaydedilmesi hakkında daha fazla bilgi için Etkinlikleri günlüğe kaydetme başlıklı makaleyi inceleyin.
Aşağıdaki kod, bir kullanıcı uygulamanızdaki belirli bir öğeyi tıkladığında SELECT_CONTENT
etkinliğini günlüğe kaydeder.
Kotlin
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);
Etkinliklerin düzgün şekilde kaydedildiğini doğrulamaya yardımcı olmak için SDK tarafından etkinliklerin günlüğe kaydedilmesini izlemek üzere ayrıntılı günlük kaydını etkinleştirebilirsiniz. Bu, hem otomatik olarak hem de manuel olarak kaydedilen etkinlikleri içerir.
Ayrıntılı günlük kaydını bir dizi adb
komutuyla 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, etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olarak etkinliklerinizi Android Studio logcat'te gösterir.
Sonraki adımlar
- Her Analytics raporunu anlayın.
- Etkinliklerinizi doğrulamak için DebugView'u kullanın.
- Verilerinizi Firebase konsolunda keşfedin.
- Etkinlikler ve kullanıcı özellikleri ile ilgili kılavuzları inceleyin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin.