Google Analytics দিয়ে শুরু করুন

এই কুইকস্টার্ট আপনাকে দেখায় কিভাবে আপনার অ্যাপে গুগল অ্যানালিটিক্স যোগ করবেন এবং ইভেন্ট লগিং শুরু করবেন।

Google Analytics আপনার ওয়েব অ্যাপের ব্যবহার এবং আচরণের ডেটা সংগ্রহ করে। SDK দুটি প্রাথমিক ধরনের তথ্য লগ করে:

  • ইভেন্ট : আপনার অ্যাপে কী ঘটছে, যেমন ব্যবহারকারীর ক্রিয়া, সিস্টেম ইভেন্ট বা ত্রুটি৷

  • ব্যবহারকারীর বৈশিষ্ট্য : আপনার ব্যবহারকারী বেসের অংশগুলি বর্ণনা করার জন্য আপনি সংজ্ঞায়িত বৈশিষ্ট্যগুলি, যেমন ভাষা পছন্দ বা ভৌগলিক অবস্থান।

অ্যানালিটিক্স স্বয়ংক্রিয়ভাবে কিছু ইভেন্ট এবং ব্যবহারকারীর বৈশিষ্ট্য লগ করে; তাদের সক্ষম করার জন্য আপনাকে কোনো কোড যোগ করার দরকার নেই।

তুমি শুরু করার আগে

আপনি যদি ইতিমধ্যে না করে থাকেন, তাহলে আপনার জাভাস্ক্রিপ্ট প্রোজেক্টে Firebase যোগ করুন এবং নিশ্চিত করুন যে আপনার Firebase প্রোজেক্টে Google Analytics সক্ষম করা আছে:

  • আপনি যদি একটি নতুন ফায়ারবেস প্রজেক্ট তৈরি করেন, তাহলে প্রোজেক্ট তৈরির ওয়ার্কফ্লো চলাকালীন Google Analytics সক্ষম করুন।

  • আপনি যদি এমন একটি বিদ্যমান ফায়ারবেস প্রজেক্ট ব্যবহার করেন যাতে Google Analytics সক্ষম না থাকে, তাহলে আপনার ইন্টিগ্রেশন ট্যাবে যান > এটি সক্ষম করতে প্রকল্প সেটিংস

আপনি যখন আপনার প্রকল্পে Google Analytics সক্ষম করেন, তখন আপনার Firebase ওয়েব অ্যাপগুলি একটি অ্যাপ + ওয়েব সম্পত্তির সাথে যুক্ত Google Analytics ডেটা স্ট্রিমগুলির সাথে লিঙ্ক করা হয়।

আপনার অ্যাপে Analytics SDK যোগ করুন

আপনার ওয়েব অ্যাপ্লিকেশন কীভাবে হোস্ট করা হয়েছে তার উপর নির্ভর করে, আপনার কনফিগারেশন স্বয়ংক্রিয়ভাবে পরিচালনা করা যেতে পারে বা আপনাকে আপনার Firebase কনফিগারেশন অবজেক্ট আপডেট করতে হতে পারে। যদি আপনার ওয়েব অ্যাপ ইতিমধ্যেই Google Analytics ব্যবহার করে, তাহলে আপনাকে বিদ্যমান gtag.js ট্যাগিংয়ের সাথে Firebase ব্যবহার করুন- এ বর্ণিত অতিরিক্ত সেটআপ করতে হতে পারে।

  1. আপনার কোডে আপনার Firebase কনফিগার অবজেক্টে measurementId রয়েছে কিনা পরীক্ষা করুন। আপনি যখন আপনার Firebase প্রোজেক্টে Analytics সক্ষম করেন এবং একটি ওয়েব অ্যাপ রেজিস্টার করেন তখন এই আইডিটি স্বয়ংক্রিয়ভাবে তৈরি হয় এবং এটি অ্যানালিটিক্স ব্যবহার করতে হয়।

    • যদি আপনার অ্যাপ Firebase হোস্টিং ব্যবহার করে এবং Firebase SDK-এর জন্য সংরক্ষিত URL ব্যবহার করে :

      Firebase স্বয়ংক্রিয়ভাবে আপনার অ্যাপ্লিকেশন কনফিগার করা পরিচালনা করে। সেটআপ সম্পূর্ণ করতে, আপনার প্রজেক্ট সেটিংসে আপনার অ্যাপস কার্ড থেকে স্ক্রিপ্টগুলি আপনার অ্যাপের <body> ট্যাগে যোগ করুন, যদি আপনি ইতিমধ্যে না থাকেন।

    • আপনার অ্যাপ যদি সংরক্ষিত ইউআরএল ব্যবহার না করে : আপনি যদি একটি বিদ্যমান ওয়েব অ্যাপের সাথে কাজ করেন , তাহলে measurementId ক্ষেত্র উপস্থিত রয়েছে তা নিশ্চিত করতে আপনার কোডে Firebase কনফিগার অবজেক্ট আপডেট করুন। কনফিগার অবজেক্ট নিম্নলিখিত উদাহরণের অনুরূপ হওয়া উচিত:

      // 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 JS SDK ইনস্টল করুন এবং Firebase শুরু করুন

  3. Analytics JS SDK যোগ করুন এবং বিশ্লেষণ শুরু করুন:

