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

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


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

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

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

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

শুরু করার আগে

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

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

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

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

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

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

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

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

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

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

  1. আপনার FirebaseCore মডিউলটি আপনার UIApplicationDelegate-এ ইমপোর্ট করুন, সেইসাথে আপনার অ্যাপ ডেলিগেট ব্যবহার করে এমন যেকোনও 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 ব্যবহার করলে, আপনাকে অবশ্যই একটি অ্যাপ্লিকেশন ডেলিগেট তৈরি করতে হবে এবং এটি UIApplicationDelegateAdaptor বা NSApplicationDelegateAdaptor-এর মাধ্যমে আপনার App struct-এর সাথে অ্যাটাচ করতে হবে। এছাড়াও, আপনাকে অবশ্যই অ্যাপ ডেলিগেট সোয়েজলিং বন্ধ করতে হবে। আরও তথ্যের জন্য, 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 যোগ করুন।

পরবর্তী ধাপ