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

اختيار النظام الأساسي: iOS+ Android الويب 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. يجب أن يبدو عنصر config مشابهًا للمثال التالي:

      // 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"
};
      <0 إذا لم يسبق لك إجراء ذلك، ثبِّت حزمة تطوير البرامج (SDK) من Firebase لنظام التشغيل JavaScript وأعِد إعداد Firebase. 2. أضِف حزمة تطوير البرامج (SDK) بلغة JavaScript الخاصة بـ Analytics وأعِد إعداد 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 الأخرى.

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

بعد إعداد خدمة &quot;إحصاءات Google&quot;، يمكنك البدء في تسجيل الأحداث باستخدام طريقة logEvent().

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

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

Web

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Web

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

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