تلتزم Google بتعزيز المساواة العرقية للمجتمعات السوداء. أنظر كيف.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

ابدأ مع Google Analytics

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

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

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

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

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

قبل ان تبدأ

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

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

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

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

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

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

  1. تأكد من احتواء تكوين Firebase على معرّف measurementId .

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

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

    • إذا كان تطبيقك لا يستخدم عناوين URL محجوزة : إذا كنت تعمل مع تطبيق ويب موجود ، فقم بتحديث كائن تكوين Firebase في التعليمات البرمجية للتأكد من وجود حقل measurementId . يلزم استخدام Google Analytics مع تطبيق الويب الخاص بك. يجب أن يبدو كائن التكوين مشابهاً للمثال التالي:

       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 Analytics:

      firebase.analytics();
     

استخدم 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 ()" .

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

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

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

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