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

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

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

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

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

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

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

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

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

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

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

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

    dependencies {
        // Import the BoM for the Firebase platform
        implementation(platform("com.google.firebase:firebase-bom:32.7.4"))
    
        // 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 লাইব্রেরি সংস্করণ তার নির্ভরতা লাইনে উল্লেখ করতে হবে।

    মনে রাখবেন যে আপনি যদি আপনার অ্যাপে একাধিক ফায়ারবেস লাইব্রেরি ব্যবহার করেন, আমরা দৃঢ়ভাবে লাইব্রেরি সংস্করণগুলি পরিচালনা করতে 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:21.5.1")
    }
    
    একটি কোটলিন-নির্দিষ্ট লাইব্রেরি মডিউল খুঁজছেন? অক্টোবর 2023 থেকে শুরু হচ্ছে (Firebase BoM 32.5.0) , Kotlin এবং Java ডেভেলপাররা প্রধান লাইব্রেরি মডিউলের উপর নির্ভর করতে পারে (বিস্তারিত জানতে, এই উদ্যোগ সম্পর্কে প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন)।

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

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

    Kotlin+KTX

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

    Java

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

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

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

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

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

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")
}

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

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

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