Google Analytics'i kullanmaya başlama

Bu hızlı başlangıç kılavuzu, Google Analytics'i uygulamanıza nasıl ekleyeceğinizi ve etkinlikleri günlüğe nasıl kaydetmeye başlayacağınızı gösterir.

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

  • Etkinlikler: Uygulamanızda neler yaşandığını belirtir (ör. kullanıcı işlemleri, sistem etkinlikleri veya hatalar).

  • Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için tanımladığınız dil tercihi veya coğrafi konum gibi özellikler.

Analytics bazı etkinlikleri ve kullanıcı özelliklerini otomatik olarak günlüğe kaydeder. Bunları etkinleştirmek için herhangi bir kod eklemeniz gerekmez.

Başlamadan önce

Henüz yapmadıysanız Firebase'i JavaScript projenize 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 etkinleştirilmediği mevcut bir Firebase projesini kullanıyorsanız > Proje ayarları sayfanızdaki Entegrasyonlar sekmesine giderek projeyi etkinleştirin.

Projenizde Google Analytics'i etkinleştirdiğinizde Firebase web uygulamalarınız bir Uygulama + Web mülkü ile ilişkilendirilmiş 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 uygulanabilir veya Firebase yapılandırma nesnenizi güncellemeniz gerekebilir. Web uygulamanız zaten Google Analytics'i kullanıyorsa Firebase'i mevcut gtag.js etiketlemesiyle kullanma bölümünde açıklanan ek kurulumları yapmanız gerekebilir.

  1. Kodunuzdaki Firebase yapılandırma nesnesinin measurementId içerdiğinden emin olun. Bu kimlik, Firebase projenizde Analytics'i etkinleştirip bir web uygulaması kaydettiğinizde otomatik olarak oluşturulur ve Analytics'i kullanmak gerekir.

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

      Firebase, uygulamanızın yapılandırmasını otomatik olarak gerçekleştirir. Kurulumu tamamlamak için Proje ayarları'ndaki Uygulamalarınız kartındaki komut dosyalarını henüz yapmadıysanız 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 yapılandırma nesnesini güncelleyin. 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 uygulamanızda Google Analytics'i gtag.js snippet'ini kullanarak çalıştırdıysanız aşağıdakilerden birini yapmayı planlıyorsanız uygulamanızda ek kurulum gerekebilir:

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

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

  • GA_MEASUREMENT_ID değerinin Firebase web uygulamanızda measurementId olduğu gtag('config', 'GA_MEASUREMENT_ID'); satırını kaldırın. Sayfadaki başka Analytics mülkleri için başka kimlikleriniz varsa bunların yapılandırma satırını kaldırmanız gerekmez.
  • gtag() ile etkinlik göndermeden önce mutlaka firebase.analytics() numaralı telefonu arayın.

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

Etkinlikleri günlüğe kaydetmeye başla

Analytics hizmetini başlattıktan sonra logEvent() yöntemiyle etkinlikleri günlüğe kaydetmeye başlayabilirsiniz.

Bazı etkinlikler tüm uygulamalar için önerilir, bazıları ise belirli işletme türleri veya sektörler için önerilir. Raporlarınızda maksimum sayıda kullanılabilir ayrıntı sağlamak ve kullanıma sunulacak özellikler ile entegrasyonlardan yararlanmak için, önerilen etkinlikleri belirlenen parametreleriyle birlikte göndermeniz gerekir. Bu bölümde, önceden tanımlanmış bir etkinliğin günlüğe kaydedilmesi gösterilmektedir. Etkinlikleri günlüğe kaydetme hakkında daha fazla bilgi için Etkinlikleri günlüğe kaydetme bölümüne bakın.

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

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