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

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

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

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

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

  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 وjobject إشارة إلى نشاط java كوسيطات:

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);

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