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


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

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

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

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

শুরু করার আগে

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

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

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

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

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

  1. আপনার মডিউল (অ্যাপ-লেভেল) গ্র্যাডেল ফাইলে (সাধারণত <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:34.5.0"))
    
        // 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:23.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

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

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