ثبت رویدادها

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

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

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

مطمئن شوید که پروژه خود را راه‌اندازی کرده‌اید و می‌توانید همانطور که در Get Started with Analytics توضیح داده شد به Analytics دسترسی داشته باشید.

ثبت رویدادها

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

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

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

می‌توانید جزئیات پیاده‌سازی چندین رویداد و پارامترهای آنها را در مرجع رویداد gtag.js بیابید .

مثال زیر نحوه ثبت رویداد select_content را نشان می دهد:

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

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

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

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

• پارامترهای سفارشی: پارامترهای سفارشی را می توان به عنوان ابعاد یا معیارها در گزارش های Analytics استفاده کرد. می‌توانید از ابعاد سفارشی برای داده‌های پارامتر رویداد غیر عددی و معیارهای سفارشی برای هر داده پارامتری که به صورت عددی بهتر نمایش داده می‌شود، استفاده کنید. هنگامی که یک پارامتر سفارشی را با استفاده از SDK ثبت کردید، بعد یا متریک را ثبت کنید تا مطمئن شوید که آن پارامترهای سفارشی در گزارش های Analytics ظاهر می شوند. این کار را از طریق: Analytics > Events > Manage Custom Definitions > Create Custom Dimensions انجام دهید

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

• پارامتر value : value یک پارامتر هدف کلی است که برای جمع آوری یک معیار کلیدی که مربوط به یک رویداد است مفید است. به عنوان مثال می توان به درآمد، مسافت، زمان و امتیاز اشاره کرد.

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

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

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

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

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

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

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