رویدادهای گزارش

انتخاب پلاتفرم: iOS+ Android وب Flutter Unity C++


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

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

قبل از شروع

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

رویدادهای گزارش

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

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

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

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

Web

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

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

Web

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

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

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

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

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

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

Web

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

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

Web

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

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

در کنسول Firebase، می‌توانید آمار انبوهشی رویدادهایتان را در داشبورد Analytics > رویدادها مشاهده کنید.

درباره این داشبورد به موارد زیر توجه کنید:

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

  • داشبورد به‌طور دوره‌ای درطول روز به‌روزرسانی می‌شود. برای آزمایش فوری، از DebugView استفاده کنید.