بدء استخدام "إحصاءات 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);

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