Bu sayfa, Cloud Translation API ile çevrilmiştir.

Google Analytics'i kullanmaya başlayın

Bu hızlı başlangıç, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve olayları kaydetmeye nasıl başlayacağınızı gösterir.

tutucu113 l10n-yer

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;MainActivity.java

Kotlin+KTX

private lateinit var firebaseAnalytics: FirebaseAnalyticsMainActivity.kt

onCreate() yönteminde başlatın:

Java

// Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);MainActivity.java

Kotlin+KTX

// Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analyticsMainActivity.kt

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);MainActivity.java

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")
}MainActivity.kt

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.

tutucu132 l10n-yer