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

ثبت وقایع

این راهنما به شما نشان می دهد که چگونه رویدادها را در برنامه خود ثبت کنید.

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

تجزیه و تحلیل ترافیک به طور خودکار سیاهههای مربوط به برخی حوادث برای شما؛ برای دریافت آنها نیازی به افزودن کد ندارید. اگر برنامه شما نیاز به جمع آوری داده های اضافی، شما می توانید به 500 نوع مختلف رویداد Analytics در برنامه خود وارد شوید تا. هیچ محدودیتی در حجم کل رویدادهایی که برنامه شما ثبت می کند وجود ندارد. توجه داشته باشید که نام رویدادها به حروف کوچک و کوچک حساس هستند و ثبت دو رویداد که نام آنها فقط در مورد متفاوت است منجر به دو رویداد مجزا می شود.

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

اطمینان حاصل کنید که شما در راه اندازی پروژه خود را و همان طور که در می توانید تجزیه و تحلیل ترافیک دسترسی به کار با تجزیه و تحلیل ترافیک آغاز شده .

ثبت رویدادها

پس از پیکربندی شده اند firebase.analytics() به عنوان مثال، شما می توانید شروع به ورود به سیستم حوادث با logEvent() روش. اگر شما در حال حاضر با گوگل آنالیز آشنا هستید، این روش معادل با استفاده از است event فرمان در gtag.js .

برای شروع به کار ، SDK Analytics تعدادی از رویدادهای پیشنهادی را تعریف می کند که در بین انواع مختلف برنامه ها رایج است ، از جمله برنامه های خرده فروشی و تجارت الکترونیک ، مسافرت و بازی. برای کسب اطلاعات بیشتر در مورد این وقایع و هنگامی که به استفاده از آنها، فهرست رویدادها و خواص مقالات در مرکز راهنمایی فایربیس.

توجه: برای به دست آوردن حداکثر جزئیات در گزارش، ورود به سیستم از حوادث نشان می دهد که حس برای برنامه شما و پارامترهای تجویز می کنند. این امر همچنین تضمین می کند که از جدیدترین ویژگی های Google Analytics به محض در دسترس بودن بهره مند شوید.

شما می توانید جزئیات پیاده سازی برای رویدادهای مختلف و پارامترهای خود را در پیدا مرجع gtag.js رویداد .

در مثال زیر، چگونه برای ورود select_content رویداد:

نسخه وب 9

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

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

نسخه وب 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

علاوه بر پارامترهای تجویز شده ، می توانید پارامترهای زیر را به هر رویدادی اضافه کنید:

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

اگر برنامه شما نیازهای خاصی دارد که تحت پوشش یک نوع رویداد پیشنهادی نیست ، می توانید رویدادهای سفارشی خود را وارد کنید. به عنوان مثال ، اگر در حال توسعه یک بازی هستید و می خواهید پیگیری کنید که کدام بازیکن یک هدف خاص را به پایان رسانده است ، می توانید رویدادی شبیه به مثال زیر را ثبت کنید:

نسخه وب 9

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

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

نسخه وب 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

مشاهده رویدادها در داشبورد

می توانید آمار تجمیع شده درباره رویدادهای خود را در داشبوردهای کنسول Firebase مشاهده کنید. این داشبوردها در طول روز به صورت دوره ای به روز می شوند. برای آزمایش فوری ، از خروجی logcat همانطور که در قسمت قبل توضیح داده شد استفاده کنید.

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