ابدأ مع Google Analytics

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

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

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

  • خصائص المستخدم: السمات التي تحدد لوصف شرائح قاعدة المستخدم الخاص بك، مثل تفضيل اللغة أو الموقع الجغرافي.

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

قبل ان تبدأ

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

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

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

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

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

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

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

    • إذا كان يستخدم التطبيق Firebase استضافة والاستخدامات محفوظة عناوين لFirebase تطوير البرامج:

      يتولى Firebase تلقائيًا تكوين تطبيقك. لإكمال الإعداد، إضافة البرامج النصية من بطاقة تطبيقاتك الخاصة بك في إعدادات المشروع إلى العلامة <body> من التطبيق الخاص بك، إذا كنت لم تقم بذلك بالفعل.

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

إصدار الويب 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

إصدار الويب 8

const analytics = firebase.analytics();

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

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

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

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

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

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

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

بعد أن كنت قد تهيئة خدمة تحليلات ، يمكنك أن تبدأ في تسجيل الأحداث مع logEvent() الأسلوب.

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

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

إصدار الويب 9

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

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

إصدار الويب 8

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

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