بدء استخدام "إحصاءات Google" للغة C++

اختيار المنصة: iOS+ Android الويب Flutter Unity C++‎


تجمع حزمة تطوير البرامج (SDK) Google Analytics بيانات الاستخدام وبيانات السلوك لتطبيقك، وتسجّل نوعَين أساسيَّين من المعلومات:

  • الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء
  • خصائص المستخدمين: هي سمات تحدّدها لوصف شرائح من قاعدة المستخدمين لديك، مثل اللغة المفضّلة أو الموقع الجغرافي.

تسجّل "Analytics" تلقائيًا بعض الأحداث وخصائص المستخدمين، ولست بحاجة إلى إضافة أي رمز لتفعيلها. إذا كان تطبيقك بحاجة إلى جمع بيانات إضافية، يمكنك إعداد ما يصل إلى 25 خاصية مستخدم مختلفة في Analytics وتسجيل ما يصل إلى 500 نوع مختلف من أحداث Analytics في تطبيقك. ليس هناك حدّ أقصى لإجمالي عدد الأحداث التي يسجّلها تطبيقك.

يمكنك الوصول إلى هذه البيانات في صفحات الإحصاءات في وحدة تحكّم "Firebase".

تعرض صفحة إحصاءات Google > الأحداث تقارير الأحداث التي يتم إنشاؤها تلقائيًا لكل نوع مميز من أحداث Analytics التي يسجلها تطبيقك. يمكنك قراءة المزيد عن لوحة البيانات.

لمساعدتك في البدء، تحدّد حزمة تطوير البرامج (SDK) لخدمة "Analytics" عددًا من الأحداث المقترَحة الشائعة بين أنواع مختلفة من التطبيقات، بما في ذلك تطبيقات البيع بالتجزئة والتجارة الإلكترونية والسفر والألعاب. لمزيد من المعلومات عن هذه الأحداث وحالات استخدامها، يُرجى الاطّلاع على الأحداث المقترَحة. للحصول على أكبر قدر من التفاصيل في التقارير، سجِّل الأحداث المقترَحة التي تناسب تطبيقك ومَعلماتها المخصَّصة. يضمن ذلك أيضًا استفادتك من أحدث ميزات Google Analytics فور توفّرها.

قبل البدء

قبل أن تتمكّن من استخدام Google Analytics، عليك تنفيذ ما يلي:

  • سجِّل مشروع C++‎ وأعدَّه لاستخدام Firebase.

    إذا كان مشروعك المكتوب بلغة C++‎ يستخدم Firebase حاليًا، يعني ذلك أنّه مسجَّل ومُعدّ مسبقًا لاستخدام Firebase.

  • أضِف حزمة تطوير البرامج (SDK) لـ 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);

الخطوات التالية