Google Analytics দিয়ে শুরু করুন


এই কুইকস্টার্টটি আপনাকে দেখায় কিভাবে আপনার অ্যাপে Google Analytics যোগ করবেন এবং ইভেন্ট লগ করা শুরু করবেন।

Google Analytics আপনার অ্যাপের জন্য ব্যবহার এবং আচরণের ডেটা সংগ্রহ করে। SDK দুটি প্রাথমিক ধরণের তথ্য লগ করে:

  • ইভেন্ট: আপনার অ্যাপে কী ঘটছে, যেমন ব্যবহারকারীর অ্যাকশন, সিস্টেম ইভেন্ট বা ত্রুটি।
  • ব্যবহারকারীর বৈশিষ্ট্য: আপনার ব্যবহারকারীর অংশ, যেমন ভাষা পছন্দ বা ভৌগোলিক অবস্থান বর্ণনা করার জন্য আপনি যে বৈশিষ্ট্যগুলি সংজ্ঞায়িত করেন।

Analytics স্বয়ংক্রিয়ভাবে কিছু ইভেন্ট এবং ব্যবহারকারীর বৈশিষ্ট্য লগ করে; এগুলি সক্ষম করার জন্য আপনাকে কোনও কোড যুক্ত করার প্রয়োজন নেই।

শুরু করার আগে

  1. যদি আপনি ইতিমধ্যেই না করে থাকেন, তাহলে আপনার অ্যাপল প্রোজেক্টে Firebase যোগ করুন এবং নিশ্চিত করুন যে আপনার Firebase প্রোজেক্টে Google Analytics সক্রিয় আছে:

    • যদি আপনি একটি নতুন Firebase প্রকল্প তৈরি করেন, তাহলে প্রকল্প তৈরির কর্মপ্রবাহের সময় Google Analytics সক্ষম করুন।

    • যদি আপনি এমন একটি বিদ্যমান Firebase প্রকল্প ব্যবহার করেন যেখানে Google Analytics সক্ষম করা নেই, তাহলে আপনার > প্রকল্প সেটিংস এটি সক্রিয় করতে।

    যখন আপনি আপনার প্রোজেক্টে Google Analytics সক্ষম করেন, তখন আপনার Firebase অ্যাপগুলি Google Analytics ডেটা স্ট্রিমের সাথে লিঙ্ক করা হয়।

  2. (প্রস্তাবিত) । দর্শক এবং প্রচারণার বৈশিষ্ট্যের মতো অতিরিক্ত বৈশিষ্ট্যগুলি সক্ষম করতে আপনার প্রকল্পে AdSupport ফ্রেমওয়ার্ক যোগ করুন ।

আপনার অ্যাপে Analytics SDK যোগ করুন

ফায়ারবেস নির্ভরতা ইনস্টল এবং পরিচালনা করতে সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন।

  1. Xcode-এ, আপনার অ্যাপ প্রজেক্ট খোলা থাকা অবস্থায়, File > Add Packages- এ নেভিগেট করুন।
  2. অনুরোধ করা হলে, Firebase Apple platforms SDK সংগ্রহস্থল যোগ করুন: 
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Analytics লাইব্রেরিটি বেছে নিন।
  4. আপনার টার্গেটের বিল্ড সেটিংসের অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে -ObjC ফ্ল্যাগ যোগ করুন।
  5. Analytics এর সর্বোত্তম অভিজ্ঞতার জন্য, আমরা আপনার Firebase প্রকল্পে Google Analytics সক্ষম করার এবং আপনার অ্যাপে Google Analytics এর জন্য Firebase SDK যোগ করার পরামর্শ দিচ্ছি। আপনি IDFA সংগ্রহ ছাড়াই অথবা IDFA সংগ্রহ সহ লাইব্রেরি নির্বাচন করতে পারেন। Firebase SDK এর জন্য Google Analytics এর সর্বশেষ মডিউল সংগঠন সম্পর্কে আমাদের প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী দেখুন।
  6. শেষ হয়ে গেলে, Xcode স্বয়ংক্রিয়ভাবে ব্যাকগ্রাউন্ডে আপনার নির্ভরতাগুলি সমাধান এবং ডাউনলোড করা শুরু করবে।

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

এরপর, কিছু কনফিগারেশন ধাপ সম্পাদন করুন:

  1. আপনার UIApplicationDelegate এ FirebaseCore মডিউলটি আমদানি করুন, সেইসাথে আপনার অ্যাপ প্রতিনিধিদের দ্বারা ব্যবহৃত অন্য যেকোনো Firebase মডিউল । উদাহরণস্বরূপ, Cloud Firestore এবং Authentication ব্যবহার করতে:

    সুইফটইউআই 

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    সুইফট 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    অবজেক্টিভ-সি 

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. আপনার অ্যাপ ডেলিগেটের application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে একটি FirebaseApp শেয়ার করা ইনস্ট্যান্স কনফিগার করুন:

    সুইফটইউআই 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    সুইফট 

    // Use Firebase library to configure APIs
FirebaseApp.configure()

    অবজেক্টিভ-সি 

    // Use Firebase library to configure APIs
[FIRApp configure];
  3. যদি আপনি SwiftUI ব্যবহার করেন, তাহলে আপনাকে একটি অ্যাপ্লিকেশন ডেলিগেট তৈরি করতে হবে এবং UIApplicationDelegateAdaptor অথবা NSApplicationDelegateAdaptor মাধ্যমে আপনার App স্ট্রাক্টের সাথে এটি সংযুক্ত করতে হবে। আপনাকে অ্যাপ ডেলিগেট সুইজলিংও অক্ষম করতে হবে। আরও তথ্যের জন্য, SwiftUI নির্দেশাবলী দেখুন।

    সুইফটইউআই 

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}


(ঐচ্ছিক) অ্যাপল বিজ্ঞাপন নেটওয়ার্ক অ্যাট্রিবিউশন নিবন্ধন অক্ষম করুন

আপনার সুবিধার জন্য, SDK স্বয়ংক্রিয়ভাবে SKAdNetwork এর মাধ্যমে বিজ্ঞাপন নেটওয়ার্ক অ্যাট্রিবিউশনের জন্য Apple-এর সাথে আপনার অ্যাপটি নিবন্ধন করে । আপনি যদি এই বৈশিষ্ট্যটি অক্ষম করতে চান, তাহলে আপনার অ্যাপের info.plist ফাইলে GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED এর মান NO (Boolean) এ সেট করুন।

ইভেন্ট লগ করা শুরু করুন

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

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

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

সুইফট

দ্রষ্টব্য: এই Firebase পণ্যটি macOS টার্গেটে উপলব্ধ নয়। 
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])
ViewController.swift

অবজেক্টিভ-সি

দ্রষ্টব্য: এই Firebase পণ্যটি macOS টার্গেটে উপলব্ধ নয়। 
[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];
ViewController.m

Xcode ডিবাগ কনসোলে এই ইভেন্টটি দেখতে, Analytics ডিবাগিং সক্ষম করুন:

  1. Xcode-এ, Product > Scheme > Edit scheme... নির্বাচন করুন।
  2. বাম মেনু থেকে Run নির্বাচন করুন।
  3. আর্গুমেন্টস ট্যাব নির্বাচন করুন।
  4. "লঞ্চে পাস করা আর্গুমেন্ট" বিভাগে, -FIRAnalyticsDebugEnabled যোগ করুন।

পরবর্তী পদক্ষেপ