লগ ইভেন্ট

iOS+ অ্যান্ড্রয়েড ওয়েব ফ্লাটার

এই নির্দেশিকা আপনাকে দেখায় কিভাবে আপনার অ্যাপে ইভেন্ট লগ করবেন।

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

আপনি শুরু করার আগে

নিশ্চিত করুন যে আপনি আপনার প্রোজেক্ট সেট আপ করেছেন এবং Get Started with Analytics- এ বর্ণিত Analytics অ্যাক্সেস করতে পারেন।

লগ ইভেন্ট

আপনি একটি FirebaseAnalytics দৃষ্টান্ত তৈরি করার পরে, আপনি লাইব্রেরির log - পদ্ধতিগুলির সাথে ইভেন্টগুলি লগ করতে এটি ব্যবহার করতে পারেন।

পূর্বনির্ধারিত ঘটনা

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

দ্রষ্টব্য: প্রতিবেদনে সর্বাধিক বিশদ পেতে, প্রস্তাবিত ইভেন্টগুলি লগ করুন যা আপনার অ্যাপ এবং তাদের নির্ধারিত পরামিতিগুলির জন্য অর্থপূর্ণ। এটিও নিশ্চিত করে যে আপনি সর্বশেষ Google Analytics বৈশিষ্ট্যগুলি উপলব্ধ হওয়ার সাথে সাথে উপকৃত হবেন৷

আপনি 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,
    },
);

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

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

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

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

• প্যারামিটারের নাম 40 অক্ষর পর্যন্ত লম্বা হতে পারে এবং একটি বর্ণানুক্রমিক অক্ষর দিয়ে শুরু করতে হবে এবং শুধুমাত্র বর্ণসংখ্যার অক্ষর এবং আন্ডারস্কোর থাকতে হবে। স্ট্রিং এবং সংখ্যার ধরন সমর্থিত। স্ট্রিং প্যারামিটারের মান 100 অক্ষর পর্যন্ত লম্বা হতে পারে। "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() পদ্ধতিতে কল করুন।

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

আপনি Firebase কনসোল ড্যাশবোর্ডে আপনার ইভেন্টের সমষ্টিগত পরিসংখ্যান দেখতে পারেন। এই ড্যাশবোর্ডগুলি সারাদিন পর্যায়ক্রমে আপডেট হয়। তাৎক্ষণিক পরীক্ষার জন্য, পূর্ববর্তী বিভাগে বর্ণিত logcat আউটপুট ব্যবহার করুন।

আপনি Firebase কনসোলে ইভেন্ট ড্যাশবোর্ড থেকে এই ডেটা অ্যাক্সেস করতে পারেন। এই ড্যাশবোর্ডটি ইভেন্ট রিপোর্টগুলি দেখায় যা আপনার অ্যাপ দ্বারা লগ করা প্রতিটি স্বতন্ত্র ধরণের ইভেন্টের জন্য স্বয়ংক্রিয়ভাবে তৈরি হয়৷