بدء استخدام "إحصاءات 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 محجوزة لحِزم Firebase SDK:

      تعالج 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"
};
      ‫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 الأخرى.

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

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

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

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

Web

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

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

Web

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

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