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


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

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

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

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

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

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

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

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

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

کیت توسعه نرم‌افزار (SDK) Analytics را به برنامه خود اضافه کنید.

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

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

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

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

    • اگر برنامه شما از 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. SDK Analytics JS را اضافه کنید و 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();

استفاده از فایربیس با برچسب‌گذاری gtag.js موجود

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

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

برای اطمینان از اینکه رویدادهای شما برای استفاده توسط همه سرویس‌های 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');
analytics_log_event.js

Web 

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

مراحل بعدی