ওয়েবের জন্য গুগল অ্যানালিটিক্স দিয়ে শুরু করুন

প্ল্যাটফর্ম নির্বাচন করুন: iOS+ অ্যান্ড্রয়েড ওয়েব ফ্লাটার ইউনিটি C++

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

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

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

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

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

শুরু করার আগে

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

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

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

যখন আপনি আপনার প্রজেক্টে Google Analytics সক্রিয় করেন, তখন আপনার ফায়ারবেস ওয়েব অ্যাপগুলো একটি 'অ্যাপ + ওয়েব' প্রপার্টির সাথে যুক্ত 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 ব্যবহার করে :

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

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

      // 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"
};
      ১. যদি আগে থেকে না করে থাকেন, তাহলে Firebase JS SDK ইনস্টল করুন এবং Firebase চালু করুন । ২. 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 কোড ব্যবহার করে গুগল অ্যানালিটিক্স চালু রেখে থাকেন, এবং এরপর নিম্নলিখিত কাজগুলোর মধ্যে কোনো একটি করার পরিকল্পনা করেন, তাহলে আপনার অ্যাপের জন্য অতিরিক্ত সেটআপের প্রয়োজন হতে পারে:

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

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

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

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

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

অ্যানালিটিক্স সার্ভিসটি ইনিশিয়ালাইজ করার পর, আপনি logEvent() মেথড ব্যবহার করে ইভেন্ট লগ করা শুরু করতে পারেন।

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

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

Web 

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web 

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

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