লগ ইভেন্ট

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

ইভেন্টগুলি আপনার অ্যাপে কী ঘটছে তার অন্তর্দৃষ্টি প্রদান করে, যেমন ব্যবহারকারীর অ্যাকশন, সিস্টেম ইভেন্ট বা ত্রুটি।

Analytics স্বয়ংক্রিয়ভাবে আপনার জন্য কিছু ইভেন্ট লগ করে; সেগুলি পাওয়ার জন্য আপনাকে কোনো কোড যোগ করতে হবে না। আপনার অ্যাপের অতিরিক্ত ডেটা সংগ্রহ করার প্রয়োজন হলে, আপনি আপনার অ্যাপে 500টি বিভিন্ন অ্যানালিটিক্স ইভেন্টের ধরন পর্যন্ত লগ আপ করতে পারেন। আপনার অ্যাপ লগ ইভেন্টের মোট ভলিউমের কোন সীমা নেই। মনে রাখবেন যে ইভেন্টের নামগুলি কেস-সংবেদনশীল এবং দুটি ইভেন্ট লগিং করলে যার নাম শুধুমাত্র ক্ষেত্রে আলাদা হয় দুটি স্বতন্ত্র ঘটনা ঘটবে৷

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

নিশ্চিত করুন যে আপনি আপনার প্রোজেক্ট সেট আপ করেছেন এবং Get Started with Analytics- এ বর্ণিত Analytics অ্যাক্সেস করতে পারেন।

লগ ইভেন্ট

আপনি firebase.analytics() উদাহরণ কনফিগার করার পরে, আপনি logEvent() পদ্ধতির মাধ্যমে ইভেন্ট লগ করা শুরু করতে পারেন। আপনি যদি ইতিমধ্যেই Google Analytics-এর সাথে পরিচিত হন, তাহলে এই পদ্ধতিটি gtag.js-event কমান্ড ব্যবহার করার সমতুল্য।

আপনাকে শুরু করতে সহায়তা করার জন্য, Analytics SDK অনেকগুলি প্রস্তাবিত ইভেন্টকে সংজ্ঞায়িত করে যা খুচরা এবং ইকমার্স, ভ্রমণ এবং গেমিং অ্যাপ সহ বিভিন্ন ধরণের অ্যাপগুলির মধ্যে সাধারণ৷ এই ইভেন্টগুলি সম্পর্কে আরও জানতে এবং কখন সেগুলি ব্যবহার করতে হবে, প্রস্তাবিত ইভেন্টগুলি দেখুন৷

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

আপনি gtag.js ইভেন্ট রেফারেন্সে বেশ কয়েকটি ইভেন্ট এবং তাদের প্যারামিটারের বাস্তবায়নের বিশদ বিবরণ পেতে পারেন।

নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি select_content ইভেন্ট লগ করতে হয়:

Web version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Web version 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

নির্ধারিত পরামিতিগুলি ছাড়াও, আপনি যেকোনো ইভেন্টে নিম্নলিখিত পরামিতিগুলি যোগ করতে পারেন:

  • কাস্টম প্যারামিটার: কাস্টম প্যারামিটারগুলিকে অ্যানালিটিক্স রিপোর্টে মাত্রা বা মেট্রিক্স হিসাবে ব্যবহার করা যেতে পারে। আপনি অ-সংখ্যাসূচক ইভেন্ট প্যারামিটার ডেটার জন্য কাস্টম মাত্রা এবং যেকোনো প্যারামিটার ডেটার জন্য কাস্টম মেট্রিক্স ব্যবহার করতে পারেন যা সংখ্যাগতভাবে ভালভাবে উপস্থাপিত হয়। একবার আপনি SDK ব্যবহার করে একটি কাস্টম প্যারামিটার লগ ইন করলে, সেই কাস্টম প্যারামিটারগুলি বিশ্লেষণ প্রতিবেদনে উপস্থিত হয় তা নিশ্চিত করতে মাত্রা বা মেট্রিক নিবন্ধন করুন৷ এর মাধ্যমে এটি করুন: অ্যানালিটিক্স > ইভেন্টস > কাস্টম সংজ্ঞা পরিচালনা করুন > কাস্টম মাত্রা তৈরি করুন

    কাস্টম প্যারামিটারগুলি দর্শকের সংজ্ঞাগুলিতে ব্যবহার করা যেতে পারে যা প্রতিটি প্রতিবেদনে প্রয়োগ করা যেতে পারে। আপনার অ্যাপ যদি BigQuery প্রোজেক্টের সাথে লিঙ্ক করা থাকে তাহলে BigQuery-এ এক্সপোর্ট করা ডেটাতেও কাস্টম প্যারামিটার অন্তর্ভুক্ত থাকে। Google Analytics 4 BigQuery Export- এ নমুনা প্রশ্ন এবং আরও অনেক কিছু খুঁজুন।

  • value প্যারামিটার: value হল একটি সাধারণ উদ্দেশ্য প্যারামিটার যা একটি ইভেন্টের সাথে সম্পর্কিত একটি মূল মেট্রিক জমা করার জন্য দরকারী। উদাহরণের মধ্যে রয়েছে রাজস্ব, দূরত্ব, সময় এবং পয়েন্ট।

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

