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

اختيار المنصة: iOS+ Android Web Flutter Unity C++


يوضّح لك هذا الدليل السريع كيفية إضافة "إحصاءات Google" إلى تطبيقك والبدء بتسجيل الأحداث.

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

  • الأحداث: هي ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.

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

تسجِّل "إحصاءات Google" تلقائيًا بعض الأحداث و خصائص المستخدمين؛ لا تحتاج إلى إضافة أيّ رمز لتفعيلها.

قبل البدء

أضِف Firebase إلى مشروع JavaScript الخاص بك، في حال لم يسبق لك إجراء ذلك، وتأكَّد من تفعيل Google Analytics في مشروع Firebase:

  • إذا كنت بصدد إنشاء مشروع جديد في Firebase، فعِّل Google Analytics أثناء خطوات إنشاء المشروع.

  • إذا كنت تستخدم مشروعًا حاليًا في Firebase لم يتم تفعيل Google Analytics فيه، يمكنك تفعيله في الإعدادات > عمليات الدمج علامة التبويب.

عند تفعيل Google Analytics في مشروعك، يتم ربط تطبيقات الويب في Firebase بمصادر بيانات Google Analytics المقترنة بـ موقع للتطبيقات + المواقع الإلكترونية.

إضافة حزمة تطوير البرامج (SDK) إلى تطبيقكAnalytics

بناءً على طريقة استضافة تطبيقك على الويب، قد تتم معالجة الإعدادات تلقائيًا أو قد تحتاج إلى تعديل عنصر إعدادات Firebase. إذا كان تطبيقك على الويب يستخدم "إحصاءات Google" من قبل، قد تحتاج إلى إجراء إعدادات إضافية موضّحة في مقالة استخدام Firebase مع وضع علامات gtag.js الحالي.

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

    • إذا كان تطبيقك يستخدم Firebase Hosting ويستخدم عناوين 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: "API_KEY",
  authDomain: "PROJECT_ID.firebaseapp.com",
  databaseURL: "https://PROJECT_ID.firebaseio.com",
  projectId: "PROJECT_ID",
  storageBucket: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  measurementId: "G-GA_MEASUREMENT_ID"
};
      1. إذا لم يسبق لك إجراء ذلك، ثبِّت حزمة تطوير البرامج (SDK) في Firebase JS وأعِدّ Firebase. 2. أضِف حزمة تطوير البرامج (SDK) في Analytics JS وأعِدّ Analytics: * { 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 Analytics من Firebase إلى الصفحة، ولكن أيضًا التخطيط لمواصلة استخدام طلبات gtag() مباشرةً على الصفحة نفسها
  • استخدام معرّف القياس نفسه بين كلٍّ من طلبات gtag() المباشرة وبيانات Google Analytics المُرسَلة إلى 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');

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