iOS+ এর জন্য Google Analytics দিয়ে শুরু করুন

প্ল্যাটফর্ম নির্বাচন করুন: iOS+ অ্যান্ড্রয়েড ওয়েব ফ্লাটার ইউনিটি C++

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

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

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

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

শুরু করার আগে

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

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

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

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

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

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

ফায়ারবেস ডিপেন্ডেন্সিগুলো ইনস্টল ও পরিচালনা করতে সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন।

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

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

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

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

    SwiftUI 

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

    সুইফট 

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    উদ্দেশ্য-সি 

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

    SwiftUI 

    // 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 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()
      }
    }
  }
}


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

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

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

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

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

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

সুইফট 

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

উদ্দেশ্য-সি 

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

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

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

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