এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে আপনার অ্যাপে ইভেন্ট লগ করবেন।
ইভেন্টগুলি আপনার অ্যাপে কী ঘটছে, যেমন ব্যবহারকারীর ক্রিয়া, সিস্টেম ইভেন্ট বা ত্রুটি সম্পর্কে অন্তর্দৃষ্টি প্রদান করে।
Analytics আপনার জন্য কিছু ইভেন্ট স্বয়ংক্রিয়ভাবে লগ করে; সেগুলি গ্রহণ করার জন্য আপনাকে কোনও কোড যোগ করতে হবে না। যদি আপনার অ্যাপের অতিরিক্ত ডেটা সংগ্রহের প্রয়োজন হয়, তাহলে আপনি আপনার অ্যাপে 500টি পর্যন্ত বিভিন্ন ধরণের Analytics ইভেন্ট লগ আপ করতে পারেন। আপনার অ্যাপ লগের মোট ইভেন্টের পরিমাণের কোনও সীমা নেই। মনে রাখবেন যে ইভেন্টের নামগুলি কেস-সংবেদনশীল এবং দুটি ইভেন্ট লগ করার ফলে যাদের নাম কেবল কেসের ক্ষেত্রে ভিন্ন হয়, দুটি স্বতন্ত্র ইভেন্ট তৈরি হয়।
শুরু করার আগে
নিশ্চিত করুন যে আপনি আপনার প্রকল্পটি সেট আপ করেছেন এবং Get Started with Analytics এ বর্ণিত Analytics অ্যাক্সেস করতে পারেন।
ইভেন্ট লগ করুন
FirebaseAnalytics ইনস্ট্যান্স তৈরি করার পরে, আপনি logEvent() পদ্ধতি ব্যবহার করে ইভেন্ট লগ করতে এটি ব্যবহার করতে পারেন।
শুরু করতে আপনাকে সাহায্য করার জন্য, Analytics SDK বিভিন্ন ধরণের অ্যাপের মধ্যে প্রচলিত বেশ কিছু প্রস্তাবিত ইভেন্ট সংজ্ঞায়িত করে, যার মধ্যে রয়েছে খুচরা ও ই-কমার্স, ভ্রমণ এবং গেমিং অ্যাপ। এই ইভেন্টগুলি সম্পর্কে আরও জানতে এবং কখন ব্যবহার করতে হবে তা জানতে, প্রস্তাবিত ইভেন্টগুলি দেখুন।
আপনি নিম্নলিখিত স্থানগুলিতে প্রস্তাবিত ইভেন্ট ধরণের বাস্তবায়নের বিবরণ পেতে পারেন:
- প্রস্তাবিত ইভেন্ট:
com.google.firebase.analytics.FirebaseAnalytics.Eventক্লাস রেফারেন্স দেখুন। - নির্ধারিত প্যারামিটার:
com.google.firebase.analytics.FirebaseAnalytics.Paramরেফারেন্স দেখুন।
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি SELECT_CONTENT ইভেন্ট লগ করতে হয়:
Kotlin
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
নির্ধারিত প্যারামিটারগুলি ছাড়াও, আপনি যেকোনো ইভেন্টে নিম্নলিখিত প্যারামিটারগুলি যোগ করতে পারেন:
কাস্টম প্যারামিটার: কাস্টম প্যারামিটারগুলি Analytics রিপোর্টে ডাইমেনশন বা মেট্রিক্স হিসেবে ব্যবহার করা যেতে পারে। আপনি নন-সাংখ্যিক ইভেন্ট প্যারামিটার ডেটার জন্য কাস্টম ডাইমেনশন এবং যেকোনো প্যারামিটার ডেটার জন্য কাস্টম মেট্রিক্স ব্যবহার করতে পারেন যা সংখ্যাসূচকভাবে আরও ভালোভাবে উপস্থাপন করা হয়। SDK ব্যবহার করে একটি কাস্টম প্যারামিটার লগ করার পরে, অ্যানালিটিক্স রিপোর্টে সেই কাস্টম প্যারামিটারগুলি প্রদর্শিত হবে তা নিশ্চিত করার জন্য ডাইমেনশন বা মেট্রিকটি নিবন্ধন করুন। অ্যানালিটিক্স > ইভেন্ট > কাস্টম সংজ্ঞা পরিচালনা করুন > কাস্টম ডাইমেনশন তৈরি করুন ব্যবহার করে এটি করুন।
কাস্টম প্যারামিটারগুলি দর্শক সংজ্ঞায় ব্যবহার করা যেতে পারে যা প্রতিটি প্রতিবেদনে প্রয়োগ করা যেতে পারে। যদি আপনার অ্যাপটি একটি BigQuery প্রকল্পের সাথে লিঙ্ক করা থাকে তবে BigQuery-তে রপ্তানি করা ডেটাতে কাস্টম প্যারামিটারগুলিও অন্তর্ভুক্ত থাকে। Google Analytics 4 BigQuery Export- এ নমুনা কোয়েরি এবং আরও অনেক কিছু খুঁজুন।
VALUEপ্যারামিটার:VALUEহল একটি সাধারণ উদ্দেশ্য প্যারামিটার যা কোনও ইভেন্টের সাথে সম্পর্কিত একটি মূল মেট্রিক সংগ্রহের জন্য কার্যকর। উদাহরণগুলির মধ্যে রয়েছে রাজস্ব, দূরত্ব, সময় এবং পয়েন্ট।
যদি আপনার অ্যাপ্লিকেশনের নির্দিষ্ট চাহিদা থাকে যা প্রস্তাবিত ইভেন্ট টাইপ দ্বারা আচ্ছাদিত না হয়, তাহলে আপনি এই উদাহরণে দেখানো হিসাবে আপনার নিজস্ব কাস্টম ইভেন্টগুলি লগ করতে পারেন:
Kotlin
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
ডিফল্ট ইভেন্ট প্যারামিটার সেট করুন
আপনি setDefaultEventParameters ব্যবহার করে ইভেন্ট জুড়ে প্যারামিটার লগ করতে পারেন। ডিফল্ট প্যারামিটারগুলি লগ করা সমস্ত ভবিষ্যতের ইভেন্টের সাথে সম্পর্কিত।
কাস্টম প্যারামিটারের মতো, ডিফল্ট ইভেন্ট প্যারামিটারগুলি নিবন্ধন করুন যাতে সেগুলি অ্যানালিটিক্স রিপোর্টে প্রদর্শিত হয়।
Kotlin
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Java
Bundle parameters = new Bundle(); parameters.putString("level_name", "Caverns01"); parameters.putInt("level_difficulty", 4); mFirebaseAnalytics.setDefaultEventParameters(parameters);
যদি logEvent() পদ্ধতিতে একটি প্যারামিটার নির্দিষ্ট করা থাকে, তাহলে ডিফল্টের পরিবর্তে সেই মানটি ব্যবহার করা হবে।
একটি ডিফল্ট প্যারামিটার সাফ করতে, setDefaultEventParameters পদ্ধতিতে কল করুন এবং প্যারামিটারটি null এ সেট করুন।
অ্যান্ড্রয়েড স্টুডিও ডিবাগ লগে ইভেন্টগুলি দেখুন
ইভেন্টগুলি সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে SDK দ্বারা ইভেন্ট লগিং পর্যবেক্ষণ করার জন্য আপনি ভার্বোজ লগিং সক্ষম করতে পারেন। এর মধ্যে স্বয়ংক্রিয় এবং ম্যানুয়ালি লগ করা ইভেন্ট উভয়ই অন্তর্ভুক্ত।
আপনি adb কমান্ডের একটি সিরিজ ব্যবহার করে ভার্বোজ লগিং সক্ষম করতে পারেন:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
এই কমান্ডটি অ্যান্ড্রয়েড স্টুডিও লগক্যাটে আপনার ইভেন্টগুলি প্রদর্শন করে, যা আপনাকে তাৎক্ষণিকভাবে যাচাই করতে সাহায্য করে যে ইভেন্টগুলি পাঠানো হচ্ছে।
ড্যাশবোর্ডে ইভেন্টগুলি দেখুন
আপনি Firebase কনসোল ড্যাশবোর্ডে আপনার ইভেন্টগুলির সমষ্টিগত পরিসংখ্যান দেখতে পারেন। এই ড্যাশবোর্ডগুলি সারা দিন পর্যায়ক্রমে আপডেট হয়। তাৎক্ষণিক পরীক্ষার জন্য, পূর্ববর্তী বিভাগে বর্ণিত লগক্যাট আউটপুট ব্যবহার করুন।
আপনি Firebase কনসোলের ইভেন্টস ড্যাশবোর্ড থেকে এই ডেটা অ্যাক্সেস করতে পারবেন। এই ড্যাশবোর্ডটি আপনার অ্যাপ দ্বারা লগ করা প্রতিটি স্বতন্ত্র ধরণের ইভেন্টের জন্য স্বয়ংক্রিয়ভাবে তৈরি ইভেন্ট রিপোর্টগুলি দেখায়।