Web için Google Analytics'i kullanmaya başlama

Platform seçin: iOS+ Android Web Flutter Unity C++


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

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ı işlemleri, sistem etkinlikleri veya hatalar gibi uygulamanızda neler olduğu.

  • Kullanıcı özellikleri: Kullanıcı tabanınızın segmentlerini tanımlamak için belirlediğiniz özelliklerdir (ö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 özelliğinin etkinleştirildiğinden emin olun:

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

  • Google Analytics etkinleştirilmemiş mevcut bir Firebase projesi kullanıyorsanız Ayarlar > Entegrasyonlar sekmesinde etkinleştirebilirsiniz.

Projenizde Google Analytics hizmetini etkinleştirdiğinizde Firebase web uygulamalarınız, bir 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 işlenebilir veya Firebase yapılandırma nesnenizi güncellemeniz gerekebilir. Web uygulamanızda Google Analytics kullanılıyorsa Mevcut gtag.js etiketlemesiyle Firebase'i kullanma bölümünde açıklanan ek kurulum adımlarını uygulamanız gerekebilir.

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

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

      Firebase, uygulamanızın yapılandırmasını otomatik olarak yapar. Kurulumu tamamlamak için Proje ayarlarınızdaki Uygulamalarınız kartında bulunan komut dosyalarını uygulamanızın <body> etiketine ekleyin (henüz eklemediyseniz).

    • Uygulamanız ayrılmış URL'leri kullanmıyorsa: Mevcut bir web uygulamasıyla çalışıyorsanız kodunuzdaki Firebase yapılandırma nesnesini güncelleyerek measurementId alanının mevcut olduğundan emin olun. 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"
};
      1. Henüz yapmadıysanız Firebase JS SDK'sını yükleyin ve Firebase'i ilk kullanıma hazırlayın. 2. Analytics JS SDK'sını ekleyin ve Analytics'yı 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();

Mevcut gtag.js etiketlemesiyle Firebase'i kullanma

Uygulamanızda daha önce gtag.js snippet'ini kullanarak Google Analytics'i çalıştırdıysanı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 aynı sayfada doğrudan gtag() çağrılarını kullanmaya devam etmeyi de planlayın.
  • Doğrudan gtag() çağrıları ile 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ılabilmesi için aşağıdaki ek kurulum adımlarını tamamlayın:

  • gtag('config', 'GA_MEASUREMENT_ID'); satırını kaldırın. Burada GA_MEASUREMENT_ID, Firebase web uygulamanızın measurementId değeridir. 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 herhangi bir 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 günlüğe kaydetmeye başlayabilirsiniz.

Belirli etkinlikler tüm uygulamalar için önerilir. Diğerleri ise belirli işletme türleri veya sektörler için önerilir. Raporlarınızda mümkün olan en ayrıntılı bilgileri edinmek ve kullanıma sunulacak özellikler ile entegrasyonlardan yararlanmak için, önerilen etkinlikleri kendi belirlenen parametreleriyle göndermeniz gerekir. Bu bölümde, önceden tanımlanmış bir etkinliğin nasıl günlüğe kaydedileceği gösterilmektedir. Etkinlikleri günlüğe kaydetme hakkında daha fazla bilgi için Etkinlikleri günlüğe kaydetme başlıklı makaleyi inceleyin.

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

Web

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

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

Web

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

Sonraki adımlar