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


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

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

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

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

শুরু করার আগে

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

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

  • যদি আপনি এমন একটি বিদ্যমান Firebase প্রকল্প ব্যবহার করেন যেখানে Google Analytics সক্ষম করা নেই, তাহলে আপনার > প্রকল্প সেটিংস এটি সক্রিয় করতে।

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

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

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

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

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

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

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

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
      const firebaseConfig = {
        apiKey: "API_KEY",
        authDomain: "PROJECT_ID.firebaseapp.com",
        databaseURL: "https://PROJECT_ID.firebaseio.com",
        projectId: "PROJECT_ID",
        storageBucket: "PROJECT_ID.firebasestorage.app",
        messagingSenderId: "SENDER_ID",
        appId: "APP_ID",
        measurementId: "G-GA_MEASUREMENT_ID"
      };
      
  2. যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে Firebase JS SDK ইনস্টল করুন এবং Firebase আরম্ভ করুন

  3. Analytics JS SDK যোগ করুন এবং Analytics আরম্ভ করুন:

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

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

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

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

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

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

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

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

অ্যানালিটিক্স পরিষেবাটি শুরু করার পরে, আপনি logEvent() পদ্ধতি ব্যবহার করে ইভেন্টগুলি লগ করা শুরু করতে পারেন।

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

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

Web

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

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

Web

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

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