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

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

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

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

تجزیه و تحلیل ترافیک به طور خودکار سیاهههای مربوط به برخی حوادث و خواص کاربران ؛ برای فعال کردن آنها نیازی به اضافه کردن کد ندارید.

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

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

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

  • اگر شما با استفاده از پروژه های موجود فایربیس که لازم نیست گوگل آنالیز را فعال کنید، رفتن به یکپارچگی تب از خود > تنظیمات پروژه به آن را فعال کنید.

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

Analytics SDK را به برنامه خود اضافه کنید

بسته به اینکه چگونه برنامه تحت وب خود میزبانی شده است، پیکربندی خود را ممکن است به صورت خودکار به کار گرفته و یا شما ممکن است نیاز به به روز رسانی خود را شیء پیکربندی فایربیس . اگر برنامه وب شما در حال حاضر استفاده از گوگل آنالیز، شما ممکن است نیاز به انجام تنظیمات اضافی در توصیف استفاده فایربیس با gtag.js موجود برچسب زدن .

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

    • اگر برنامه خود را با استفاده از فایربیس میزبانی و استفاده محفوظ آدرس ها برای فایربیس SDK ها:

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

    • اگر برنامه خود را، نشانیهای اینترنتی محفوظ استفاده کنید: اگر شما در حال کار با یک برنامه وب موجود، به روز رسانی شی پیکربندی فایربیس در کد خود را برای اطمینان از 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"
      };
      
  2. راه اندازی Firebase Analytics:

نسخه وب 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

نسخه وب 8

const analytics = firebase.analytics();

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

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

  • اضافه کردن تماس های گوگل آنالیز از Firebase به صفحه بلکه برنامه ای برای ادامه با استفاده از gtag() تماس به طور مستقیم در همان صفحه.
  • آیا می خواهید به استفاده از ID های اندازه گیری همان بین هر دو مستقیم gtag() تماس و اطلاعات Google Analytics فرستاده شده به فایربیس.

برای اطمینان از اینکه رویدادهای شما برای استفاده توسط همه سرویس‌های Firebase در دسترس هستند، مراحل راه‌اندازی اضافی زیر را تکمیل کنید:

  • حذف خط gtag('config', ' GA_MEASUREMENT_ID '); که در آن GA_MEASUREMENT_ID است measurementId برنامه وب شما فایربیس. اگر شناسه های دیگری برای سایر ویژگی های Analytics در صفحه دارید، نیازی به حذف خط پیکربندی آنها ندارید.
  • مطمئن شوید که شما پاسخ firebase.analytics() قبل از ارسال هیچ رویدادی با gtag() .

در غیر این صورت، حوادث به آن ID با ارسال gtag() تماس خواهد با Firebase نمی شود همراه است و نمی خواهد برای هدف قرار دادن در سایر خدمات فایربیس در دسترس باشد.

ثبت رویدادها را شروع کنید

پس از مقداردهی اولیه اند خدمات تجزیه و تحلیل ترافیک ، شما می توانید شروع به ورود حوادث با logEvent() روش.

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

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

نسخه وب 9

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

نسخه وب 8

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

مراحل بعدی