ইভেন্ট লগ করা

প্ল্যাটফর্ম বেছে নিন:

iOS+ Android ওয়েব Flutter Unity C++

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

শুরু করার আগে

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

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

ইভেন্ট লগ করা

FirebaseAnalytics ইনস্ট্যান্স তৈরি করার পরে, লাইব্রেরির log- মেথড ব্যবহার করে ইভেন্ট লগ করতে পারবেন।

আগে থেকে ঠিক করা ইভেন্ট

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

আপনি সাজেস্ট করা ইভেন্টের ধরনের জন্য লগ পদ্ধতি API রেফারেন্সে খুঁজে পেতে পারেন।

select_content ইভেন্ট কীভাবে লগ করতে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন:

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

অথবা, আপনি logEvent() ব্যবহার করে একই ইভেন্ট লগ করতে পারেন:

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

সাজেস্ট করা (প্রয়োজনীয়) প্যারামিটার ছাড়া আপনি যদি অতিরিক্ত প্যারামিটার উল্লেখ করতে চান, তাহলে এটি কাজে লাগতে পারে। আপনি যেকোনও ইভেন্টে নিম্নলিখিত প্যারামিটার যোগ করতে পারবেন:

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

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

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

• প্যারামিটারের নাম ৪০ অক্ষর পর্যন্ত হতে পারে এবং সেটি অবশ্যই বর্ণমালা দিয়ে শুরু হতে হবে এবং শুধুমাত্র বর্ণসাংখ্যিক অক্ষর ও আন্ডারস্কোর থাকতে হবে। স্ট্রিং ও সংখ্যা সংক্রান্ত ধরন কাজ করে। স্ট্রিং প্যারামিটার ভ্যালু সর্বাধিক ১০০ অক্ষরের হতে পারে। "firebase", "google" এবং "ga_" প্রিফিক্স রিজার্ভ করা আছে এবং প্যারামিটারের নামের জন্য ব্যবহার করা উচিত নয়।

কাস্টম ইভেন্ট

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

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

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

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

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

সঠিক প্যারামিটার ভ্যালু হল String ও num. কোনও কী-এর ভ্যালু null হিসেবে সেট করলে সেই প্যারামিটার মুছে যায়। নাল ভ্যালু পাস করলে সব প্যারামিটার মুছে যায়।

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

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

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