با Google Analytics شروع کنید

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

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

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

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

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

قبل از اینکه شروع کنی

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

  • اگر در حال ایجاد یک پروژه Firebase هستید، Google Analytics را در جریان کار ایجاد پروژه فعال کنید.

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

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

Analytics SDK را به برنامه خود اضافه کنید

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

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

    • اگر برنامه شما از میزبانی Firebase استفاده می کند و از URL های رزرو شده برای Firebase SDK استفاده می کند :

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

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

      // 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. اگر قبلاً این کار را نکرده‌اید، Firebase JS SDK را نصب کرده و Firebase را مقداردهی اولیه کنید .

  3. Analytics JS SDK را اضافه کنید و Analytics را مقداردهی اولیه کنید:

API ماژولار وب

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);

API با فضای نام وب

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 modular API

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

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

Web namespaced API

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

مراحل بعدی