Google Analytics'i kullanmaya başlama


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, web uygulamanız için kullanım ve davranış verilerini toplar. SDK günlüğe iki temel bilgi türü kaydeder:

  • Etkinlikler: Uygulamanızda neler olduğunu (ör. kullanıcı işlemleri, sistem) veya hataları anlamına gelir.

  • Kullanıcı özellikleri: Kullanıcınızın segmentlerini tanımlamak için tanımladığınız özellikler temel bilgileri de dahil edebilirsiniz.

Analytics bazı verileri 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 JavaScript'inize ekleyin. projenin ve Google Analytics uygulamasının etkinleştirildiğinden emin olun Firebase projenizde:

  • 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 () > Proje ayarları'nı tıklayın.

ziyaret edin.

Projenizde Google Analytics eklentisini etkinleştirdiğinizde Firebase web uygulamalarınız şununla ilişkili Google Analytics veri akışına bağlı: Uygulama + Web mülkü.

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 ele alınır veya Firebase yapılandırma nesnesi. Web uygulamanız zaten Google Analytics'i kullanıyorsa, Firebase'i mevcut gtag.js etiketlemesiyle kullanma bölümünde açıklanan ayarları uygulayın.

  1. Kodunuzdaki Firebase yapılandırma nesnesinin şunu içerdiğinden emin olun: measurementId Bu kimlik, etkinleştirildiğinde otomatik olarak oluşturulur Analytics Firebase projenize gidip bir web uygulaması kaydedin, Analytics kullanımı için gereklidir.

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

      Firebase, uygulamanızın yapılandırmasını otomatik olarak gerçekleştirir. Tamamlamak için Uygulamalarınız kartındaki komut dosyalarını Proje ayarları to <body> Henüz yapmadıysanız uygulamanızın etiketi.

    • Uygulamanız ayrılmış URL'ler kullanmıyorsa: Mevcut bir web uygulamasıyla çalışıyorsanız Firebase yapılandırmasını güncelleyin nesnenizde measurementId alanının bulunduğundan emin olun. İlgili içeriği oluşturmak için kullanılan config nesnesi aşağıdaki örneğe benzer olmalıdır:

      // 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 uygulamasını başlatın:

Web

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

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 kullanma

Daha önce Google Analytics'i uygulamanızda gtag.js snippet'i Aşağıdakilerden birini yapmayı planlıyorsanız uygulamanızda ek kurulum gerekebilir:

  • Firebase'den sayfaya Google Analytics çağrısı ekleyin, ancak şunu da planlayın: gtag() aramasını doğrudan aynı sayfada kullanmaya devam et.
  • Hem doğrudan gtag() çağrılar ve Google Analytics verileri Firebase'e gönderildi.

Etkinliklerinizin tüm Firebase hizmetleri tarafından kullanılabildiğinden emin olmak için şu ek kurulum adımlarını uygulayın:

  • gtag('config', 'GA_MEASUREMENT_ID'); satırını kaldır burada GA_MEASUREMENT_ID metriğinizin measurementId değeridir Firebase web uygulaması. Diğer Analytics mülkleri için başka kimlikleriniz varsa yapılandırma satırını kaldırmanız gerekmez.
  • Etkinlik göndermeden önce mutlaka firebase.analytics() adlı kişiyi arayın gtag() ile.

Aksi takdirde, bu kimliğe gtag() çağrılarıyla gönderilen etkinlikler ilişkilendirilmez ve diğer platformlarda hedefleme için kullanılamaz. Firebase hizmetleri.

Etkinlikleri günlüğe kaydetmeye başla

Analytics hizmetinizle şununla etkinlikleri günlüğe kaydetmeye başlar: logEvent() yöntemidir.

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 örnekte, kullanıcı, uygulamanızda bir bildirim aldı:

Web

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

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

Web

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

Sonraki adımlar