Catch up on everthing we announced at this year's Firebase Summit. Learn more

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.

Google Analytics, web uygulamanız için kullanım ve davranış verilerini toplar. SDK, iki temel bilgi türünü günlüğe kaydeder:

  • Olaylar: Böyle bir kullanıcı eylemleri, sistem olaylar, ya da hatalar olarak, uygulamanızda neler oluyor.

  • Kullanıcı özellikleri: Bu tür dil tercihi veya coğrafi konum gibi Kullanıcı kitlesinin kesimleri, tarif etmek tanımlayan özellik.

Analitik otomatik olarak bazı kaydeder olayları ve kullanıcı özelliklerini ; etkinleştirmek için herhangi bir kod eklemeniz gerekmez.

Sen başlamadan önce

Zaten yapmadıysanız, JavaScript projeye Firebase eklemek ve Google Analytics, Firebase projede etkin olduğundan emin olun:

  • Yeni bir Firebase projesi oluşturuyorsanız, proje oluşturma iş akışı sırasında Google Analytics'i etkinleştirin.

  • Eğer gitmek, Google Analytics, etkin olmayan mevcut bir Firebase projesini kullanıyorsanız Entegrasyonları sizin sekmesine > Proje ayarları etkinleştirmek için.

Google Analytics projenizde etkinleştirdiğinizde, Firebase web uygulamaları bir ilişkili akışları Google Analytics verilerine bağlı App + Web özelliği .

Analytics SDK'sını uygulamanıza ekleyin

Web uygulaması barındırılan nasıl bağlı olarak, yapılandırma otomatik işlenebilir ya da güncellemeniz gerekebilir Firebase yapılandırma nesnesi . Web uygulaması zaten Google Analytics kullanıyorsa, açıklanan ek kurulumu yapmanız gerekebilir mevcut gtag.js etiketleme kullanın Firebase .

  1. Kodunuzdaki sizin Firebase yapılandırma nesnesini içerdiğini kontrol edin measurementId . 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ın Barındırma Firebase kullanır ve varsa kullandığı URL'ler saklıdır Firebase SDK'lara:

      Firebase, uygulamanızı yapılandırmayı otomatik olarak gerçekleştirir. Komple kurulum için, içinde Uygulamalarınız kartından komut eklemek Proje ayarlarında zaten değil varsa, uygulamanızın <body> etiketine.

    • Uygulamanız saklıdır URL'ler kullanmıyorsa: Mevcut bir web uygulaması ile çalışıyorsanız, emin olmak için kodunda Firebase yapılandırma nesnesi güncelleştirmek measurementId alan mevcuttur. 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. Firebase Analytics'i Başlatın:

Web sürümü 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

Web sürümü 8

const analytics = firebase.analytics();

Firebase'i mevcut gtag.js etiketlemesiyle kullanın

Daha önce olsaydı, Google Analytics kullanarak uygulamanızda çalışan gtag.js pasajı aşağıdakilerden birini yapın planlıyorsanız uygulama ek kurulum gerektirebilir:

  • Sayfayı Firebase Google Analytics görüşmesi ekleme aynı zamanda kullanmaya devam etmeyi planlıyorsanız gtag() aynı sayfada doğrudan çağırır.
  • Her iki direk arasına aynı ölçüm kimliğini kullanmak ister gtag() Firebase gönderilen çağrılar ve Google Analytics verilerini.

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:

  • Çizgi çıkarın gtag('config', ' GA_MEASUREMENT_ID '); nerede GA_MEASUREMENT_ID olan measurementId sizin Firebase web uygulamasının. Sayfadaki diğer Analytics mülkleri için başka kimlikleriniz varsa, bunların yapılandırma satırını kaldırmanız gerekmez.
  • Emin aramak olun firebase.analytics() ile herhangi etkinlikleri göndermek önce gtag() .

Aksi takdirde, olaylar ile bu kimliğe gönderilen gtag() Firebase ile ilişkili olmayacak aramaları ve diğer Firebase hizmetler hedeflemek için uygun olmayacaktır.

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

Eğer başlatıldı sonra Analytics hizmetini , sizinle olayları günlüğe başlayabilir logEvent() yöntemiyle.

Belirli etkinlikler edilir tüm uygulamalar için ö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, bkz günlüğü olayları hakkında daha fazla bilgi için, önceden tanımlanmış olay günlüğü ortaya koyduğunu giriş etkinlik .

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

Web sürümü 9

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

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

Web sürümü 8

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

Sonraki adımlar