Web version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web version 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

ড্যাশবোর্ডে ইভেন্টগুলি দেখুন

আপনি Firebase কনসোল ড্যাশবোর্ডে আপনার ইভেন্টের সমষ্টিগত পরিসংখ্যান দেখতে পারেন। এই ড্যাশবোর্ডগুলি সারাদিন পর্যায়ক্রমে আপডেট হয়। তাৎক্ষণিক পরীক্ষার জন্য, পূর্ববর্তী বিভাগে বর্ণিত logcat আউটপুট ব্যবহার করুন।

আপনি Firebase কনসোলে ইভেন্ট ড্যাশবোর্ড থেকে এই ডেটা অ্যাক্সেস করতে পারেন। এই ড্যাশবোর্ডটি ইভেন্ট রিপোর্টগুলি দেখায় যা আপনার অ্যাপ দ্বারা লগ করা প্রতিটি স্বতন্ত্র ধরণের ইভেন্টের জন্য স্বয়ংক্রিয়ভাবে তৈরি হয়৷

,

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

ইভেন্টগুলি আপনার অ্যাপে কী ঘটছে তার অন্তর্দৃষ্টি প্রদান করে, যেমন ব্যবহারকারীর অ্যাকশন, সিস্টেম ইভেন্ট বা ত্রুটি।

Analytics স্বয়ংক্রিয়ভাবে আপনার জন্য কিছু ইভেন্ট লগ করে; সেগুলি পাওয়ার জন্য আপনাকে কোনো কোড যোগ করতে হবে না। আপনার অ্যাপের অতিরিক্ত ডেটা সংগ্রহ করার প্রয়োজন হলে, আপনি আপনার অ্যাপে 500টি বিভিন্ন অ্যানালিটিক্স ইভেন্টের ধরন পর্যন্ত লগ আপ করতে পারেন। আপনার অ্যাপ লগ ইভেন্টের মোট ভলিউমের কোন সীমা নেই। মনে রাখবেন যে ইভেন্টের নামগুলি কেস-সংবেদনশীল এবং দুটি ইভেন্ট লগিং করলে যার নাম শুধুমাত্র ক্ষেত্রে আলাদা হয় দুটি স্বতন্ত্র ঘটনা ঘটবে৷

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

নিশ্চিত করুন যে আপনি আপনার প্রোজেক্ট সেট আপ করেছেন এবং Get Started with Analytics- এ বর্ণিত Analytics অ্যাক্সেস করতে পারেন।

লগ ইভেন্ট

আপনি firebase.analytics() উদাহরণ কনফিগার করার পরে, আপনি logEvent() পদ্ধতির মাধ্যমে ইভেন্ট লগ করা শুরু করতে পারেন। আপনি যদি ইতিমধ্যেই Google Analytics-এর সাথে পরিচিত হন, তাহলে এই পদ্ধতিটি gtag.js-event কমান্ড ব্যবহার করার সমতুল্য।

