Google Analytics'i kullanmaya başlama

Bu hızlı başlangıç kılavuzunda, Google Analytics'i 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. Google Analytics'in etkinleştirildiğinden emin olun. Firebase projenizde:

  • Yeni bir Firebase projesi oluşturuyorsanız Google Analytics'i etkinleştirin müzakere tekniği de eklediniz.

  • Güncelleme içermeyen mevcut bir Firebase projesi kullanıyorsanız Google Analytics'i etkinleştirdiyseniz, Entegrasyonlar sekmenizin > Proje ayarları'nı tıklayın.

Projenizde Google Analytics'i etkinleştirdiğinizde Firebase web uygulamalarınız bir 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 Firebase projenize girip bir web uygulaması kaydedin. Analytics'i kullanmak için gerekli.

    • Uygulamanız Firebase Hosting'i ve 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'yı ekleyin ve Analytics'i 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ılarını da ekleyin gtag() aramalarını doğrudan aynı sayfada kullanmaya devam et.
  • Hem doğrudan gtag() çağrılar ve Google Analytics verileri Firebase'e gönderilir.

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');
analytics_log_event.js

Web

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

Sonraki adımlar