এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে আপনার অ্যাপে ইভেন্ট লগ করবেন।
ইভেন্টগুলি আপনার অ্যাপে কী ঘটছে, যেমন ব্যবহারকারীর ক্রিয়া, সিস্টেম ইভেন্ট বা ত্রুটি সম্পর্কে অন্তর্দৃষ্টি প্রদান করে।
Analytics আপনার জন্য কিছু ইভেন্ট স্বয়ংক্রিয়ভাবে লগ করে; সেগুলি গ্রহণ করার জন্য আপনাকে কোনও কোড যোগ করতে হবে না। যদি আপনার অ্যাপের অতিরিক্ত ডেটা সংগ্রহের প্রয়োজন হয়, তাহলে আপনি আপনার অ্যাপে 500টি পর্যন্ত বিভিন্ন ধরণের Analytics ইভেন্ট লগ আপ করতে পারেন। আপনার অ্যাপ লগের মোট ইভেন্টের পরিমাণের কোনও সীমা নেই। মনে রাখবেন যে ইভেন্টের নামগুলি কেস-সংবেদনশীল এবং দুটি ইভেন্ট লগ করার ফলে যাদের নাম কেবল কেসের ক্ষেত্রে ভিন্ন হয়, দুটি স্বতন্ত্র ইভেন্ট তৈরি হয়।
শুরু করার আগে
নিশ্চিত করুন যে আপনি আপনার প্রকল্পটি সেট আপ করেছেন এবং Get Started with Analytics এ বর্ণিত Analytics অ্যাক্সেস করতে পারেন।
আপনি যদি ক্যাম্পেইন অ্যাট্রিবিউশন ডেটা সংগ্রহ করতে চান, তাহলে আপনার প্রকল্পে AdSupport ফ্রেমওয়ার্ক যোগ করতে ভুলবেন না।
ইভেন্ট লগ করুন
FirebaseApp ইনস্ট্যান্স কনফিগার করার পরে, আপনি logEvent() পদ্ধতি ব্যবহার করে ইভেন্ট লগ করা শুরু করতে পারেন।
শুরু করতে আপনাকে সাহায্য করার জন্য, Analytics SDK বিভিন্ন ধরণের অ্যাপের মধ্যে প্রচলিত বেশ কিছু প্রস্তাবিত ইভেন্ট সংজ্ঞায়িত করে, যার মধ্যে রয়েছে খুচরা ও ই-কমার্স, ভ্রমণ এবং গেমিং অ্যাপ। এই ইভেন্টগুলি সম্পর্কে আরও জানতে এবং কখন ব্যবহার করতে হবে তা জানতে, প্রস্তাবিত ইভেন্টগুলি দেখুন।
আপনি Swift এবং Objective-C এর ধ্রুবক রেফারেন্সে বাস্তবায়নের বিশদ জানতে পারবেন।
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি প্রস্তাবিত 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" }];
নির্ধারিত প্যারামিটারগুলি ছাড়াও, আপনি যেকোনো ইভেন্টে নিম্নলিখিত প্যারামিটারগুলি যোগ করতে পারেন:
কাস্টম প্যারামিটার: কাস্টম প্যারামিটারগুলি Analytics রিপোর্টে ডাইমেনশন বা মেট্রিক্স হিসেবে ব্যবহার করা যেতে পারে। আপনি নন-সাংখ্যিক ইভেন্ট প্যারামিটার ডেটার জন্য কাস্টম ডাইমেনশন এবং যেকোনো প্যারামিটার ডেটার জন্য কাস্টম মেট্রিক্স ব্যবহার করতে পারেন যা সংখ্যাসূচকভাবে আরও ভালোভাবে উপস্থাপন করা হয়। 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() পদ্ধতিতে একটি প্যারামিটার নির্দিষ্ট করা থাকে, তাহলে ডিফল্টের পরিবর্তে সেই মানটি ব্যবহার করা হবে।
একটি ডিফল্ট প্যারামিটার সাফ করতে, setDefaultEventParameters পদ্ধতিতে কল করুন এবং প্যারামিটারটি nil এ সেট করুন।
Xcode ডিবাগ কনসোলে ইভেন্টগুলি দেখুন
ইভেন্টগুলি সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে SDK দ্বারা ইভেন্ট লগিং পর্যবেক্ষণ করার জন্য আপনি ভার্বোজ লগিং সক্ষম করতে পারেন। এর মধ্যে স্বয়ংক্রিয় এবং ম্যানুয়ালি লগ করা ইভেন্ট উভয়ই অন্তর্ভুক্ত।
আপনি নিম্নরূপ ভার্বোজ লগিং সক্ষম করতে পারেন:
- Xcode-এ, Product > Scheme > Edit scheme... নির্বাচন করুন।
- বাম মেনু থেকে Run নির্বাচন করুন।
- আর্গুমেন্টস ট্যাব নির্বাচন করুন।
- "লঞ্চে পাস করা আর্গুমেন্ট" বিভাগে,
-FIRAnalyticsVerboseLoggingEnabledযোগ করুন।
পরের বার যখন আপনি আপনার অ্যাপটি চালাবেন, তখন আপনার ইভেন্টগুলি Xcode ডিবাগ কনসোলে প্রদর্শিত হবে, যা আপনাকে অবিলম্বে যাচাই করতে সাহায্য করবে যে ইভেন্টগুলি পাঠানো হচ্ছে।
ড্যাশবোর্ডে ইভেন্টগুলি দেখুন
আপনি Firebase কনসোল ড্যাশবোর্ডে আপনার ইভেন্টগুলির সমষ্টিগত পরিসংখ্যান দেখতে পারেন। এই ড্যাশবোর্ডগুলি সারা দিন পর্যায়ক্রমে আপডেট হয়। তাৎক্ষণিক পরীক্ষার জন্য, পূর্ববর্তী বিভাগে বর্ণিত লগক্যাট আউটপুট ব্যবহার করুন।
আপনি Firebase কনসোলের ইভেন্টস ড্যাশবোর্ড থেকে এই ডেটা অ্যাক্সেস করতে পারবেন। এই ড্যাশবোর্ডটি আপনার অ্যাপ দ্বারা লগ করা প্রতিটি স্বতন্ত্র ধরণের ইভেন্টের জন্য স্বয়ংক্রিয়ভাবে তৈরি ইভেন্ট রিপোর্টগুলি দেখায়।