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

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


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

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

قبل از شروع

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

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

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

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

می‌توانید جزئیات پیاده‌سازی را برای چندین رویداد و پارامترهای آن‌ها در مرجع رویداد 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 پیدا کنید.

  • پارامتر 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 استفاده کنید.