লগ ইভেন্ট

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

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

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

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

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

লগ ইভেন্ট

আপনি একটি FirebaseAnalytics উদাহরণ তৈরি করার পরে, আপনি logEvent() পদ্ধতিতে ইভেন্ট লগ করতে এটি ব্যবহার করতে পারেন।

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

আপনি নিম্নলিখিত অবস্থানে প্রস্তাবিত ইভেন্ট প্রকারের জন্য বাস্তবায়নের বিশদ জানতে পারেন:

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

Kotlin+KTX

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

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

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

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

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

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

Kotlin+KTX

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 ব্যবহার করে ইভেন্ট জুড়ে পরামিতি লগ করতে পারেন। ডিফল্ট পরামিতিগুলি লগ করা সমস্ত ভবিষ্যতের ইভেন্টের সাথে যুক্ত।

কাস্টম প্যারামিটারের মতো, ডিফল্ট ইভেন্ট প্যারামিটারগুলি রেজিস্টার করুন যাতে নিশ্চিত করা যায় যে সেগুলি Analytics রিপোর্টে উপস্থিত হয়।

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

যদি logEvent() পদ্ধতিতে একটি প্যারামিটার নির্দিষ্ট করা হয়, তাহলে সেই মানটি ডিফল্টের পরিবর্তে ব্যবহার করা হয়।

একটি ডিফল্ট প্যারামিটার সাফ করতে, null এ সেট করা প্যারামিটার সহ setDefaultEventParameters পদ্ধতিতে কল করুন।

অ্যান্ড্রয়েড স্টুডিও ডিবাগ লগে ইভেন্টগুলি দেখুন

ইভেন্টগুলি সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে আপনি 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 কনসোল ড্যাশবোর্ডে আপনার ইভেন্টের সমষ্টিগত পরিসংখ্যান দেখতে পারেন। এই ড্যাশবোর্ডগুলি সারাদিন পর্যায়ক্রমে আপডেট হয়। তাৎক্ষণিক পরীক্ষার জন্য, পূর্ববর্তী বিভাগে বর্ণিত logcat আউটপুট ব্যবহার করুন।

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