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

انتخاب پلاتفرم: iOS+ Android Web 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 استفاده کنید.