شروع به کار با Google Analytics برای C++‎

انتخاب پلاتفرم: iOS+ Android وب Flutter Unity C++


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

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

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

می‌توانید به این داده‌ها در صفحات Analytics کنسول Firebase دسترسی داشته باشید.

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

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

قبل از شروع

پیش‌از اینکه بتوانید از Google Analytics استفاده کنید، باید:

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

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

  • کیت توسعه نرم‌افزار Firebase C++ را به پروژه ++C خود اضافه کنید.

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

ایجاد و مقداردهی اولیه برنامه firebase

قبل‌از شروع، باید برنامه firebase را ایجاد و مقداردهی اولیه کنید:

iOS+‎

برنامه firebase را ایجاد کنید:

app = ::firebase::App::Create(::firebase::AppOptions());

مقداردهی اولیه کتابخانه Analytics: 

::firebase::analytics::Initialize(app);

Android

برنامه firebase را ایجاد کنید، محیط jni و یک jobject مرجع به فعالیت java را به‌عنوان آرگومان ارسال کنید:

app = ::firebase::App::Create(::firebase::AppOptions(), jni_env, activity);

مقداردهی اولیه کتابخانه Analytics: 

::firebase::analytics::Initialize(app);

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

پس‌از پیکربندی نمونه firebase::App، می‌توانید ثبت رویدادها را با روش LogEvent() شروع کنید.

مثال زیر امتیاز کاربر را به‌روز می‌کند:

analytics::LogEvent(analytics::kEventPostScore, analytics::kParameterScore, 42);

مراحل بعدی