Google 致力于为黑人社区推动种族平等。查看具体举措

ابدأ مع Google Analytics

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

يجمع Google Analytics بيانات الاستخدام والسلوك لتطبيق الويب الخاص بك. تسجل SDK نوعين أساسيين من المعلومات:

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

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

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

قبل ان تبدأ

أضف Firebase إلى مشروع JavaScript ، إذا لم تكن قد قمت بذلك بالفعل ، وتأكد من تمكين Google Analytics في مشروع Firebase:

  • إذا كنت تنشئ مشروع Firebase جديدًا ، فقم بتمكين Google Analytics أثناء سير عمل إنشاء المشروع.

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

عند تمكين Google Analytics في مشروعك ، يتم ربط تطبيقات Firebase على الويب بتدفقات بيانات Google Analytics المرتبطةبتطبيق + موقع ويب .

أضف Analytics SDK إلى تطبيقك

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

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

    • إذا كان يستخدم التطبيق Firebase استضافة والاستخدامات محفوظة عناوين ل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. بدء تحليلات Firebase:

الويب v8

const analytics = firebase.analytics();

الويب الإصدار 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

استخدم Firebase مع وضع علامات gtag.js الحالية

إذا سبق لك تشغيل Google Analytics في تطبيقك باستخدام مقتطف gtag.js ، فقد يتطلب تطبيقك إعدادًا إضافيًا إذا كنت تخطط للقيام بأحد الإجراءات التالية:

  • أضف مكالمات Google Analytics من Firebase إلى الصفحة ولكن خطط أيضًا لمواصلة استخدام gtag() مباشرة على نفس الصفحة.
  • تريد استخدام معرّف القياس نفسه بين مكالمات gtag() المباشرة gtag() Google Analytics المرسلة إلى Firebase.

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

  • قم بإزالة [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) في عنوان URL. يجب أن يكون مقتطف gtag مشابهًا لـ

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • إزالة سطر gtag('config', ' GA_MEASUREMENT_ID '); حيث يكون GA_MEASUREMENT_ID هو نفسه GA_MEASUREMENT_ID measurementId في مقتطف تهيئة Firebase. إذا كانت لديك معرّفات أخرى لمواقع Analytics الأخرى على الصفحة ، فلن تحتاج إلى إزالة سطر التهيئة.

  • تأكد من استدعاء firebase.analytics() قبل إرسال أي أحداث باستخدام gtag() .

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

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

بعد تهيئة خدمة Analytics باستخدام "firebase.analytics ()" ، يمكنك البدء في تسجيل الأحداث باستخدام طريقة "logEvent ()" .

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

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

الويب v8

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

الويب الإصدار 9

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

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

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