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

اختيار نظام أساسي: iOS+ Android Web Flutter Unity C++


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

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

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

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

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

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

قبل البدء

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

  • تسجيل مشروع C++ وإعداده لاستخدام Firebase

    إذا كان مشروع C++ يستخدم Firebase حاليًا، يكون مسجّلاً ومعدًّا لاستخدام Firebase.

  • إضافة حزمة Firebase C++ SDK إلى مشروع 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);

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