অ্যান্ড্রয়েডের জন্য গুগল অ্যানালিটিক্স দিয়ে শুরু করুন

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

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

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

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

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

শুরু করার আগে

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

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

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

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

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

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

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.11.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 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.2.0")
}

  2. আপনার অ্যাক্টিভিটির শীর্ষে com.google.firebase.analytics.FirebaseAnalytics অবজেক্টটি ডিক্লেয়ার করুন:

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. onCreate() মেথডে এটি ইনিশিয়ালাইজ করুন:

    Kotlin 

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

    Java 

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

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

একটি 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")
}
MainActivity.kt

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);
MainActivity.java

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

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

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

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

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