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

اختيار النظام الأساسي: iOS+ Android الويب Flutter Unity C++‎


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

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

تسجّل 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);

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