این شروع سریع به شما نشان می دهد که چگونه Google Analytics به برنامه خود اضافه کنید و شروع به ثبت رویدادها کنید.
Google Analytics داده های استفاده و رفتار برنامه شما را جمع آوری می کند. SDK دو نوع اطلاعات اصلی را ثبت می کند:
- رویدادها: آنچه در برنامه شما اتفاق می افتد، مانند اقدامات کاربر، رویدادهای سیستم یا خطاها.
- ویژگی های کاربر: ویژگی هایی که برای توصیف بخش هایی از پایگاه کاربر خود تعریف می کنید، مانند ترجیح زبان یا موقعیت جغرافیایی.
Analytics به طور خودکار برخی رویدادها و ویژگی های کاربر را ثبت می کند. برای فعال کردن آنها نیازی به اضافه کردن کد ندارید.
قبل از شروع
اگر قبلاً این کار را نکردهاید، Firebase را به پروژه جاوا اسکریپت خود اضافه کنید و مطمئن شوید که Google Analytics در پروژه Firebase شما فعال است:
اگر در حال ایجاد یک پروژه Firebase هستید، Google Analytics در جریان کار ایجاد پروژه فعال کنید.
اگر از یک پروژه Firebase موجود استفاده می کنید که Google Analytics فعال نکرده است، به برگه ادغام ها بروید.
Analytics SDK را به برنامه خود اضافه کنید
بررسی کنید که شیء پیکربندی 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: "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" };
اگر قبلاً این کار را نکردهاید، Firebase JS SDK را نصب کرده و Firebase را مقداردهی اولیه کنید . Analytics JS SDK را اضافه کنید و 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 را از Firebase به صفحه اضافه کنید، اما همچنین قصد دارید از تماسهای gtag()
مستقیماً در همان صفحه استفاده کنید.می خواهید از همان شناسه اندازه گیری بین تماس های مستقیم gtag()
و داده های Google Analytics ارسال شده به Firebase استفاده کنید.
حذف خط gtag('config', ' GA_MEASUREMENT_ID ');
جایی کهGA_MEASUREMENT_ID
measurementId
برنامه وب Firebase شما است. اگر شناسه های دیگری برای سایر ویژگی های Analytics در صفحه دارید، نیازی به حذف خط پیکربندی آنها ندارید.قبل از ارسال هر رویدادی با gtag()
مطمئن شوید که باfirebase.analytics()
تماس گرفته اید.
gtag()
به آن شناسه ارسال میشوند، با Firebase مرتبط نمیشوند و برای هدفیابی در سایر سرویسهای Firebase در دسترس نیستند.
ثبت رویدادها را شروع کنید
logEvent()
ثبت رویدادها را شروع کنید.
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web
firebase.analytics().logEvent('notification_received');
مراحل بعدی
هر گزارش Analytics را درک کنید. از DebugView برای تأیید رویدادهای خود استفاده کنید. داده های خود را در کنسول Firebase کاوش کنید. راهنماهای رویدادها و ویژگی های کاربر را کاوش کنید. بیاموزید که چگونه داده های خود را به BigQuery صادر کنید.