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

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

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك، وتسجِّل نوعين أساسيين من المعلومات:

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

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

قبل البدء

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

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

  • في حال استخدام مشروع حالي على Firebase لم يتم تفعيل "إحصاءات Google" عليه، انتقِل إلى علامة تبويب عمليات الدمج ضمن > إعدادات المشروع لتفعيله.

عند تفعيل "إحصاءات Google" في مشروعك، يتم ربط تطبيقات الويب على Firebase بمصادر بيانات "إحصاءات Google" المرتبطة بأحد التطبيقات + المواقع الإلكترونية.

إضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" إلى تطبيقك

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

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

    • إذا كان تطبيقك يستخدم "استضافة Firebase" وكان يستخدم عناوين 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: "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. ثبِّت حزمة تطوير البرامج (SDK) لـ Firebase JS وابدأ في تهيئة Firebase، إذا لم يسبق لك إجراء ذلك.

  3. إضافة حزمة تطوير البرامج (SDK) JS لخدمة "إحصاءات Google" وإعداد "إحصاءات Google":

واجهة برمجة التطبيقات Web modular API 

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);

واجهة برمجة التطبيقات لمساحة الاسم على الويب 

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" من Firebase إلى الصفحة مع التخطيط أيضًا لمتابعة استخدام استدعاءات gtag() مباشرةً على الصفحة نفسها.
  • تريد استخدام رقم تعريف القياس نفسه بين كلّ من مكالمات gtag() المباشرة وبيانات "إحصاءات Google" المُرسَلة إلى Firebase.

لضمان إمكانية استخدام الأحداث من خلال جميع خدمات Firebase، أكمِل خطوات الإعداد الإضافية التالية:

  • أزِل السطر gtag('config', 'GA_MEASUREMENT_ID'); حيث يكون GA_MEASUREMENT_ID هو measurementId لتطبيق الويب على Firebase. وإذا كانت لديك أرقام تعريف أخرى لمواقع "إحصاءات Google" الأخرى على الصفحة، لن تحتاج إلى إزالة سطر الضبط المتعلق بها.
  • تأكَّد من الاتصال بالرقم firebase.analytics() قبل إرسال أي أحداث مع "gtag()".

وبخلاف ذلك، لن يتم ربط الأحداث المُرسَلة إلى رقم التعريف هذا باستخدام استدعاءات gtag() بمنصة Firebase ولن تكون متاحة للاستهداف في خدمات Firebase الأخرى.

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

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

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

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

واجهة برمجة التطبيقات Web modular API

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

واجهة برمجة التطبيقات لمساحة الاسم على الويب

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

الخطوات اللاحقة