Google Analytics'i kullanmaya başlama

Bu hızlı başlangıç, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve etkinlikleri günlüğe 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:

  • Etkinlikler : Kullanıcı eylemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda olup bitenler.

  • Kullanıcı özellikleri : Dil tercihi veya coğrafi konum gibi kullanıcı tabanınızın bölümlerini tanımlamak için tanımladığınız özellikler.

Analytics, bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder; bunları etkinleştirmek için herhangi bir kod eklemenize gerek yoktur.

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 projesini kullanıyorsanız uygulamanızın Entegrasyonlar sekmesine gidin. etkinleştirmek için > Proje ayarları'na gidin.

Projenizde Google Analytics'i etkinleştirdiğinizde Firebase web uygulamalarınız, 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 ayarları yapmanız gerekebilir.

  1. Kodunuzdaki Firebase config nesnenizin measurementId içerip içermediğini kontrol edin. Bu kimlik, Firebase projenizde Analytics'i etkinleştirdiğinizde ve bir web uygulamasını kaydettiğinizde otomatik olarak oluşturulur ve Analytics'i kullanmak için gereklidir.

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

      Firebase, uygulamanızın yapılandırılmasını 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 , measurementId alanının mevcut olduğundan emin olmak için kodunuzdaki Firebase config nesnesini güncelleyin. Config 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 modüler API'si

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 ad alanlı API

import firebase from "firebase/compat/app";
import "firebase/compat/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

Daha önce gtag.js snippet'ini kullanarak uygulamanızda Google Analytics çalıştırıyorsanız aşağıdakilerden birini yapmayı planlıyorsanız uygulamanız ek kurulum gerektirebilir:

  • Firebase'den Google Analytics çağrılarını sayfaya ekleyin ancak aynı zamanda 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ılabildiğinden 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 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ıza gerek yoktur.
  • gtag() ile herhangi bir etkinlik göndermeden önce firebase.analytics() öğesini çağırdığınızdan emin olun.

Aksi takdirde, gtag() çağrılarıyla bu kimliğe gönderilen etkinlikler Firebase ile ilişkilendirilmeyecek ve diğer Firebase hizmetlerinde hedefleme için kullanılamayacaktır.

Olayları günlüğe kaydetmeye başlayın

Analytics hizmetini başlattıktan sonra logEvent() yöntemini kullanarak 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 mümkün olan maksimum ayrıntıyı sağlamak ve gelecekte kullanıma sunulacak özelliklerden ve entegrasyonlardan yararlanmak için, önerilen etkinlikleri önceden belirlenmiş parametrelerle birlikte göndermelisiniz. Bu bölümde önceden tanımlanmış bir olayın günlüğe kaydedilmesi gösterilmektedir; olayların günlüğe kaydedilmesi hakkında daha fazla bilgi için bkz . Olayların günlüğe kaydedilmesi .

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 modular API

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

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

Web namespaced API

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

Sonraki adımlar