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

  • أضِف حزمة تطوير البرامج 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 ومرجع إلى نشاط Java كمعلَمات:jobject

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

ابدأ مكتبة Analytics: 

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

أحداث السجلّ

بعد ضبط مثيل firebase::App، يمكنك البدء في تسجيل الأحداث باستخدام طريقة LogEvent().

يعدّل المثال التالي نتيجة المستخدم:

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

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