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