আপনার ইনস্ট্যান্ট অ্যাপে Firebase-এর জন্য Google Analytics যোগ করুন

প্রতিটি ডেভেলপারের জন্য একটি অ্যাপের (তা ইনস্ট্যান্ট হোক বা ইনস্টল করা হোক) সাফল্য ট্র্যাক করা গুরুত্বপূর্ণ। বেশ কিছু অ্যানালিটিক্স লাইব্রেরি গুগল প্লে ইনস্ট্যান্ট-এর সাথে সামঞ্জস্যপূর্ণ, যার মধ্যে রয়েছে ফ্যাব্রিক অ্যানসারস , লোকালিটিক্স এবং মিক্সপ্যানেল ।

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

একটি ইনস্ট্যান্ট অ্যাপ প্রজেক্টে ফায়ারবেসের জন্য গুগল অ্যানালিটিক্স যোগ করা

1. Google Analytics for Firebase-এর জন্য গেটিং স্টার্টেড গাইডে বর্ণিত নির্দেশনাগুলো অনুসরণ করে আপনার অ্যাপে Firebase SDK যোগ করুন।
2. google-services প্লাগইনটির সর্বশেষ সংস্করণ ব্যবহার করুন।
3. প্রতিটি মডিউলে google-services.json ফাইলটি রাখুন।

4. প্রতিটি মডিউলের build.gradle ফাইলে নিম্নলিখিত লাইনটি যোগ করুন:

   গ্রুভি

   // android { ... }
   // dependencies { ... }
   plugins {
       id 'com.google.gms.google-services'
   }

   কোটলিন

   // android { ... }
   // dependencies { ... }
   plugins {
       id("com.google.gms.google-services")
   }

আপনার ইনস্ট্যান্ট অ্যাপ প্রজেক্টে একবার Google Analytics for Firebase যোগ করার পর, আপনি একটি ইনস্টলেবল অ্যাপ প্রজেক্টের মতোই Google Analytics for Firebase API-গুলো ব্যবহার করতে পারবেন।

Google Analytics for Firebase API-গুলি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও তথ্যের জন্য, Google Analytics for Firebase-এর গেটিং স্টার্টেড ডকুমেন্টেশন দেখুন।

ইনস্টল করা এবং তাৎক্ষণিক অ্যাপ ডেটার মধ্যে পার্থক্য করা

যেহেতু আপনার ইনস্টল করা এবং ইনস্ট্যান্ট অ্যাপ উভয়েরই প্যাকেজ নেম একই, তাই আপনি প্রতিটি থেকে সংগৃহীত ইভেন্ট এবং ডেটা আলাদা করতে চাইতে পারেন। অ্যানালিটিক্সে আপনার ইনস্ট্যান্ট এবং ইনস্টল করা অ্যাপগুলোকে আলাদা করতে, একটি app_type ইউজার প্রপার্টি সেট করুন, যেখানে ইনস্ট্যান্ট অ্যাপের জন্য ভ্যালু হবে "instant" এবং ইনস্টল করা অ্যাপের জন্য "installed"।

নিম্নলিখিত কোড স্নিপেটটি এমন একটি অ্যাক্টিভিটি দেখাচ্ছে যা একটি অ্যানালিটিক্স ইনস্ট্যান্স গ্রহণ করে এবং তারপর একটি ইউজার প্রপার্টি সেট করে। লক্ষ্য করুন যে, কোডটি অ্যাপের কনটেক্সট নির্ধারণ করতে onCreate(android.os.Bundle) মেথডে PackageManagerCompat.isInstantApp() ব্যবহার করেছে।

val STATUS_INSTALLED = "installed"
val STATUS_INSTANT = "instant"
val ANALYTICS_USER_PROP = "app_type"

private lateinit var firebaseAnalytics: FirebaseAnalytics

protected fun onCreate(savedInstanceState: Bundle?) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT)
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED)
    }
}

final String STATUS_INSTALLED = "installed";
final String STATUS_INSTANT = "instant";
final String ANALYTICS_USER_PROP = "app_type";

private FirebaseAnalytics firebaseAnalytics;

@Override
protected void onCreate(Bundle savedInstanceState) {
    ...

    firebaseAnalytics = FirebaseAnalytics.getInstance(this);

    // Determine the current app context, either installed or instant, then
    // set the corresponding user property for Google Analytics.
    if (InstantApps.getPackageManagerCompat(this).isInstantApp()) {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTANT);
    } else {
        firebaseAnalytics.setUserProperty(ANALYTICS_USER_PROP, STATUS_INSTALLED);
    }

}

একবার আপনি app_type ইউজার প্রপার্টি সেট করে নিলে, আপনি অ্যানালিটিক্স কনসোলের ` Events` ট্যাব থেকে একটি ইভেন্ট নির্বাচন করে ` app_type ভ্যালু দিয়ে ইভেন্টটি ফিল্টার করতে পারবেন। এর ফলে প্রাপ্ত ডেটা প্রোজেকশনটি আপনার ইনস্ট্যান্ট বা ইনস্টল করা অ্যাপে নির্দিষ্ট ইভেন্টটির সংখ্যা দেখাবে।

Google Analytics for Firebase-এ কীভাবে ইভেন্ট লগ করতে ও দেখতে হয় সে সম্পর্কে আরও তথ্যের জন্য, লগ ইভেন্টস (Log Events) দেখুন।

অ্যানালিটিক্স ইভেন্টগুলির ব্যাখ্যা

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

অ্যানালিটিক্সে সংগ্রহযোগ্য ইভেন্টগুলোর ধ্রুবক সম্পর্কে আরও তথ্যের জন্য, FirebaseAnalytics.Event দেখুন।