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

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


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

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

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

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

শুরু করার আগে

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

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

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

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

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

  1. আপনার মডিউল (অ্যাপ-লেভেল) Gradle ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts বা <project>/<app-module>/build.gradle), Android-এর জন্য Analytics লাইব্রেরির ডিপেন্ডেন্সি যোগ করুন। লাইব্রেরি ভার্সনিং নিয়ন্ত্রণ করতে আমরা Firebase Android BoM ব্যবহার করার সাজেশন দিই।

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:35.0.2"))
    
        // Add the dependency for the Analytics library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation("com.google.firebase:firebase-analytics")
    }

    Firebase Android BoM ব্যবহার করার মাধ্যমে, আপনার অ্যাপ সবসময় Firebase Android লাইব্রেরির মানানসই ভার্সন ব্যবহার করবে।

    (বিকল্প)  BoM ব্যবহার না করে Firebase লাইব্রেরি ডিপেন্ডেন্সি যোগ করুন

    আপনি যদি Firebase BoM ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে অবশ্যই প্রতিটি Firebase লাইব্রেরি ভার্সন এর ডিপেন্ডেন্সি লাইনে উল্লেখ করতে হবে।

    মনে রাখবেন, আপনার অ্যাপে একাধিক Firebase লাইব্রেরি ব্যবহার করলে, লাইব্রেরি ভার্সন ম্যানেজ করার জন্য আমরা BoM ব্যবহার করার জন্য বিশেষভাবে সাজেস্ট করি, যা নিশ্চিত করে যে সব ভার্সন মানানসই।

    dependencies {
        // Add the dependency for the Analytics library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation("com.google.firebase:firebase-analytics:24.0.0")
    }

  2. আপনার অ্যাক্টিভিটির একদম উপরে com.google.firebase.analytics.FirebaseAnalytics অবজেক্ট ঘোষণা করুন:

    Kotlin

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. onCreate() পদ্ধতিতে এটি শুরু করুন:

    Kotlin

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics

    Java

    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

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

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

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

ব্যবহারকারী আপনার অ্যাপের কোনও নির্দিষ্ট এলিমেন্টে ক্লিক করলে, নিম্নলিখিত কোডটি SELECT_CONTENT ইভেন্ট লগ করে।

Kotlin

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

SDK-এর মাধ্যমে ইভেন্টের লগিং মনিটর করতে আপনি ভার্বোস লগিং চালু করতে পারেন, যাতে ইভেন্ট সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে সাহায্য করা যায়। এর মধ্যে অটোমেটিক ও ম্যানুয়ালি লগ করা ইভেন্ট অন্তর্ভুক্ত।

আপনি adb কমান্ডের একটি সিরিজের মাধ্যমে ভার্বোস লগিং চালু করতে পারবেন:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

এই কমান্ড Android Studio logcat-এ আপনার ইভেন্ট দেখায়, যা আপনাকে ইভেন্ট পাঠানো হচ্ছে কিনা তা অবিলম্বে যাচাই করতে সাহায্য করে।

পরবর্তী ধাপ