با Google Analytics for Unity شروع کنید

Google Analytics داده های استفاده و رفتار برنامه شما را جمع آوری می کند. SDK دو نوع اطلاعات اصلی را ثبت می کند:

  • رویدادها: آنچه در برنامه شما اتفاق می افتد، مانند اقدامات کاربر، رویدادهای سیستم یا خطاها.
  • ویژگی های کاربر: ویژگی هایی که برای توصیف بخش هایی از پایگاه کاربر خود تعریف می کنید، مانند ترجیح زبان یا موقعیت جغرافیایی.

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

برای دسترسی به این داده ها:

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

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

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

قبل از شروع

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

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

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

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

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

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

ثبت رویدادها

شما می توانید بلافاصله با متد LogEvent() شروع به ثبت رویدادها کنید.

مثال زیر رویدادها را با انواع مختلفی از آرگومان ها ثبت می کند:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

مراحل بعدی

،

Google Analytics داده های استفاده و رفتار برنامه شما را جمع آوری می کند. SDK دو نوع اطلاعات اصلی را ثبت می کند:

  • رویدادها: آنچه در برنامه شما اتفاق می افتد، مانند اقدامات کاربر، رویدادهای سیستم یا خطاها.
  • ویژگی های کاربر: ویژگی هایی که برای توصیف بخش هایی از پایگاه کاربر خود تعریف می کنید، مانند ترجیح زبان یا موقعیت جغرافیایی.

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

برای دسترسی به این داده ها:

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

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

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

قبل از شروع

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

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

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

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

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

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

ثبت رویدادها

می توانید بلافاصله با متد LogEvent() شروع به ثبت رویدادها کنید.

مثال زیر رویدادها را با انواع مختلفی از آرگومان ها ثبت می کند:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

مراحل بعدی