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

সতর্কতা: Google Play Instant আর উপলভ্য থাকবে না। ডিসেম্বর ২০২৫ থেকে, Google Play-এর মাধ্যমে ইনস্ট্যান্ট অ্যাপ প্রকাশ করা যাবে না এবং সব Google Play পরিষেবা ইনস্ট্যান্ট API আর কাজ করবে না। ব্যবহারকারীদের আর কোনও উপায়ে Play-এর মাধ্যমে ইনস্ট্যান্ট অ্যাপ পরিষেবা দেওয়া হবে না।

Google Play Instant চালু হওয়ার পর থেকে ইকোসিস্টেম উন্নত করার জন্য ডেভেলপারদের মতামত এবং আমাদের ক্রমাগত বিনিয়োগের ভিত্তিতে আমরা এই পরিবর্তন করছি।

ব্যবহারকারীর সংখ্যা বাড়ানোর জন্য অপ্টিমাইজ করা চালিয়ে যেতে, আমরা ডেভেলপারদের তাদের নিয়মিত অ্যাপ বা গেমে ব্যবহারকারীদের রেফার করতে উৎসাহিত করি, ডিপলিঙ্ক ব্যবহার করে প্রাসঙ্গিক হলে তাদের নির্দিষ্ট জার্নি বা ফিচারে রিডাইরেক্ট করতে।

ইনস্ট্যান্ট বা ইনস্টল করা অ্যাপের সাফল্য ট্র্যাক করা প্রতিটি ডেভেলপারের জন্য গুরুত্বপূর্ণ। Google Play Instant-এর সাথে একাধিক অ্যানালিটিক্স লাইব্রেরি মানানসই, যার মধ্যে Fabric Answers, Localytics এবং Mixpanel অন্তর্ভুক্ত।

আপনার বর্তমান অ্যানালিটিক্স সমাধান তালিকাভুক্ত না থাকলে বা আপনি যদি দেখেন যে এটি Google Play Instant-এর সাথে কাজ করে না, তাহলে আপনার টেলিমেট্রি সমাধান হিসেবে Firebase-এর জন্য Google Analytics ব্যবহার করার কথা বিবেচনা করুন। এই পৃষ্ঠায়, ইনস্ট্যান্ট অ্যাপ প্রোজেক্টে Firebase-এর জন্য Google Analytics কীভাবে সেট-আপ করতে হয় তা বর্ণনা করা হয়েছে।

ইনস্ট্যান্ট অ্যাপ প্রোজেক্টে 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'
   }

   Kotlin

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

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

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

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

আপনার ইনস্টল করা এবং ইনস্ট্যান্ট অ্যাপ, দুটিই যেহেতু প্যাকেজের নাম শেয়ার করে, তাই আপনি হয়ত প্রতিটি থেকে সংগ্রহ করা ইভেন্ট এবং ডেটা আলাদা করতে চাইবেন। Analytics-এ আপনার ইনস্ট্যান্ট ও ইনস্টল করা অ্যাপের মধ্যে পার্থক্য করতে, app_type ব্যবহারকারীর প্রপার্টি সেট করুন, যেখানে ইনস্ট্যান্ট অ্যাপের জন্য "ইনস্ট্যান্ট" এবং ইনস্টল করা অ্যাপের জন্য "ইনস্টল করা" ভ্যালু সেট করুন।

মনে রাখবেন: ইনস্ট্যান্ট অ্যাপ এবং ইনস্টল করা অ্যাপ, উভয়কেই app_type ব্যবহারকারীর প্রপার্টি প্রয়োগ করতে হবে। এছাড়াও, ইনস্ট্যান্ট অ্যাপের আগে আপনাকে অবশ্যই ইনস্টল করা অ্যাপ প্রকাশ করতে হবে যেটিতে app_type আছে। অন্যথায়, ব্যবহারকারী অ্যাপ ইনস্টল করলে Analytics ইনস্টল করা অ্যাপের ইভেন্ট ইনস্ট্যান্ট অ্যাপে লগ করে।

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

Kotlin

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 ব্যবহারকারীর প্রপার্টি সেট করার পরে, আপনি Analytics কনসোলের ইভেন্ট ট্যাবে গিয়ে কোনও ইভেন্ট বেছে নিতে এবং তারপরে app_type ভ্যালু অনুযায়ী ইভেন্ট ফিল্টার করতে পারবেন। ফলাফল হিসেবে পাওয়া ডেটা প্রোজেকশন থেকে আপনি ইনস্ট্যান্ট বা ইনস্টল করা অ্যাপে নির্দিষ্ট ইভেন্টের সংখ্যা জানতে পারবেন।

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

Analytics ইভেন্ট ব্যাখ্যা করা

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

নাম	Analytics ভ্যালু	সংজ্ঞা
চিকিৎসকের সাথে সাক্ষাতের তথ্য	session_start	সেশন শুরু হয়েছে। এই ইভেন্ট অটোমেটিক ট্র্যাক করা হয়।
ফিজিক্যাল কেনাকাটা	Firebase.Event.ECOMMERCE_PURCHASE	ফিজিক্যাল কেনাকাটা। আপনার কোডে এই ইভেন্টটি আপনাকে স্পষ্টভাবে ট্র্যাক করতে হবে।
ডিজিটাল কেনাকাটা	in_app_purchase	ডিজিটাল অ্যাপ-মধ্যস্থ কেনাকাটা। এই ইভেন্ট অটোমেটিক ট্র্যাক করা হয়।
অ্যাপে কাটানো সময়	user_engagement	অ্যাপটি ফোরগ্রাউন্ডে যতটা সময় কাটায়। এই ইভেন্ট অটোমেটিক ট্র্যাক করা হয়।
ইনস্ট্যান্ট অ্যাপের প্রসঙ্গ	app_type	ইনস্ট্যান্ট বা ইনস্টল করা কনটেক্সটে চলা অ্যাপ থেকে ইভেন্ট তৈরি হয়েছে। আপনার কোডে এই ইভেন্টটি আপনাকে স্পষ্টভাবে ট্র্যাক করতে হবে। উপরে ইনস্টল করা ও ইনস্ট্যান্ট অ্যাপ ডেটার মধ্যে পার্থক্য দেখুন।
ফিরে আসা দর্শক	session_start.count ও app_type	দুই বা তার বেশি বার ভিজিট করেছেন এমন ব্যবহারকারীদের অডিয়েন্স। আপনাকে অবশ্যই স্পষ্টভাবে app_type ইভেন্ট ট্র্যাক করতে হবে; session_start আপনার জন্য ট্র্যাক করা হয়। উপরে ইনস্টল করা ও ইনস্ট্যান্ট অ্যাপ ডেটার মধ্যে পার্থক্য দেখুন।

Analytics-এ আপনি যেসব ইভেন্টের কনস্ট্যান্ট সংগ্রহ করতে পারবেন, সেই সম্পর্কে আরও জানতে, FirebaseAnalytics.Event দেখুন।