ইভেন্ট লগ করা

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


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

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

শুরু করার আগে

আপনি প্রোজেক্ট সেট-আপ করেছেন কিনা এবং Analytics অ্যাক্সেস করতে পারছেন কিনা তা নিশ্চিত করুন, যেমনটি Analytics-এর সাথে শুরু করুন-এ বর্ণনা করা হয়েছে।

আপনি ক্যাম্পেন অ্যাট্রিবিউশন ডেটা সংগ্রহ করতে চাইলে, আপনার প্রোজেক্টে AdSupport ফ্রেমওয়ার্ক যোগ করতে ভুলবেন না।

লগ ইভেন্ট

FirebaseApp ইনস্ট্যান্স কনফিগার করার পরে, আপনি logEvent() পদ্ধতির মাধ্যমে ইভেন্ট লগ করা শুরু করতে পারবেন।

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

আপনি Swift এবং Objective-C-এর জন্য কনস্ট্যান্ট রেফারেন্সে প্রয়োগের বিবরণ খুঁজে পেতে পারেন।

নিম্নলিখিত উদাহরণে দেখানো হয়েছে কীভাবে একটি সাজেস্ট করা kFIRSelectContent ইভেন্ট লগ করতে হয়:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

  • কাস্টম প্যারামিটার: কাস্টম প্যারামিটারকে Analytics রিপোর্টে ডাইমেনশন বা মেট্রিক হিসেবে ব্যবহার করা যেতে পারে। আপনি সংখ্যাসূচক নয় এমন ইভেন্ট প্যারামিটার ডেটার জন্য কাস্টম ডাইমেনশন এবং সংখ্যাসূচকভাবে আরও ভালোভাবে উপস্থাপন করা যায় এমন যেকোনও প্যারামিটার ডেটার জন্য কাস্টম মেট্রিক ব্যবহার করতে পারেন। SDK ব্যবহার করে কাস্টম প্যারামিটার লগ করার পরে, Analytics রিপোর্টে সেই কাস্টম প্যারামিটারগুলি দেখা যাচ্ছে কিনা তা নিশ্চিত করতে ডাইমেনশন বা মেট্রিক রেজিস্টার করুন। এটি করতে, Firebase কনসোলে, Analytics > কাস্টম সংজ্ঞা বিকল্পে যান।

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

  • kFIRParameterValue প্যারামিটার: kFIRParameterValue হল সাধারণ উদ্দেশ্যে ব্যবহৃত প্যারামিটার যা কোনও ইভেন্টের সাথে সম্পর্কিত মূল মেট্রিক একত্রিত করার জন্য উপযোগী। উদাহরণ হিসেবে উপার্জন, দূরত্ব, সময় ও পয়েন্ট অন্তর্ভুক্ত।

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

ডিফল্ট ইভেন্ট প্যারামিটার সেট করা

আপনি setDefaultEventParameters ব্যবহার করে বিভিন্ন ইভেন্ট জুড়ে প্যারামিটার লগ করতে পারবেন। ডিফল্ট প্যারামিটারগুলি লগ করা সমস্ত ভবিষ্যতের ইভেন্টের সাথে যুক্ত।

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

Swift 

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C 

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

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

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

Xcode ডিবাগ কনসোলে ইভেন্ট দেখুন

SDK-এর মাধ্যমে ইভেন্টের লগিং মনিটর করতে আপনি ভার্বোস লগিং চালু করতে পারেন, যাতে ইভেন্ট সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে সাহায্য করা যায়। এর মধ্যে অটোমেটিক ও ম্যানুয়ালি লগ করা ইভেন্ট অন্তর্ভুক্ত।

আপনি নিম্নলিখিত উপায়ে ভার্বোস লগিং চালু করতে পারবেন:

  1. Xcode-এ, প্রোডাক্ট > স্কিম > স্কিম এডিট করুন... বিকল্প বেছে নিন
  2. বাঁদিকের মেনু থেকে রান করুন বিকল্প বেছে নিন।
  3. আর্গুমেন্ট ট্যাব বেছে নিন।
  4. লঞ্চ করার সময় পাস করা আর্গুমেন্ট বিভাগে, -FIRAnalyticsVerboseLoggingEnabled যোগ করুন।

পরের বার আপনি অ্যাপ চালালে, আপনার ইভেন্ট Xcode ডিবাগ কনসোলে দেখা যাবে, যা আপনাকে ইভেন্ট পাঠানো হচ্ছে কিনা তা অবিলম্বে যাচাই করতে সাহায্য করবে।

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

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

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

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

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