بدء استخدام "إحصاءات 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 JavaScript وأعِدّ Firebase. 2. أضِف حزمة تطوير البرامج (SDK) لمنصة Analytics JavaScript وأعِدّ 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');

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