ইভেন্ট লগ করা

প্ল্যাটফর্ম বেছে নিন: iOS+ Android ওয়েব Flutter Unity C++


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

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

শুরু করার আগে

আপনি প্রোজেক্ট সেট-আপ করেছেন কিনা এবং Analytics অ্যাক্সেস করতে পারেন কিনা তা ভালোভাবে দেখে নিন। Analytics ব্যবহার শুরু করুন বিকল্পে এই বিষয়ে বিস্তারিত বলা আছে।

ইভেন্ট লগ করা

FirebaseAnalytics ইনস্ট্যান্স তৈরি করার পরে, আপনি এটি logEvent() মেথড ব্যবহার করে ইভেন্ট লগ করতে পারবেন।

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

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

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

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

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

কাস্টম প্যারামিটারের মতো, ডিফল্ট ইভেন্ট প্যারামিটার রেজিস্টার করুন যাতে সেগুলি Analytics রিপোর্টে দেখা যায়।

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() পদ্ধতিতে কোনও প্যারামিটার নির্দিষ্ট করা থাকলে, ডিফল্ট ভ্যালুর পরিবর্তে সেই ভ্যালু ব্যবহার করা হয়।

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

Android Studio ডিবাগ লগে ইভেন্ট দেখা

ইভেন্ট সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে সাহায্য করার জন্য 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

এই কমান্ডটি Android Studio logcat-এ আপনার ইভেন্ট দেখায়, এর ফলে আপনি ইভেন্ট পাঠানো হচ্ছে কিনা তা সঙ্গে সঙ্গে যাচাই করতে পারেন।

ড্যাশবোর্ডে ইভেন্ট দেখা

Firebase কনসোলে, আপনি Analytics > ইভেন্ট ড্যাশবোর্ডে আপনার ইভেন্ট সম্পর্কে সামগ্রিক পরিসংখ্যান দেখতে পাবেন।

এই ড্যাশবোর্ড সম্পর্কে নিম্নলিখিত বিষয়গুলি মনে রাখবেন:

  • ড্যাশবোর্ডে ইভেন্ট রিপোর্ট দেখানো হয় যা আপনার অ্যাপের লগ করা প্রতিটি আলাদা আলাদা ধরনের ইভেন্টের জন্য অটোমেটিক তৈরি হয়।

  • ড্যাশবোর্ড সারাদিন ধরে মাঝে মাঝে আপডেট করা হয়। অবিলম্বে পরীক্ষা করার জন্য, এই গাইডের আগের বিভাগে বর্ণিত logcat আউটপুট ব্যবহার করুন।