Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

  • رویدادها: آنچه که در برنامه شما اتفاق می افتد، مانند اقدامات کاربر، حوادث سیستم، و یا خطا است.

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

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

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

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

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

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

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

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

بسته به اینکه چگونه برنامه تحت وب خود میزبانی شده است، پیکربندی خود را ممکن است به صورت خودکار به کار گرفته و یا شما ممکن است نیاز به به روز رسانی خود را شیء پیکربندی فایربیس . اگر برنامه وب شما در حال حاضر استفاده از گوگل آنالیز، شما ممکن است نیاز به انجام تنظیمات اضافی در توصیف استفاده فایربیس با 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');

مراحل بعدی