Catch up on highlights from Firebase at Google I/O 2023. Learn more

بدء استخدام "إحصاءات Google"

توضح لك هذه البداية السريعة كيفية إضافة 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 الحالية .

  1. تأكد من أن كائن تكوين Firebase الخاص بك في التعليمات البرمجية الخاصة بك يحتوي على measurementId . يتم إنشاء هذا المعرف تلقائيًا عند تمكين Analytics في مشروع Firebase الخاص بك وتسجيل تطبيق ويب، وهو مطلوب لاستخدام Analytics.

    • إذا كان تطبيقك يستخدم استضافة Firebase ويستخدم عناوين 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"
};

  2. إذا لم تكن قد قمت بذلك بالفعل، فقم بتثبيت Firebase JS SDK وقم بتهيئة Firebase .

  3. أضف 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);

واجهة برمجة تطبيقات مساحة اسم الويب

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 الأخرى.

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

بعد تهيئة خدمة التحليلات ، يمكنك البدء في تسجيل الأحداث باستخدام طريقة logEvent() .

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

يوضح المثال التالي كيفية تسجيل حدث موصى به للإشارة إلى أن المستخدم قد تلقى إشعارًا في تطبيقك:

Web modular API

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web namespaced API

firebase.analytics().logEvent('notification_received');
index.js

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