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


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

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

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

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

قبل البدء

إذا لم يسبق لك إجراء ذلك، أضِف 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"
};

  2. إذا لم يسبق لك إجراء ذلك، ثبِّت حزمة تطوير البرامج (SDK) لمنصّة Firebase بلغة JavaScript وأعِد تهيئة Firebase.

  3. أضِف حزمة تطوير البرامج (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

إذا سبق لك تشغيل &quot;إحصاءات Google&quot; في تطبيقك باستخدام مقتطف 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');
analytics_log_event.js

Web

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

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