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


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

يجمع "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: "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) 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.

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

بعد تهيئة خدمة "إحصاءات Google"، يمكنك البدء في تسجيل الأحداث 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

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