আপনাকে শুরু করতে সহায়তা করার জন্য, Analytics SDK অনেকগুলি প্রস্তাবিত ইভেন্টকে সংজ্ঞায়িত করে যা খুচরা এবং ইকমার্স, ভ্রমণ এবং গেমিং অ্যাপ সহ বিভিন্ন ধরণের অ্যাপগুলির মধ্যে সাধারণ৷ এই ইভেন্টগুলি সম্পর্কে আরও জানতে এবং কখন সেগুলি ব্যবহার করতে হবে, প্রস্তাবিত ইভেন্টগুলি দেখুন৷

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

আপনি gtag.js ইভেন্ট রেফারেন্সে বেশ কয়েকটি ইভেন্ট এবং তাদের প্যারামিটারের বাস্তবায়নের বিশদ বিবরণ পেতে পারেন।

নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি select_content ইভেন্ট লগ করতে হয়:

Web version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

Web version 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

নির্ধারিত পরামিতিগুলি ছাড়াও, আপনি যেকোনো ইভেন্টে নিম্নলিখিত পরামিতিগুলি যোগ করতে পারেন:

  • কাস্টম প্যারামিটার: কাস্টম প্যারামিটারগুলিকে অ্যানালিটিক্স রিপোর্টে মাত্রা বা মেট্রিক্স হিসাবে ব্যবহার করা যেতে পারে। আপনি অ-সংখ্যাসূচক ইভেন্ট প্যারামিটার ডেটার জন্য কাস্টম মাত্রা এবং যেকোনো প্যারামিটার ডেটার জন্য কাস্টম মেট্রিক্স ব্যবহার করতে পারেন যা সংখ্যাগতভাবে ভালভাবে উপস্থাপিত হয়। একবার আপনি SDK ব্যবহার করে একটি কাস্টম প্যারামিটার লগ ইন করলে, সেই কাস্টম প্যারামিটারগুলি বিশ্লেষণ প্রতিবেদনে উপস্থিত হয় তা নিশ্চিত করতে মাত্রা বা মেট্রিক নিবন্ধন করুন৷ এর মাধ্যমে এটি করুন: অ্যানালিটিক্স > ইভেন্টস > কাস্টম সংজ্ঞা পরিচালনা করুন > কাস্টম মাত্রা তৈরি করুন

    কাস্টম প্যারামিটারগুলি দর্শকের সংজ্ঞাগুলিতে ব্যবহার করা যেতে পারে যা প্রতিটি প্রতিবেদনে প্রয়োগ করা যেতে পারে। আপনার অ্যাপ যদি BigQuery প্রোজেক্টের সাথে লিঙ্ক করা থাকে তাহলে BigQuery-এ এক্সপোর্ট করা ডেটাতেও কাস্টম প্যারামিটার অন্তর্ভুক্ত থাকে। Google Analytics 4 BigQuery Export- এ নমুনা প্রশ্ন এবং আরও অনেক কিছু খুঁজুন।

  • value প্যারামিটার: value হল একটি সাধারণ উদ্দেশ্য প্যারামিটার যা একটি ইভেন্টের সাথে সম্পর্কিত একটি মূল মেট্রিক জমা করার জন্য দরকারী। উদাহরণের মধ্যে রয়েছে রাজস্ব, দূরত্ব, সময় এবং পয়েন্ট।

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

Web version 9

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

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

Web version 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

ড্যাশবোর্ডে ইভেন্টগুলি দেখুন

আপনি Firebase কনসোল ড্যাশবোর্ডে আপনার ইভেন্টের সমষ্টিগত পরিসংখ্যান দেখতে পারেন। এই ড্যাশবোর্ডগুলি সারাদিন পর্যায়ক্রমে আপডেট হয়। তাৎক্ষণিক পরীক্ষার জন্য, পূর্ববর্তী বিভাগে বর্ণিত logcat আউটপুট ব্যবহার করুন।

আপনি Firebase কনসোলে ইভেন্ট ড্যাশবোর্ড থেকে এই ডেটা অ্যাক্সেস করতে পারেন। এই ড্যাশবোর্ডটি ইভেন্ট রিপোর্টগুলি দেখায় যা আপনার অ্যাপ দ্বারা লগ করা প্রতিটি স্বতন্ত্র ধরণের ইভেন্টের জন্য স্বয়ংক্রিয়ভাবে তৈরি হয়৷