این شروع سریع به شما نشان می دهد که چگونه 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 موجود توضیح داده شده است انجام دهید.
بررسی کنید که شیء پیکربندی 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" };
اگر قبلاً این کار را نکردهاید، Firebase JS SDK را نصب کرده و Firebase را مقداردهی اولیه کنید .
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');
مراحل بعدی
- هر گزارش Analytics را درک کنید.
- از DebugView برای تأیید رویدادهای خود استفاده کنید.
- داده های خود را در کنسول Firebase کاوش کنید.
- راهنماهای رویدادها و ویژگی های کاربر را کاوش کنید.
- بیاموزید که چگونه داده های خود را به BigQuery صادر کنید.