Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

ثبت رویدادها

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

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

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

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

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

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

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

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

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

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

ثبت رویدادها

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

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

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

  • رویدادهای پیشنهادی: لیست ثابت های 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 ثبت‌شده توسط برنامه شما ایجاد می‌شوند. درباره داشبورد گزارش Analytics در مرکز راهنمایی Firebase بیشتر بخوانید.

،

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

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

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

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

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

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

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

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

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

ثبت رویدادها

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

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

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

  • رویدادهای پیشنهادی: لیست ثابت های 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 ثبت‌شده توسط برنامه شما ایجاد می‌شوند. درباره داشبورد گزارش Analytics در مرکز راهنمایی Firebase بیشتر بخوانید.