ওয়েব মডুলার API

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);

ওয়েব নামস্থান API

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();

বিদ্যমান gtag.js ট্যাগিং সহ Firebase ব্যবহার করুন

আপনি যদি আগে Google Analytics ব্যবহার করে আপনার অ্যাপে gtag.js স্নিপেট ব্যবহার করে থাকেন, তাহলে আপনার অ্যাপের অতিরিক্ত সেটআপের প্রয়োজন হতে পারে যদি আপনি নিম্নলিখিতগুলির মধ্যে একটি করার পরিকল্পনা করেন:

  • Firebase থেকে পৃষ্ঠায় Google Analytics কল যোগ করুন কিন্তু একই পৃষ্ঠায় সরাসরি gtag() কল ব্যবহার করা চালিয়ে যাওয়ার পরিকল্পনা করুন।
  • Firebase-এ পাঠানো সরাসরি gtag() কল এবং Google Analytics ডেটা উভয়ের মধ্যে একই পরিমাপ আইডি ব্যবহার করতে চান।

আপনার ইভেন্টগুলি সমস্ত Firebase পরিষেবাগুলির দ্বারা ব্যবহারের জন্য উপলব্ধ রয়েছে তা নিশ্চিত করতে, নিম্নলিখিত অতিরিক্ত সেটআপ পদক্ষেপগুলি সম্পূর্ণ করুন:

  • লাইন gtag('config', ' GA_MEASUREMENT_ID '); যেখানে GA_MEASUREMENT_ID হল আপনার Firebase ওয়েব অ্যাপের measurementId । আপনার যদি পৃষ্ঠায় অন্যান্য অ্যানালিটিক্স প্রপার্টির জন্য অন্য আইডি থাকে, তাহলে আপনাকে তাদের কনফিগারেশন লাইন সরাতে হবে না।
  • নিশ্চিত করুন যে আপনি gtag() দিয়ে কোনো ইভেন্ট পাঠানোর আগে firebase.analytics() কল করেছেন।

অন্যথায়, gtag() কল সহ সেই আইডিতে পাঠানো ইভেন্টগুলি Firebase-এর সাথে যুক্ত হবে না এবং অন্যান্য Firebase পরিষেবাগুলিতে লক্ষ্য করার জন্য উপলব্ধ হবে না।

লগিং ইভেন্ট শুরু করুন

আপনি Analytics পরিষেবা শুরু করার পরে, আপনি logEvent() পদ্ধতির মাধ্যমে ইভেন্টগুলি লগ করা শুরু করতে পারেন৷

সমস্ত অ্যাপের জন্য কিছু ইভেন্ট সুপারিশ করা হয়; অন্যদের নির্দিষ্ট ব্যবসার ধরন বা উল্লম্বের জন্য সুপারিশ করা হয়। আপনার রিপোর্টে সর্বাধিক উপলব্ধ বিশদটি নিশ্চিত করতে এবং ভবিষ্যতের বৈশিষ্ট্য এবং সংহতকরণগুলি উপলব্ধ হওয়ার সাথে সাথে উপকৃত হওয়ার জন্য আপনাকে তাদের নির্ধারিত প্যারামিটার সহ প্রস্তাবিত ইভেন্টগুলি পাঠাতে হবে। এই বিভাগটি একটি পূর্ব-নির্ধারিত ইভেন্ট লগিং প্রদর্শন করে, লগিং ইভেন্টের বিষয়ে আরও তথ্যের জন্য, লগ ইভেন্ট দেখুন।

নিম্নলিখিত উদাহরণটি দেখায় যে কীভাবে একটি প্রস্তাবিত ইভেন্ট লগ করতে হয় তা বোঝাতে ব্যবহারকারী আপনার অ্যাপে একটি বিজ্ঞপ্তি পেয়েছেন:

Web modular API

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

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

Web namespaced API

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

পরবর্তী পদক্ষেপ