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

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


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

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

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

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

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

قبل از شروع

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

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

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

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

‫Analytics SDK را به برنامه‌تان اضافه کنید

بسته به اینکه برنامه وب شما چگونه میزبانی می‌شود، پیکربندی شما ممکن است به‌طور خودکار مدیریت شود یا ممکن است لازم باشد شیء پیکربندی 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"
};
      <0 اگر قبلاً این کار را نکرده‌اید، «کیت توسعه نرم‌افزار 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');

مراحل بعدی