ثبت رویدادها

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

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

قبل از شروع

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

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

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

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

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

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

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

ثبت رویدادها

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

برای کمک به شروع، Analytics SDK تعدادی رویداد توصیه شده را تعریف می‌کند که در بین انواع مختلف برنامه‌ها، از جمله برنامه‌های خرده‌فروشی و تجارت الکترونیک، سفر، و بازی مشترک هستند. برای کسب اطلاعات بیشتر در مورد این رویدادها و زمان استفاده از آنها، به مقالات رویدادهای توصیه شده در مرکز راهنمای Google 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);

رویدادها را در خروجی گزارش مشاهده کنید

اندروید

برای کمک به تأیید اینکه رویدادها به‌درستی توسط SDK ثبت می‌شوند، می‌توانید ثبت‌نام کامل را در گزارش اشکال‌زدایی Android Studio فعال کنید. این شامل رویدادهای ثبت شده به صورت خودکار و دستی می شود.

شما می‌توانید با یک سری دستورات adb، گزارش کامل را فعال کنید:

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

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

iOS+

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

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

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

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

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

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