ইভেন্ট লগ করা

প্ল্যাটফর্ম বেছে নিন: 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 এক্সপোর্ট থেকে নমুনা কোয়েরি ও আরও অনেক কিছু খুঁজে দেখুন।

  • 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 debug কনসোলে দেখানো হবে, যা আপনাকে অবিলম্বে যাচাই করতে সাহায্য করবে যে ইভেন্ট পাঠানো হচ্ছে।

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

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

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

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

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