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

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

يوضح لك هذا 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 الحالية .

  1. تأكد من احتواء كائن تهيئة 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"
      };
      
  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);

واجهة برمجة تطبيقات 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');

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