লগ ইভেন্ট

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

শুরু করার আগে

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

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

লগ ইভেন্ট

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

পূর্বনির্ধারিত ইভেন্টগুলি

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

আপনি এপিআই রেফারেন্সে প্রস্তাবিত ইভেন্ট টাইপগুলোর জন্য লগ মেথডগুলো খুঁজে পেতে পারেন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি 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,
    },
);

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

• কাস্টম প্যারামিটার: কাস্টম প্যারামিটার অ্যানালিটিক্স রিপোর্টে ডাইমেনশন বা মেট্রিক হিসেবে ব্যবহার করা যেতে পারে। আপনি অ-সংখ্যাসূচক ইভেন্ট প্যারামিটার ডেটার জন্য কাস্টম ডাইমেনশন এবং সংখ্যায় ভালোভাবে উপস্থাপন করা যায় এমন যেকোনো প্যারামিটার ডেটার জন্য কাস্টম মেট্রিক ব্যবহার করতে পারেন। SDK ব্যবহার করে একটি কাস্টম প্যারামিটার লগ করার পরে, সেই কাস্টম প্যারামিটারগুলো যেন অ্যানালিটিক্স রিপোর্টে প্রদর্শিত হয় তা নিশ্চিত করতে ডাইমেনশন বা মেট্রিকটি রেজিস্টার করুন। এটি করার জন্য Analytics > Events > Manage Custom Definitions > Create Custom Dimensions ব্যবহার করুন।

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

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

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

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

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

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

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

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

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

বৈধ প্যারামিটার মান হলো String এবং num। কোনো key-এর মান null সেট করলে সেই প্যারামিটারটি মুছে যায়। null মান পাস করলে সমস্ত প্যারামিটার মুছে যায়।

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

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

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