ইভেন্ট লগ করা

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

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

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

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

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

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

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

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

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

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

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

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

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