ثبت رویدادها

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

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

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

قبل از اینکه بتوانید Google Analytics استفاده کنید، باید:

• پروژه یونیتی خود را ثبت کنید و آن را برای استفاده از فایربیس پیکربندی کنید.

  • اگر پروژه یونیتی شما از قبل از فایربیس استفاده می‌کند، پس از قبل برای فایربیس ثبت و پیکربندی شده است.

  • اگر پروژه یونیتی ندارید، می‌توانید یک برنامه نمونه را دانلود کنید.

• کیت توسعه نرم‌افزاری (SDK) مربوط به Firebase Unity (به‌طور خاص، FirebaseAnalytics.unitypackage ) را به پروژه Unity خود اضافه کنید.

دستورالعمل‌های دقیق برای این وظایف راه‌اندازی اولیه را در «افزودن فایربیس به پروژه یونیتی خود» بیابید.

توجه داشته باشید که اضافه کردن Firebase به پروژه Unity شما شامل وظایفی هم در کنسول Firebase و هم در پروژه Unity باز شما می‌شود (برای مثال، شما فایل‌های پیکربندی Firebase را از کنسول دانلود می‌کنید، سپس آنها را به پروژه Unity خود منتقل می‌کنید).

ثبت رویدادها

پس از اینکه ماژول Firebase.Analytics.FirebaseAnalytics را مقداردهی اولیه کردید، می‌توانید از آن برای ثبت رویدادها با استفاده از متد LogEvent() استفاده کنید.

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

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

می‌توانید جزئیات پیاده‌سازی رویدادهای توصیه‌شده را در مکان‌های زیر پیدا کنید:

• رویدادهای پیشنهادی: به فهرست ثابت‌های Event مراجعه کنید.
• پارامترهای از پیش تعیین‌شده: به فهرست ثابت‌های Parameters مراجعه کنید.

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

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

• پارامترهای سفارشی: پارامترهای سفارشی مستقیماً در گزارش‌های Analytics شما نمایش داده نمی‌شوند، اما می‌توانند به عنوان فیلترهایی در تعاریف مخاطب استفاده شوند که می‌توانند برای هر گزارش اعمال شوند. پارامترهای سفارشی همچنین در داده‌های صادر شده به BigQuery در صورتی که برنامه شما به یک پروژه BigQuery مرتبط باشد، گنجانده می‌شوند.

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

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

مشاهده رویدادها در خروجی لاگ

اندروید

شما می‌توانید ثبت وقایع به صورت شفاهی (verbose logging) را در گزارش اشکال‌زدایی اندروید استودیو (Android Studio Debug Log) فعال کنید تا از ثبت صحیح رویدادها توسط SDK اطمینان حاصل کنید. این شامل رویدادهای ثبت شده به صورت خودکار و دستی می‌شود.

شما می‌توانید با استفاده از یک سری دستورات adb، قابلیت ثبت وقایع شفاهی (verbose logging) را فعال کنید:

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

این دستور رویدادهای شما را در فایل لاگ اندروید استودیو نمایش می‌دهد و به شما کمک می‌کند تا فوراً تأیید کنید که رویدادها ارسال می‌شوند.

آی‌او‌اس+

رویدادها در کنسول ثبت می‌شوند و می‌توان آن‌ها را هنگام اجرای برنامه از طریق XCode مشاهده کرد.

مشاهده رویدادهای تحلیلی در داشبورد

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

برای دسترسی به این داده‌ها در کنسول Firebase :

1. در کنسول Firebase ، پروژه خود را باز کنید.
2. برای مشاهده داشبورد گزارش‌های Analytics از منو، Analytics را انتخاب کنید.

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