ثبت رویدادها

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

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

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

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

مطمئن شوید که پروژه خود را راه‌اندازی کرده‌اید و می‌توانید طبق توضیحات «شروع به کار با Analytics» به Analytics دسترسی داشته باشید.

ثبت رویدادها

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

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

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

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

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

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

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

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

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

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

  پارامترهای سفارشی را می‌توان در تعریف مخاطب استفاده کرد که ممکن است برای هر گزارش اعمال شود. اگر برنامه شما به یک پروژه 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 به این داده‌ها دسترسی داشته باشید. این داشبورد گزارش‌های رویدادی را نشان می‌دهد که به طور خودکار برای هر نوع رویداد مجزا که توسط برنامه شما ثبت شده است، ایجاد می‌شوند.