توضّح لك هذه البداية السريعة كيفية إضافة "إحصاءات Google" إلى تطبيقك وبدء تسجيل الأحداث.
تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك، وتسجِّل نوعين أساسيين من المعلومات:
- الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
- خصائص المستخدِمين: السمات التي تحدّدها لوصف شرائح من قاعدة المستخدمين، مثل تفضيل اللغة أو الموقع الجغرافي.
تسجِّل "إحصاءات Google" تلقائيًا بعض الأحداث وخصائص المستخدمين، ولن تحتاج إلى إضافة أي رمز لتفعيلها.
قبل البدء
أضِف Firebase إلى مشروع JavaScript إذا لم يسبق لك إجراء ذلك وتأكَّد من تفعيل "إحصاءات Google" في مشروع Firebase:
إذا كنت بصدد إنشاء مشروع جديد على Firebase، فعِّل "إحصاءات Google" أثناء سير عمل إنشاء المشروع.
في حال استخدام مشروع حالي على Firebase لم يتم تفعيل "إحصاءات Google" عليه، انتقِل إلى علامة تبويب عمليات الدمج ضمن
لتفعيله. > إعدادات المشروع
عند تفعيل "إحصاءات Google" في مشروعك، يتم ربط تطبيقات الويب على Firebase بمصادر بيانات "إحصاءات Google" المرتبطة بأحد التطبيقات + المواقع الإلكترونية.
إضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" إلى تطبيقك
استنادًا إلى كيفية استضافة تطبيق الويب، قد تتم معالجة الإعدادات تلقائيًا أو قد تحتاج إلى تعديل كائن إعداد Firebase. إذا كان تطبيق الويب يستخدم "إحصاءات Google" حاليًا، قد تحتاج إلى إجراء إعداد إضافي موضّح في استخدام Firebase مع علامات gtag.js الحالية.
تأكَّد من أنّ كائن إعداد Firebase في الرمز يحتوي على
measurementId
. ويتم إنشاء هذا المعرّف تلقائيًا عند تفعيل "إحصاءات Google" في مشروعك على Firebase وتسجيل تطبيق ويب، وهذا المعرّف مطلوب لاستخدام "إحصاءات Google".إذا كان تطبيقك يستخدم "استضافة Firebase" وكان يستخدم عناوين URL محجوزة لحِزم تطوير البرامج (SDK) لمنصّة Firebase:
يعالج Firebase تلقائيًا عملية ضبط تطبيقك. لإكمال عملية الإعداد، أضِف النصوص البرمجية من بطاقة تطبيقاتك في إعدادات المشروع إلى علامة <body> في تطبيقك، إذا لم يسبق لك إجراء ذلك.
إذا كان تطبيقك لا يستخدم عناوين URL محجوزة: إذا كنت تعمل مع تطبيق ويب حالي، عليك تعديل كائن إعداد Firebase في الرمز البرمجي لضمان توفّر الحقل
measurementId
. من المفترض أن يبدو كائن الضبط مشابهًا للمثال التالي:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
ثبِّت حزمة تطوير البرامج (SDK) لـ Firebase JS وابدأ في تهيئة Firebase، إذا لم يسبق لك إجراء ذلك.
إضافة حزمة تطوير البرامج (SDK) JS لخدمة "إحصاءات Google" وإعداد "إحصاءات Google":
Web
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
Web
import firebase from "firebase/compat/app"; import "firebase/compat/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
استخدام Firebase مع علامات gtag.js الحالية
إذا سبق لك تشغيل "إحصاءات Google" في تطبيقك باستخدام مقتطف gtag.js، قد يتطلب تطبيقك إعدادًا إضافيًا إذا كنت تخطط لتنفيذ أحد الإجراءات التالية:
- يمكنك إضافة استدعاءات "إحصاءات Google" من Firebase إلى الصفحة مع التخطيط أيضًا
لمتابعة استخدام استدعاءات
gtag()
مباشرةً على الصفحة نفسها. - تريد استخدام رقم تعريف القياس نفسه بين كلّ من مكالمات
gtag()
المباشرة وبيانات "إحصاءات Google" المُرسَلة إلى Firebase.
لضمان إمكانية استخدام الأحداث من خلال جميع خدمات Firebase، أكمِل خطوات الإعداد الإضافية التالية:
- أزِل السطر
gtag('config', 'GA_MEASUREMENT_ID');
حيث يكونGA_MEASUREMENT_ID
هوmeasurementId
لتطبيق الويب على Firebase. وإذا كانت لديك أرقام تعريف أخرى لمواقع "إحصاءات Google" الأخرى على الصفحة، لن تحتاج إلى إزالة سطر الضبط المتعلق بها. - تأكَّد من الاتصال بالرقم
firebase.analytics()
قبل إرسال أي أحداث مع "gtag()
".
وبخلاف ذلك، لن يتم ربط الأحداث المُرسَلة إلى رقم التعريف هذا باستخدام استدعاءات gtag()
بمنصة Firebase ولن تكون متاحة للاستهداف في
خدمات Firebase الأخرى.
بدء تسجيل الأحداث
بعد إعداد
خدمة "إحصاءات Google"، يمكنك
البدء في تسجيل الأحداث باستخدام الطريقة
logEvent()
.
يُنصَح باستخدام أحداث معيّنة لجميع التطبيقات، ويُنصَح أيضًا باستخدام أحداث أخرى لأنواع أنشطة تجارية أو مجالات معيّنة. يجب إرسال الأحداث المقترَحة مع مَعلماتها المخصَّصة لضمان توفير أكبر قدر ممكن من التفاصيل في تقاريرك وللاستفادة من الميزات وعمليات الدمج المستقبلية عند توفّرها. يوضّح هذا القسم كيفية تسجيل حدث محدّد مسبقًا. لمزيد من المعلومات عن تسجيل الأحداث، اطّلِع على مقالة تسجيل الأحداث.
يوضِّح المثال التالي كيفية تسجيل حدث مقترَح للإشارة إلى أنّ المستخدم قد تلقّى إشعارًا في تطبيقك:
Web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web
firebase.analytics().logEvent('notification_received');
الخطوات اللاحقة
- فهم كل تقرير في "إحصاءات Google"
- استخدِم DebugView للتحقّق من أحداثك.
- استكشِف بياناتك في وحدة تحكُّم Firebase.
- يمكنك استكشاف الأدلة حول الأحداث وخصائص المستخدم.
- تعرّف على كيفية تصدير بياناتك إلى BigQuery.