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

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

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

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

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

তুমি শুরু করার আগে

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

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

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

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

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

  1. Firebase Android BoM ব্যবহার করে, আপনার মডিউল (অ্যাপ-লেভেল) Gradle ফাইলে (সাধারণত app/build.gradle ) অ্যানালিটিক্স অ্যান্ড্রয়েড লাইব্রেরির জন্য নির্ভরতা ঘোষণা করুন।

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:30.3.1')
    
        // Declare 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 {
        // Declare 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:21.1.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:30.3.1')
    
        // Declare 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-ktx'
    }
    

    Firebase Android BoM ব্যবহার করে, আপনার অ্যাপ সবসময় Firebase Android লাইব্রেরির সামঞ্জস্যপূর্ণ সংস্করণ ব্যবহার করবে।

    (বিকল্প) BoM ব্যবহার না করে Firebase লাইব্রেরি নির্ভরতা ঘোষণা করুন

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

    মনে রাখবেন যে আপনি যদি আপনার অ্যাপে একাধিক Firebase লাইব্রেরি ব্যবহার করেন, তাহলে আমরা লাইব্রেরি সংস্করণগুলি পরিচালনা করতে BoM ব্যবহার করার সুপারিশ করি, যা নিশ্চিত করে যে সমস্ত সংস্করণ সামঞ্জস্যপূর্ণ।

    dependencies {
        // Declare 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-ktx:21.1.0'
    }
    

  2. আপনার কার্যকলাপের শীর্ষে com.google.firebase.analytics.FirebaseAnalytics অবজেক্ট ঘোষণা করুন:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

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

    Java

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

    Kotlin+KTX

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

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

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

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

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

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);

Kotlin+KTX

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

ইভেন্টগুলি সঠিকভাবে লগ করা হচ্ছে কিনা তা যাচাই করতে আপনি 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

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

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