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

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

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيق الويب. حزمة SDK لتسجيل نوعين أساسيين من المعلومات وهما:

  • الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدم والنظام أو الأحداث أو الأخطاء.

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

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

قبل البدء

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

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

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

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

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

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

  1. التأكّد من أنّ كائن إعداد Firebase في الرمز يتضمّن measurementId يتم إنشاء رقم التعريف هذا تلقائيًا عند تفعيل الميزة Analytics في مشروعك على 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 

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" من 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

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

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