يوضح لك هذا Quickstart كيفية إضافة Google Analytics إلى تطبيقك والبدء في تسجيل الأحداث.
يجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجل SDK نوعين أساسيين من المعلومات:
- الأحداث: ما يحدث في تطبيقك ، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
- خصائص المستخدم: السمات التي تحددها لوصف أجزاء من قاعدة المستخدمين ، مثل تفضيلات اللغة أو الموقع الجغرافي.
يقوم برنامج Analytics تلقائيًا بتسجيل بعض الأحداث وخصائص المستخدم ؛ لا تحتاج إلى إضافة أي كود لتمكينهم.
قبل ان تبدأ
أضف Firebase إلى مشروع JavaScript ، إذا لم تكن قد قمت بذلك بالفعل ، وتأكد من تمكين Google Analytics في مشروع Firebase:
إذا كنت تنشئ مشروع Firebase جديدًا ، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.
إذا كنت تستخدم مشروع Firebase حالي لم يتم تمكين Google Analytics فيه ، فانتقل إلى علامة التبويب "التكامل" في > إعدادات المشروع لتمكينه.
عند تمكين Google Analytics في مشروعك ، يتم ربط تطبيقات Firebase على الويب بتدفقات بيانات Google Analytics المرتبطة بتطبيق + موقع ويب .
أضف Analytics SDK إلى تطبيقك
اعتمادًا على كيفية استضافة تطبيق الويب الخاص بك ، قد تتم معالجة التكوين الخاص بك تلقائيًا أو قد تحتاج إلى تحديث كائن تكوين Firebase . إذا كان تطبيق الويب الخاص بك يستخدم Google Analytics بالفعل ، فقد تحتاج إلى إجراء إعداد إضافي موصوف في استخدام Firebase مع وضع علامات gtag.js الحالية .
تأكد من احتواء كائن تهيئة Firebase في شفرتك على
measurementId
. يتم إنشاء هذا المعرف تلقائيًا عند تمكين Analytics في مشروع Firebase وتسجيل تطبيق ويب ، وهو مطلوب لاستخدام Analytics.إذا كان تطبيقك يستخدم Firebase Hosting ويستخدم عناوين URL محفوظة لحزم Firebase SDK :
يتولى 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" };
إذا لم تكن قد قمت بذلك بالفعل ، فثبّت Firebase JS SDK وقم بتهيئة Firebase .
أضف Analytics JS SDK وقم بتهيئة Analytics:
واجهة برمجة تطبيقات الويب المعيارية
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 namespaced
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 Analytics في تطبيقك باستخدام مقتطف gtag.js ، فقد يتطلب تطبيقك إعدادًا إضافيًا إذا كنت تخطط للقيام بأحد الإجراءات التالية:
- أضف مكالمات Google Analytics من Firebase إلى الصفحة ولكن خطط أيضًا لمواصلة استخدام مكالمات
gtag()
مباشرة على نفس الصفحة. - تريد استخدام نفس معرّف القياس بين مكالمات
gtag()
المباشرة وبيانات Google Analytics المرسلة إلى Firebase.
للتأكد من أن أحداثك متاحة للاستخدام من قبل جميع خدمات Firebase ، أكمل خطوات الإعداد الإضافية التالية:
- إزالة سطر
gtag('config', ' GA_MEASUREMENT_ID ');
حيث يمثلGA_MEASUREMENT_ID
measurementId
لتطبيق الويب Firebase. إذا كانت لديك معرّفات أخرى لمواقع Analytics الأخرى على الصفحة ، فلن تحتاج إلى إزالة سطر التهيئة. - تأكد من استدعاء
firebase.analytics()
قبل إرسال أي أحداث باستخدامgtag()
.
بخلاف ذلك ، لن يتم ربط الأحداث المرسلة إلى هذا المعرّف باستخدام مكالمات gtag()
بـ Firebase ولن تكون متاحة للاستهداف في خدمات Firebase الأخرى.
بدء تسجيل الأحداث
بعد تهيئة خدمة Analytics ، يمكنك البدء في تسجيل الأحداث باستخدام طريقة logEvent()
.
يوصى بأحداث معينة لجميع التطبيقات ؛ ينصح البعض الآخر لأنواع أعمال أو قطاعات معينة. يجب عليك إرسال الأحداث المقترحة جنبًا إلى جنب مع معلماتها المحددة ، لضمان أقصى قدر من التفاصيل المتاحة في تقاريرك والاستفادة من الميزات وعمليات الدمج المستقبلية عند توفرها. يوضح هذا القسم تسجيل حدث محدد مسبقًا ، لمزيد من المعلومات حول تسجيل الأحداث ، راجع أحداث السجل .
يوضح المثال التالي كيفية تسجيل حدث موصى به للإشارة إلى أن المستخدم قد تلقى إشعارًا في تطبيقك:
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web namespaced API
firebase.analytics().logEvent('notification_received');
الخطوات التالية
- استخدم DebugView للتحقق من الأحداث الخاصة بك.
- استكشف بياناتك في وحدة تحكم Firebase .
- استكشف أدلة الأحداث وخصائص المستخدم.
- تعرّف على كيفية تصدير بياناتك إلى BigQuery.