Google Analytics'i kullanmaya başlama


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

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

  • Etkinlikler: Uygulamanızda neler olduğu (ö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 özellikler (ör. dil tercihi veya coğrafi konum).

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'nin etkinleştirildiğinden emin olun:

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

  • Google Analytics etkinleştirilmemiş mevcut bir Firebase projesi kullanıyorsanız Google Analytics'ü etkinleştirmek için > Proje ayarları bölümündeki Entegrasyonlar sekmesine gidin.

Projenizde Google Analytics'ü 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 ekleme

Web uygulamanızın barındırma şekline bağlı olarak, yapılandırmanız otomatik olarak ele alınabilir veya Firebase yapılandırma nesnenizi güncellemeniz gerekebilir. Web uygulamanız zaten Google Analytics kullanıyorsa Mevcut gtag.js etiketlemeyle Firebase'i kullanma başlıklı makalede açıklanan ek kurulumu yapmanız gerekebilir.

  1. Kodunuzdaki Firebase yapılandırma nesnenizin measurementId içerdiğinden emin olun. Bu kimlik, Firebase projenizde Analytics'yi etkinleştirip bir web uygulaması kaydettiğinizde otomatik olarak oluşturulur ve Analytics'yi 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 yönetir. Kurulumu tamamlamak için, Proje ayarlarınız bölümündeki Uygulamalarınız kartındaki komut dosyalarını uygulamanızın <body> etiketine ekleyin (henüz yapmadıysanız).

    • Uygulamanızda ayrılmış URL'ler kullanılmı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 şekilde görünmelidir:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
const firebaseConfig = {
  apiKey: "API_KEY",
  authDomain: "PROJECT_ID.firebaseapp.com",
  databaseURL: "https://PROJECT_ID.firebaseio.com",
  projectId: "PROJECT_ID",
  storageBucket: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  measurementId: "G-GA_MEASUREMENT_ID"
};

  2. Henüz yapmadıysanız Firebase JS SDK'sını yükleyin ve Firebase'i başlatın.

  3. Analytics JS SDK'sını ekleyin ve Analytics'yi 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 etiketlemeyle kullanma

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

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

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

  • GA_MEASUREMENT_ID, Firebase web uygulamanızın measurementId olduğu gtag('config', 'GA_MEASUREMENT_ID'); satırını kaldırın. Sayfada diğer 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 firebase.analytics() işlevini çağırdığınızdan emin olun.

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

Etkinlikleri günlüğe kaydetmeye başlama

Analytics hizmetini başlattıktan sonra logEvent() yöntemiyle etkinlikleri 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 düzeyde ayrıntı elde etmek ve kullanıma sunulan yeni özellikler ile entegrasyonlardan yararlanmak için önerilen etkinlikleri kendi belirlenen parametreleriyle 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 Günlük etkinlikleri başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, 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