iOS+-এর জন্য Google Analytics ব্যবহার করা শুরু করা

প্ল্যাটফর্ম বেছে নিন: iOS+ Android ওয়েব Flutter Unity C++


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

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

  • ইভেন্ট: আপনার অ্যাপে কী ঘটছে, যেমন ব্যবহারকারীর অ্যাকশন, সিস্টেম ইভেন্ট বা সমস্যা।
  • ব্যবহারকারীর প্রপার্টি: আপনার ব্যবহারকারীর বেসের সেগমেন্ট বর্ণনা করার জন্য আপনি যেসব অ্যাট্রিবিউট নির্ধারণ করেন, যেমন পছন্দের ভাষা বা ভৌগোলিক লোকেশন।

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

AI-এর মাধ্যমে সহায়তা পেতে, নিচের প্রম্পটটি আপনার AI কোডিং এজেন্টে (যেমন Antigravity, Claude Code, Codex ও Cursor) কপি করুন। আপনি প্রম্পট কাস্টমাইজ করতে এবং আপনার এজেন্টের সাথে ইটারেট করতে পারবেন। ইনস্টলেশন সংক্রান্ত বিস্তারিত তথ্যের জন্য Firebase এজেন্ট সংক্রান্ত দক্ষতা দেখুন। 

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`.  Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up Google Analytics for Firebase and log screen view events in my app.

শুরু করার আগে

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

    • আপনি নতুন Firebase প্রোজেক্ট তৈরি করলে, প্রোজেক্ট তৈরির ওয়ার্কফ্লো চলাকালীন Google Analytics চালু করুন।

    • আপনি যদি আগে থেকে থাকা এমন কোনও Firebase প্রোজেক্ট ব্যবহার করেন যাতে Google Analytics চালু করা নেই, তাহলে আপনি সেটিংস > ইন্টিগ্রেশন ট্যাব থেকে এটি চালু করতে পারবেন।

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

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

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

Firebase ডিপেন্ডেন্সি ইনস্টল ও ম্যানেজ করতে Swift প্যাকেজ ম্যানেজার ব্যবহার করুন।

আপনার Apple প্রোজেক্টে Firebase SDK যোগ করার বিভিন্ন উপায় সম্পর্কে জানতে
  1. Xcode-এ, আপনার অ্যাপ প্রোজেক্ট খোলা রেখে, ফাইল > প্যাকেজ যোগ করুন বিকল্পে নেভিগেট করুন।
  2. প্রম্পট করা হলে, Firebase Apple প্ল্যাটফর্ম 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 সংগ্রহ সহ লাইব্রেরি বেছে নিতে পারেন। Google Analytics for Firebase SDK-তে মডিউলের লেটেস্ট অর্গানাইজেশন সম্পর্কে আমাদের প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।
  6. হয়ে গেলে, Xcode অটোমেটিক ব্যাকগ্রাউন্ডে আপনার ডিপেন্ডেন্সি সমাধান ও ডাউনলোড করা শুরু করবে।

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

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

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

    SwiftUI

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

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

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

    SwiftUI

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

    Swift

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

    Objective-C

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

    SwiftUI

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

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


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

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

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

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

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

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

Swift

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

Objective-C

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

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

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

পরবর্তী ধাপ