Bu hızlı başlangıç kılavuzunda, Google Analytics hizmetini uygulamanıza nasıl ekleyeceğiniz ve etkinlikleri günlüğe kaydetmeye başlar.
Google Analytics, uygulamanız için kullanım ve davranış verilerini toplar. SDK günlüğe iki temel bilgi türü kaydeder:
- Etkinlikler: Uygulamanızda neler olup bittiği. Örneğin, kullanıcı işlemleri, sistem veya veya hataları anlamına gelir.
- Kullanıcı özellikleri: Kullanıcılarınızın segmentlerini tanımlamak için tanımladığınız özellikler (ör. dil tercihi veya coğrafi konum)
Analytics, bazı işlemleri otomatik olarak günlüğe kaydeder events ve kullanıcı özellikleri; bunları etkinleştirmek için kod eklemeniz gerekmez.
Başlamadan önce
Henüz yapmadıysanız Firebase'i Android cihazınıza ekleyin projesi ve Google Analytics Firebase projenizde etkinleştirin:
Yeni bir Firebase projesi oluşturuyorsanız Google Analytics özelliğini etkinleştirin müzakere tekniği de eklediniz.
Güncelleme içermeyen mevcut bir Firebase projesi kullanıyorsanız Google Analytics etkin, şuraya gidin: Entegrasyonlar (
'nı tıklayın. ) > Proje ayarları
Projenizde Google Analytics hizmetini etkinleştirdiğinizde Firebase uygulamalarınız: Google Analytics veri akışına bağlı.
Analytics SDK'sını uygulamanıza ekleyin
Modül (uygulama düzeyinde) Gradle dosyanızda (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Android için Analytics kitaplığına bağımlılığı ekleyin. Şunu kullanmanızı öneririz: Firebase Android BoM Kitaplık'ta sürüm oluşturmayı kontrol etmek içindependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.2.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 her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanacaktır.
(Alternatif) Firebase kitaplığı bağımlılıklarını kullanmadan BoM
Firebase BoM kullanmamayı seçerseniz her Firebase kitaplığı sürümünü belirtmeniz gerekir değerini alır.
Uygulamanızda birden çok Firebase kitaplığı kullanıyorsanız, kitaplık sürümlerini yönetmek için BoM kullanmanızı öneririz. Bu, tüm sürümlerin uyumlu olduğundan emin olun.
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.1.0") }
.com.google.firebase.analytics.FirebaseAnalytics
nesnesini şurada tanımlayın: en önemlisi: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);
Etkinlikleri günlüğe kaydetmeye başla
Bir FirebaseAnalytics
örneği oluşturduktan sonra,
etkinlikleri logEvent()
yöntemiyle gerçekleştirebilirsiniz.
Belirli etkinlikler tüm uygulamalar için önerilir; belirli işletme türleri veya sektörler için diğer öneriler önerilir. Göndermeniz gereken belgeler Böylece, önerilen etkinlikleri kendi belirlenen parametreleriyle birlikte kullanarak en yüksek düzeyde kullanılabilir ayrıntılara yer vermek ve gelecekte sunacağınız özelliklerden Google Analytics 360'ta kullanıma sunulur. Bu bölümde, daha fazla bilgi için bkz. Etkinlikleri günlüğe kaydedin.
Aşağıdaki kod, aşağıdaki durumlarda bir SELECT_CONTENT
etkinliği kaydeder:
Kullanıcı, uygulamanızdaki belirli bir öğeyi tıkladığında.
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);
SDK tarafından etkinliklerin günlüğe kaydedilmesine yardımcı olmak amacıyla ayrıntılı günlük kaydını etkinleştirebilirsiniz. etkinliklerin düzgün şekilde günlüğe kaydedildiğini doğrulayın. Bu, hem otomatik hem de ve manuel olarak günlüğe kaydedilen etkinlikler.
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, etkinliklerinizi Android Studio logcat'te görüntüleyerek etkinliklerin gönderildiğini hemen doğrular.
Sonraki adımlar
- Tüm Analytics raporlarını anlayın.
- Etkinliklerinizi doğrulamak için DebugView'ı kullanın.
- Firebase konsolunda verilerinizi inceleyin.
- Etkinlikler ve özelliklerini ekleyin.
- Verilerinizi BigQuery'ye nasıl aktaracağınızı öğrenin.