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

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

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

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

للوصول إلى هذه البيانات، اتّبِع الخطوات التالية:

  1. في وحدة تحكّم Firebase، افتح مشروعك.
  2. انقر على Analytics من القائمة لعرض لوحة بيانات إعداد التقارير Analytics.

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

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

قبل البدء

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

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

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

  • أضِف Firebase C++ SDK إلى مشروع C++.

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

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

قبل البدء، عليك إنشاء تطبيق Firebase وإعداده على النحو التالي:

Android

أنشئ تطبيق Firebase، مع تمرير بيئة JNI ومرجع إلى نشاط Java كمعلَمات:jobject

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

ابدأ مكتبة Analytics: 

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

iOS+‎

أنشئ تطبيق Firebase:

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

ابدأ مكتبة Analytics: 

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

أحداث السجلّ

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

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

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

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