شروع به کار با Google Analytics برای وب

انتخاب پلاتفرم: iOS+ Android وب Flutter Unity C++


این شروع سریع به شما نشان می‌دهد که چگونه Google Analytics را به برنامه خود اضافه کنید و شروع به ثبت رویدادها کنید.

Google Analytics داده‌های استفاده و رفتار را برای برنامه وب شما جمع‌آوری می‌کند. کیت توسعه نرم‌افزار دو نوع اصلی اطلاعات را ثبت می‌کند:

  • رویدادها: آنچه در برنامه شما اتفاق می‌افتد، مانند کنش‌های کاربر، رویدادهای سیستم، یا خطاها.

  • ویژگی‌های کاربر: مشخصه‌هایی که برای توصیف بخش‌های پایگاه کاربر خود تعریف می‌کنید، مانند اولویت زبان یا مکان جغرافیایی.

Analytics به‌طور خودکار برخی از رویدادها و ویژگی‌های کاربر را ثبت می‌کند؛ برای فعال کردن آن‌ها نیازی به افزودن کد ندارید.

قبل از شروع

اگر قبلاً این کار را نکرده‌اید، Firebase را به پروژه JavaScript خود اضافه کنید و مطمئن شوید که Google Analytics در پروژه Firebase شما فعال است:

  • اگر پروژه Firebase جدیدی ایجاد می‌کنید، Google Analytics را درطول گردش کار ایجاد پروژه فعال کنید.

  • اگر از پروژه Firebase موجودی استفاده می‌کنید که Google Analytics در آن فعال نیست، می‌توانید آن را در تنظیمات > برگه ادغام‌ها فعال کنید.

وقتی Google Analytics را در پروژه‌تان فعال می‌کنید، برنامه‌های وب Firebase شما به جاری‌سازی‌های داده Google Analytics مرتبط با برنامه + دارایی وب پیوند داده می‌شوند.

کیت توسعه نرم‌افزار Analytics را به برنامه‌تان اضافه کنید

بسته به نحوه میزبانی برنامه وب شما، پیکربندی شما ممکن است به‌طور خودکار انجام شود یا ممکن است لازم باشد شیء پیکربندی Firebase خود را به‌روز کنید. اگر برنامه وب شما ازقبل از Google Analytics استفاده می‌کند، ممکن است لازم باشد راه‌اندازی اضافی شرح‌داده‌شده در استفاده از Firebase با برچسب‌گذاری gtag.js موجود را انجام دهید.

  1. بررسی کنید که شیء پیکربندی Firebase در کد شما حاوی measurementId باشد. این شناسه به‌طور خودکار هنگام فعال کردن Analytics در پروژه Firebase و ثبت برنامه وب ایجاد می‌شود و برای استفاده از Analytics لازم است.

    • اگر برنامه‌تان از Firebase Hosting استفاده می‌کند و از نشانی‌های وب رزروشده برای کیت‌های توسعه نرم‌افزار Firebase استفاده می‌کند:

      Firebase به‌طور خودکار پیکربندی برنامه شما را مدیریت می‌کند. برای تکمیل راه‌اندازی، اسکریپت‌های کارت برنامه‌های شما را در تنظیمات پروژه به برچسب <body> برنامه‌تان اضافه کنید (اگر قبلاً این کار را نکرده‌اید).

    • اگر برنامه‌تان از نشانی‌های وب رزروشده استفاده نمی‌کند: اگر با برنامه وب موجودی کار می‌کنید، شیء پیکربندی Firebase را در کدتان به‌روز کنید تا مطمئن شوید فیلد measurementId وجود دارد. شیء پیکربندی باید شبیه نمونه زیر باشد:

      // 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"
};
      ۱. اگر قبلاً این کار را نکرده‌اید، کیت توسعه نرم‌افزار Firebase JS را نصب کنید و Firebase را مقداردهی اولیه کنید. ۲. کیت توسعه نرم‌افزار JS‏ Analytics را اضافه کنید و Analytics را مقداردهی اولیه کنید: * { 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 با برچسب‌گذاری gtag.js موجود

اگر قبلاً Google Analytics را بااستفاده از قطعه gtag.js در برنامه‌تان اجرا می‌کردید، اگر قصد دارید یکی از کارهای زیر را انجام دهید، ممکن است برنامه‌تان به راه‌اندازی بیشتری نیاز داشته باشد:

  • فراخوانی‌های Google Analytics را از Firebase به صفحه اضافه کنید اما همچنین قصد دارید به استفاده از فراخوانی‌های gtag() مستقیماً در همان صفحه ادامه دهید.
  • می‌خواهید از شناسه سنجش یکسانی بین تماس‌های مستقیم gtag() و داده‌های Google Analytics ارسال‌شده به Firebase استفاده کنید.

برای اطمینان از اینکه رویدادهایتان برای استفاده توسط همه سرویس‌های Firebase دردسترس هستند، مراحل راه‌اندازی اضافی زیر را تکمیل کنید:

  • خط gtag('config', 'GA_MEASUREMENT_ID'); را بردارید که در آن GA_MEASUREMENT_ID همان measurementId برنامه وب Firebase شما است. اگر شناسه‌های دیگری برای سایر دارایی‌های Analytics در صفحه دارید، نیازی نیست خط پیکربندی آن‌ها را بردارید.
  • مطمئن شوید که قبل‌از ارسال هر رویدادی با gtag()، firebase.analytics() را فراخوانی کنید.

درغیراین‌صورت، رویدادهای ارسال‌شده به آن شناسه با تماس‌های gtag() با Firebase مرتبط نخواهند شد و برای هدف‌یابی در سایر سرویس‌های Firebase دردسترس نخواهند بود.

شروع کردن ثبت رویدادها

پس‌از مقداردهی اولیه سرویس Analytics، می‌توانید ثبت گزارش رویدادها را با روش logEvent() شروع کنید.

برخی‌از رویدادها برای همه برنامه‌ها توصیه می‌شوند؛ برخی دیگر برای انواع کسب‌وکار یا عمودی‌های خاص توصیه می‌شوند. باید رویدادهای پیشنهادی را همراه با پارامترهای تجویزشده آن‌ها ارسال کنید تا از حداکثر جزئیات دردسترس در گزارش‌هایتان مطمئن شوید و از ویژگی‌ها و ادغام‌های آینده به‌محض دردسترس قرار گرفتن بهره‌مند شوید. این بخش نحوه ثبت کردن رویداد ازپیش تعریف‌شده را نشان می‌دهد، برای اطلاعات بیشتر درباره ثبت کردن رویدادها، به ثبت کردن رویدادها مراجعه کنید.

مثال زیر نشان می‌دهد که چگونه یک رویداد توصیه‌شده را ثبت کنید تا نشان دهید که کاربر در برنامه شما اعلانی دریافت کرده است:

Web

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

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

Web

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

مراحل بعدی