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

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك، وتسجِّل نوعين أساسيين من المعلومات:

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

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

للوصول إلى هذه البيانات:

  1. افتح مشروعك في وحدة تحكُّم Firebase.
  2. اختَر إحصاءات Google من القائمة لعرض لوحة بيانات إعداد التقارير في "إحصاءات Google".

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

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

قبل البدء

قبل أن تتمكّن من استخدام إحصاءات Google، عليك إجراء ما يلي:

  • سجّل مشروع C++ الخاص بك واضبطه لاستخدام Firebase.

    إذا كان مشروعك على C++ يستخدم Firebase بالفعل، فإنه قد تم تسجيله وإعداده لـ Firebase.

  • أضِف حزمة تطوير البرامج (SDK) لـ Firebase C++ إلى مشروع C++.

تجدر الإشارة إلى أنّ إضافة Firebase إلى مشروع C++ تتضمّن مهامًا في وحدة تحكُّم Firebase وفي مشروع C++ المفتوح (على سبيل المثال، يمكنك تنزيل ملفات إعداد Firebase من وحدة التحكّم، ثم نقلها إلى مشروع C++ ).

إنشاء تطبيق firebase وإعداده

قبل البدء، يجب إنشاء تطبيق firebase وإعداده:

Android

أنشئ تطبيق firebase، مع تمرير بيئة jni ومرجع jobject إلى نشاط جافا كوسيطات:

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

إعداد مكتبة "إحصاءات Google": 

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

iOS+

إنشاء تطبيق firebase:

app = ::firebase::App::Create(::firebase::AppOptions());

إعداد مكتبة "إحصاءات Google": 

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

تسجيل الأحداث

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

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

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

الخطوات اللاحقة