با 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 Hosting استفاده می کند و از 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: "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. اگر قبلاً این کار را نکرده‌اید، Firebase JS SDK را نصب کرده و Firebase را مقداردهی اولیه کنید .

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

WebWeb

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


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() ثبت رویدادها را شروع کنید.

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

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

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js
firebase.analytics().logEvent('notification_received');
index.js

مراحل بعدی

،


این شروع سریع به شما نشان می دهد که چگونه 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 Hosting استفاده می کند و از 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: "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. اگر قبلاً این کار را نکرده‌اید، Firebase JS SDK را نصب کرده و Firebase را مقداردهی اولیه کنید .

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

WebWeb

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


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() ثبت رویدادها را شروع کنید.

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

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

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js
firebase.analytics().logEvent('notification_received');
index.js

مراحل بعدی

،


این شروع سریع به شما نشان می دهد که چگونه 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 Hosting استفاده می کند و از URL های رزرو شده برای SDK های Firebase استفاده می کند :

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

    • اگر برنامه شما از URL های رزرو شده استفاده نمی کند : اگر با یک برنامه وب موجود کار می کنید ، شیء پیکربندی 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"
};

  2. اگر قبلاً این کار را نکرده اید ، Firebase JS SDK را نصب کرده و Firebase را اولیه کنید .

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

WebWeb

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


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 در دسترس نخواهد بود.

شروع به ورود به سیستم رویدادها

بعد از شروع سرویس تحلیلی ، می توانید با روش logEvent() شروع به ورود به رویدادها کنید.

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

مثال زیر نحوه ورود به یک رویداد پیشنهادی را نشان می دهد تا نشان دهد کاربر در برنامه شما اعلان دریافت کرده است:

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js
firebase.analytics().logEvent('notification_received');
index.js

مراحل بعدی