Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Google Analytics'i kullanmaya başlayın

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Bu hızlı başlangıç, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve olayları günlüğe 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, JavaScript 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 projesi kullanıyorsanız, etkinleştirmek için Entegrasyonlar > Proje ayarları sekmesine gidin.

Projenizde Google Analytics'i etkinleştirdiğinizde, Firebase web uygulamalarınız, bir Uygulama + Web mülküyle ilişkili Google Analytics veri akışlarına bağlanır.

Analytics SDK'sını uygulamanıza ekleyin

Web uygulamanızın nasıl barındırıldığına bağlı olarak, yapılandırmanız otomatik olarak gerçekleştirilebilir veya Firebase yapılandırma nesnenizi güncellemeniz gerekebilir. Web uygulamanız zaten Google Analytics kullanıyorsa Firebase'i mevcut gtag.js etiketlemesiyle kullanma bölümünde açıklanan ek kurulumu yapmanız gerekebilir.

  1. Kodunuzdaki measurementId yapılandırma nesnenizin MeasureId içerip içermediğini kontrol edin. Bu kimlik, Firebase projenizde Analytics'i etkinleştirdiğinizde ve bir web uygulaması kaydettiğinizde otomatik olarak oluşturulur ve Analytics'i kullanmak gerekir.

    • Uygulamanız Firebase Hosting kullanıyorsa ve Firebase SDK'ları için ayrılmış URL'ler kullanıyorsa :

      Firebase, uygulamanızı yapılandırmayı otomatik olarak gerçekleştirir. Kurulumu tamamlamak için, henüz yapmadıysanız, Proje ayarlarınızdaki Uygulamalarınız kartındaki komut dosyalarını uygulamanızın <body> etiketine ekleyin.

    • Uygulamanız ayrılmış URL'ler kullanmıyorsa : Mevcut bir web uygulamasıyla çalışıyorsanız , MeasureId alanının mevcut olduğundan emin olmak için kodunuzdaki measurementId yapılandırma nesnesini güncelleyin. Yapılandırma nesnesi aşağıdaki örneğe benzer görünmelidir:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
      const firebaseConfig = {
        apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc",
        authDomain: "project-id.firebaseapp.com",
        databaseURL: "https://project-id.firebaseio.com",
        projectId: "project-id",
        storageBucket: "project-id.appspot.com",
        messagingSenderId: "637908496727",
        appId: "2:637908496727:web:a4284b4c99e329d5",
        measurementId: "G-9VP01NDSXJ"
      };
      
  2. Henüz yapmadıysanız, Firebase JS SDK'yı yükleyin ve Firebase'i başlatın .

  3. Analytics JS SDK'sını ekleyin ve Analytics'i başlatın:

Web version 9

import { initializeApp } from "firebase/app";
import { getAnalytics } from "firebase/analytics";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
const app = initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = getAnalytics(app);

Web version 8

import firebase from "firebase/app";
import "firebase/analytics";

// TODO: Replace the following with your app's Firebase project configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize Firebase
firebase.initializeApp(firebaseConfig);


// Initialize Analytics and get a reference to the service
const analytics = firebase.analytics();

Firebase'i mevcut gtag.js etiketlemesiyle kullanın

Uygulamanızda daha önce gtag.js snippet'ini kullanarak Google Analytics'i çalıştırdıysanız , aşağıdakilerden birini yapmayı planlıyorsanız uygulamanız ek kurulum gerektirebilir:

  • Sayfaya Firebase'den Google Analytics çağrıları ekleyin, ancak gtag() çağrılarını doğrudan aynı sayfada kullanmaya devam etmeyi de planlayın.
  • Hem doğrudan gtag() çağrıları hem de Firebase'e gönderilen Google Analytics verileri arasında aynı ölçüm kimliğini kullanmak istiyorsunuz.

Etkinliklerinizin tüm Firebase hizmetleri tarafından kullanılabilir olduğundan emin olmak için aşağıdaki ek kurulum adımlarını tamamlayın:

  • gtag('config', ' GA_MEASUREMENT_ID '); satırını kaldırın burada GA_MEASUREMENT_ID , Firebase web uygulamanızın measurementId kimliğidir. Sayfadaki diğer Analytics mülkleri için başka kimlikleriniz varsa, bunların yapılandırma satırını kaldırmanız gerekmez.
  • gtag() ile herhangi bir olay göndermeden önce gtag() firebase.analytics() çağırdığınızdan emin olun.

Aksi takdirde, o kimliğe gtag() çağrılarıyla gönderilen olaylar Firebase ile ilişkilendirilmez ve diğer Firebase hizmetlerinde hedefleme için kullanılamaz.

Olayları günlüğe kaydetmeye başla

Analytics hizmetini başlattıktan 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, bkz.

Aşağıdaki örnek, bir kullanıcının uygulamanızda bir bildirim aldığını belirtmek için önerilen bir etkinliğin nasıl günlüğe kaydedileceğini gösterir:

Web version 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Web version 8

firebase.analytics().logEvent('notification_received');

Sonraki adımlar

tutucu132 l10n-yer