লগ ইভেন্ট

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

ইভেন্টগুলি আপনার অ্যাপে কী ঘটছে তার অন্তর্দৃষ্টি প্রদান করে, যেমন ব্যবহারকারীর অ্যাকশন, সিস্টেম ইভেন্ট বা ত্রুটি।

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

তুমি শুরু করার আগে

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

লগ ইভেন্ট

আপনি FirebaseApp ইন্সট্যান্স কনফিগার করার পরে, আপনি logEvent() পদ্ধতিতে ইভেন্ট লগ করা শুরু করতে পারেন।

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

আপনি সুইফট এবং অবজেক্টিভ-সি- এর জন্য ধ্রুবক রেফারেন্সে বাস্তবায়নের বিশদ খুঁজে পেতে পারেন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি প্রস্তাবিত kFIRSelectContent ইভেন্ট লগ করতে হয়:

সুইফট

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

উদ্দেশ্য গ

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

নির্ধারিত পরামিতিগুলি ছাড়াও, আপনি যেকোনো ইভেন্টে নিম্নলিখিত পরামিতিগুলি যোগ করতে পারেন:

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

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

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

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

সুইফট

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

উদ্দেশ্য গ

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

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

কাস্টম প্যারামিটারের মতো, সেই কাস্টম প্যারামিটারগুলি বিশ্লেষণ প্রতিবেদনে উপস্থিত হয় তা নিশ্চিত করতে ডিফল্ট ইভেন্ট প্যারামিটারগুলি নিবন্ধন করুন৷

সুইফট

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

উদ্দেশ্য গ

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

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

একটি ডিফল্ট প্যারামিটার সাফ করতে, nil এ সেট করা প্যারামিটার সহ setDefaultEventParameters পদ্ধতিতে কল করুন।

এক্সকোড ডিবাগ কনসোলে ইভেন্টগুলি দেখুন

ইভেন্টগুলি সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে আপনি SDK দ্বারা ইভেন্টগুলির লগিং নিরীক্ষণ করতে ভার্বোজ লগিং সক্ষম করতে পারেন৷ এতে স্বয়ংক্রিয়ভাবে এবং ম্যানুয়ালি লগ করা ইভেন্ট উভয়ই অন্তর্ভুক্ত থাকে।

আপনি নিম্নরূপ ভার্বোজ লগিং সক্ষম করতে পারেন:

  1. Xcode-এ, পণ্য > স্কিম > স্কিম সম্পাদনা করুন নির্বাচন করুন...
  2. বাম মেনু থেকে রান নির্বাচন করুন।
  3. আর্গুমেন্ট ট্যাব নির্বাচন করুন।
  4. আর্গুমেন্ট পাসড অন লঞ্চ বিভাগে, যোগ করুন -FIRAnalyticsDebugEnabled

পরের বার যখন আপনি আপনার অ্যাপটি চালাবেন, আপনার ইভেন্টগুলি Xcode ডিবাগ কনসোলে প্রদর্শিত হবে, যা আপনাকে অবিলম্বে ইভেন্টগুলি পাঠানো হচ্ছে তা যাচাই করতে সহায়তা করবে।

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

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

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

,

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

ইভেন্টগুলি আপনার অ্যাপে কী ঘটছে তার অন্তর্দৃষ্টি প্রদান করে, যেমন ব্যবহারকারীর অ্যাকশন, সিস্টেম ইভেন্ট বা ত্রুটি।

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

তুমি শুরু করার আগে

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

লগ ইভেন্ট

আপনি FirebaseApp ইন্সট্যান্স কনফিগার করার পরে, আপনি logEvent() পদ্ধতিতে ইভেন্ট লগ করা শুরু করতে পারেন।

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

আপনি সুইফট এবং অবজেক্টিভ-সি- এর জন্য ধ্রুবক রেফারেন্সে বাস্তবায়নের বিশদ খুঁজে পেতে পারেন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি প্রস্তাবিত kFIRSelectContent ইভেন্ট লগ করতে হয়:

সুইফট

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

উদ্দেশ্য গ

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

নির্ধারিত পরামিতিগুলি ছাড়াও, আপনি যেকোনো ইভেন্টে নিম্নলিখিত পরামিতিগুলি যোগ করতে পারেন:

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

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

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

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

সুইফট

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

উদ্দেশ্য গ

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

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

কাস্টম প্যারামিটারের মতো, সেই কাস্টম প্যারামিটারগুলি বিশ্লেষণ প্রতিবেদনে উপস্থিত হয় তা নিশ্চিত করতে ডিফল্ট ইভেন্ট প্যারামিটারগুলি নিবন্ধন করুন৷

সুইফট

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

উদ্দেশ্য গ

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

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

একটি ডিফল্ট প্যারামিটার সাফ করতে, nil এ সেট করা প্যারামিটার সহ setDefaultEventParameters পদ্ধতিতে কল করুন।

এক্সকোড ডিবাগ কনসোলে ইভেন্টগুলি দেখুন

ইভেন্টগুলি সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে আপনি SDK দ্বারা ইভেন্টগুলির লগিং নিরীক্ষণ করতে ভার্বোজ লগিং সক্ষম করতে পারেন৷ এতে স্বয়ংক্রিয়ভাবে এবং ম্যানুয়ালি লগ করা ইভেন্ট উভয়ই অন্তর্ভুক্ত থাকে।

আপনি নিম্নরূপ ভার্বোজ লগিং সক্ষম করতে পারেন:

  1. Xcode-এ, পণ্য > স্কিম > স্কিম সম্পাদনা করুন নির্বাচন করুন...
  2. বাম মেনু থেকে রান নির্বাচন করুন।
  3. আর্গুমেন্ট ট্যাব নির্বাচন করুন।
  4. আর্গুমেন্ট পাসড অন লঞ্চ বিভাগে, যোগ করুন -FIRAnalyticsDebugEnabled

পরের বার যখন আপনি আপনার অ্যাপটি চালাবেন, আপনার ইভেন্টগুলি Xcode ডিবাগ কনসোলে প্রদর্শিত হবে, যা আপনাকে অবিলম্বে ইভেন্টগুলি পাঠানো হচ্ছে তা যাচাই করতে সহায়তা করবে।

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

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

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