Firebase কাস্টম ইভেন্টের জন্য Google Analytics সহ Google বিজ্ঞাপন - Android

১. ভূমিকা

সর্বশেষ হালনাগাদ: ২০২০-১২-১৪

আপনি যা তৈরি করবেন

এই কোডল্যাবে, আপনি শিখবেন কিভাবে Google Analytics for Firebase (GA4F)-এর সাথে ইভেন্ট প্রয়োগ করতে হয় এবং Google Ads-এর মাধ্যমে অ্যাকশন ক্যাম্পেইন চালু করতে হয়।

এই কোডল্যাবটি GA4F ব্যবহার করে ইভেন্ট প্রয়োগ করা এবং Google Ads-এ সেই ইভেন্টগুলো ইম্পোর্ট করার উপর আলোকপাত করে। আপনি যদি Firebase দিয়ে একটি অ্যান্ড্রয়েড অ্যাপ তৈরি করা শিখতে চান, তাহলে অনুগ্রহ করে Firebase Android Codelab-Build Friendly Chat দেখুন।

আপনি যা শিখবেন

• কিভাবে ফায়ারবেস প্রজেক্ট তৈরি করবেন
• অ্যান্ড্রয়েড অ্যাপে কীভাবে ফায়ারবেস এসডিকে প্রয়োগ করবেন
• কীভাবে ইভেন্ট এবং প্যারামিটার তৈরি করতে হয়।
• ফায়ারবেস থেকে গুগল অ্যাডস-এ ইভেন্ট ইম্পোর্ট করার পদ্ধতি
• কাস্টম ইভেন্ট ব্যবহার করে গুগল অ্যাডস অ্যাকশন ক্যাম্পেইন চালু করুন।

আপনার যা যা লাগবে

• অ্যান্ড্রয়েড স্টুডিও ৩.৬ বা উচ্চতর
• ফায়ারবেস অ্যাকাউন্ট
• গুগল বিজ্ঞাপন অ্যাকাউন্ট

২. একটি ফায়ারবেস প্রজেক্ট তৈরি ও সেট আপ করুন।

Firebase ব্যবহার শুরু করতে, আপনাকে একটি Firebase প্রজেক্ট তৈরি ও সেট আপ করতে হবে।

একটি ফায়ারবেস প্রজেক্ট তৈরি করুন

1. Firebase- এ সাইন ইন করুন।

ফায়ারবেস কনসোলে, 'অ্যাড প্রজেক্ট' (বা 'ক্রিয়েট এ প্রজেক্ট')-এ ক্লিক করুন এবং আপনার ফায়ারবেস প্রজেক্টটির নাম আপনার পছন্দমতো দিন।

2. প্রজেক্ট তৈরির অপশনগুলো একে একে দেখুন। অনুরোধ করা হলে Firebase-এর শর্তাবলী মেনে নিন। এই প্রজেক্টের জন্য আপনাকে Google Analytics চালু করতে হবে, কারণ অ্যাকশন ইভেন্ট এবং কনভার্সন ট্র্যাক করার জন্য আপনার Google Analytics ইভেন্টের প্রয়োজন হবে।

ফায়ারবেস প্রজেক্ট সম্পর্কে আরও জানতে, “ফায়ারবেস প্রজেক্ট বুঝুন” দেখুন।

3. গুগল অ্যানালিটিক্স অ্যাকাউন্ট বেছে নিন। আপনার যদি একটি থাকে তবে সেটি বেছে নিন অথবা একটি নতুন তৈরি করুন। 'Create project' বোতামে ক্লিক করুন।

4. এখন ফায়ারবেস প্রোজেক্ট বিল্ড সম্পন্ন হয়েছে!

পরবর্তী ধাপে, আপনি শিখবেন কীভাবে আপনার অ্যান্ড্রয়েড অ্যাপে ফায়ারবেস যুক্ত করতে হয়।

৩. আপনার অ্যান্ড্রয়েড অ্যাপে ফায়ারবেস যুক্ত করুন

অ্যাপে নিবন্ধন করুন

1. Firebase কনসোলে, বাম দিকের নেভিগেশন থেকে Project Overview নির্বাচন করুন, তারপর "Get started by adding Firebase to your app" এর নিচে থাকা Android বোতামটিতে ক্লিক করুন।

2. প্রয়োজনীয় তথ্য পূরণ করুন।

অ্যান্ড্রয়েড প্যাকেজ নেমের জন্য, অ্যান্ড্রয়েড স্টুডিওতে অ্যাপ ডিরেক্টরিতে গিয়ে build.gradle নামের ফাইলটি খুলুন। ফাইলটির ভেতরে applicationId খুঁজুন। এই ভ্যালুটিই হলো অ্যান্ড্রয়েড প্যাকেজ নেম। এই ভ্যালুটি কপি করে পেস্ট করুন।

এখানে আমাদের SHA-1 কী-এর প্রয়োজন নেই, যদি না আপনি গুগল সাইন ইন অথবা ফায়ারবেস ডাইনামিক লিঙ্ক ব্যবহার করার পরিকল্পনা করেন (উল্লেখ্য যে, এগুলো এই কোডল্যাবের অংশ নয়; SHA-1 কী সম্পর্কে আরও তথ্যের জন্য, অনুগ্রহ করে এই ডকুমেন্টটি দেখুন)।

পরামর্শ : প্যাকেজ ও অ্যাপ্লিকেশন আইডি সম্পর্কে আরও তথ্যের জন্য “অ্যাপ্লিকেশন আইডি সেট করুন” পড়ুন।

3. রেজিস্টার অ্যাপ বাটনটিতে ক্লিক করুন।

কনফিগারেশন ফাইল ডাউনলোড করুন

1. google-services.json কনফিগারেশন ফাইলটি ডাউনলোড করতে Download google-services.json বাটনে ক্লিক করুন।

2. অ্যান্ড্রয়েড স্টুডিওতে, app ডিরেক্টরিতে যান এবং google-services.json ফাইলটি (যা আপনি এইমাত্র উপরে ডাউনলোড করেছেন) app ডিরেক্টরিতে সরিয়ে নিন। ফায়ারবেস কনসোলে ফিরে এসে, নেক্সট বোতামে ক্লিক করুন।

আপনার অ্যাপে Firebase সক্রিয় করুন

1. Firebase দ্বারা তৈরি google-services.json ফাইলটি পড়ার জন্য আপনার Google Services Gradle প্লাগইনটি প্রয়োজন।
2. অ্যান্ড্রয়েড স্টুডিওতে, <project>/build.gradle ফাইলটি খুলুন, তারপর ফাইলটিতে নিম্নলিখিত লাইনগুলো যোগ করুন:

buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}

3. <project>/<app-module>/build.gradle খুলুন, তারপর ফাইলটিতে নিম্নলিখিত লাইনগুলো যোগ করুন:

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

এখন, আপনি আপনার অ্যান্ড্রয়েড অ্যাপে ফায়ারবেস যুক্ত করার কাজ সম্পন্ন করেছেন!

পরবর্তী ধাপে, আপনি শিখবেন কীভাবে আপনার অ্যাপে ফায়ারবেস এসডিকে (Firebase SDK) যুক্ত করতে হয়।

৪. আপনার অ্যাপে ফায়ারবেস এসডিকে যোগ করুন

এই ধাপে, আপনি Firebase SDK, বিশেষ করে Google Analytics-এর জন্য Firebase SDK যোগ করবেন।

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

1. <project>/<app-module>/build.gradle খুলুন, তারপর ফাইলটিতে নিম্নলিখিত লাইনগুলো যোগ করুন:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

আপনি দেখতে পাচ্ছেন, শুধুমাত্র BoM-এর ভার্সন উল্লেখ করলে, আপনাকে Firebase Analytics লাইব্রেরির ভার্সন উল্লেখ করার প্রয়োজন নেই। কিন্তু BoM-এ যে ভার্সনই নির্দিষ্ট করা থাকুক না কেন, আপনি যদি আপনার Firebase লাইব্রেরির জন্য কাঙ্ক্ষিত ভার্সনটি ব্যবহার করতে চান, তাহলে আপনাকে শুধু এইভাবে কাঙ্ক্ষিত ভার্সনটি উল্লেখ করতে হবে:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'

2. এখন Sync Now বোতামে ক্লিক করে আপনার অ্যাপটি সিঙ্ক করুন।

এখন, আপনি আপনার অ্যান্ড্রয়েড অ্যাপে গুগল অ্যানালিটিক্সের জন্য ফায়ারবেস এসডিকে যোগ করার কাজ সম্পন্ন করেছেন!

পরবর্তী ধাপে, আপনি শিখবেন কীভাবে আপনার অ্যান্ড্রয়েড অ্যাপে ফায়ারবেস ইভেন্টগুলো লগ করতে হয়।

৫. ফায়ারবেস অ্যানালিটিক্স দিয়ে ইভেন্টগুলো লগ করুন

এই ধাপে, আপনি শিখবেন কীভাবে অ্যান্ড্রয়েড অ্যাপে ফায়ারবেস অ্যানালিটিক্স ব্যবহার করে ইভেন্ট লগ করতে হয়।

ইভেন্ট লগ করার দুটি উপায় আছে: সাজেস্টেড ইভেন্ট অথবা কাস্টম ইভেন্ট ব্যবহার করা।

প্রস্তাবিত ইভেন্ট ব্যবহার করে

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

1. অ্যাক্টিভিটির শীর্ষে FirebaseAnalytics অবজেক্টটি ডিক্লেয়ার করুন:

private lateinit var firebaseAnalytics: FirebaseAnalytics

2. onCreate() মেথডে অবজেক্টটি ইনিশিয়ালাইজ করুন:

firebaseAnalytics = Firebase.analytics

3. logEvent() মেথড ব্যবহার করে ইভেন্ট লগ করা শুরু করুন। নিচের কোডটি একটি PURCHASE ইভেন্ট লগ করে যখন কোনো ব্যবহারকারী অ্যাপে এক বা একাধিক আইটেম কেনেন:

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

কাস্টম ইভেন্ট ব্যবহার করে

প্রস্তাবিত ইভেন্টগুলোর আওতাভুক্ত নয় এমন ইভেন্টের প্রয়োজন হলে, আপনি কাস্টম প্যারামিটার ব্যবহার করে নিজস্ব ইভেন্ট লগ করতে পারেন:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

ডিবাগ ইভেন্ট

আপনি ফায়ারবেস কনসোলে আপনার ইভেন্টগুলো সম্পর্কে একত্রিত ডেটা এবং রিপোর্ট দেখতে পারেন। কিন্তু আপডেটগুলো সারাদিন ধরে পর্যায়ক্রমে হয়, তাই আপনার অ্যাপে লগ ইন করার সাথে সাথেই আপনি সেই ইভেন্টগুলো দেখতে পারবেন না।

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

এখন আপনি আপনার অ্যান্ড্রয়েড অ্যাপে ইভেন্ট লগ করা সম্পন্ন করেছেন!

পরবর্তী ধাপে, আপনি শিখবেন কীভাবে সেই ইভেন্টগুলো গুগল অ্যাডস-এ ইম্পোর্ট করতে হয়।

৬. ফায়ারবেস ইভেন্টগুলো গুগল অ্যাডস-এ ইম্পোর্ট করুন

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

ফায়ারবেস এবং গুগল অ্যাডস লিঙ্ক করুন

1. প্রজেক্ট ওভারভিউ-এর ঠিক পাশের বোতামটিতে ক্লিক করে ফায়ারবেস সেটিংস-এ যান।

2. ইন্টিগ্রেশন ট্যাবে আপনি গুগল অ্যাডস এবং একটি লিঙ্ক বাটন দেখতে পাবেন। লিঙ্কে ক্লিক করুন এবং চালিয়ে যান।

3. যে গুগল অ্যাডস অ্যাকাউন্টটি লিঙ্ক করতে চান, সেটি বেছে নিন।

এখন আপনি Firebase এবং Google Ads লিঙ্ক করার কাজ সম্পন্ন করেছেন। চলুন Firebase ইভেন্টগুলো Google Ads-এ ইম্পোর্ট করি।

ফায়ারবেস ইভেন্ট আমদানি করুন

1. Firebase কনসোলে, Events মেনুতে যান এবং যে ইভেন্টটিকে আপনি কনভার্সন হিসেবে ইম্পোর্ট করতে চান, সেটিকে চিহ্নিত করুন।

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

2. এখন, গুগল অ্যাডস-এ যান এবং ফায়ারবেসের সাথে লিঙ্ক করা অ্যাকাউন্টটিতে লগইন করুন।
3. Google Ads-এ, Tools → Measurement → Conversions-এ যান।
4. + বোতামে ক্লিক করুন
5. অ্যাপ → গুগল অ্যানালিটিক্স ৪ প্রোপার্টিজ (ফায়ারবেস) বেছে নিন এবং কন্টিনিউ-তে ক্লিক করুন।
6. আপনি কনভার্সন হিসেবে চিহ্নিত সমস্ত অ্যানালিটিক্স ইভেন্ট দেখতে পাবেন। যে ইভেন্টটি ইম্পোর্ট করতে চান, সেটি খুঁজুন। এক্ষেত্রে, আমাদের পূর্বে প্রয়োগ করা delete_item ইভেন্টটি বেছে নিন। 'Import and Continue' বোতামে ক্লিক করুন।
7. আপনি ফায়ারবেস থেকে সফলভাবে একটি রূপান্তর ইভেন্ট আমদানি করেছেন।

এখন আপনি গুগল অ্যাডস-এ ফায়ারবেস ইভেন্টগুলো ইম্পোর্ট করার কাজ সম্পন্ন করেছেন।

পরবর্তী ধাপে, আপনি এইমাত্র ইম্পোর্ট করা ইভেন্টটি দিয়ে কীভাবে একটি অ্যাকশন ক্যাম্পেইন চালু করতে হয় তা শিখবেন।

৭. ইম্পোর্ট করা ইভেন্ট ব্যবহার করে অ্যাপ অ্যাকশন ক্যাম্পেইন চালু করা

গুরুত্বপূর্ণ: একটি অ্যাপ ক্যাম্পেইন চালু করার জন্য, গুগল প্লে-তে আপনার একটি প্রোডাকশন লেভেলের অ্যাপ থাকা প্রয়োজন। আপনি যদি অ্যাপটি প্রকাশ করার জন্য প্রস্তুত না থাকেন, তবে আপাতত এই ধাপটি বাদ দিন।

1. আপনার বর্তমান গুগল অ্যাডস অ্যাকাউন্টের অ্যাপ ক্যাম্পেইন ট্যাবে যান এবং + বোতামে ক্লিক করে একটি নতুন ক্যাম্পেইন শুরু করুন।

2. আমরা অ্যাপ ইনস্টল অপশন সহ একটি অ্যাপ প্রচার অভিযান চালু করব। নিচে, আপনি যে অ্যাপটি প্রচার করতে চান তা বেছে নিন এবং 'চালিয়ে যান' (continue) এ ক্লিক করুন।
3. বিডিং বিভাগে, ড্রপডাউন মেনু থেকে ‘ইন-অ্যাপ অ্যাকশন’ নির্বাচন করলে আপনি ইভেন্টগুলো দেখতে পাবেন। যে ইভেন্ট(গুলো)র উপর আপনি মনোযোগ দিতে চান, তা বেছে নিন।

4. ক্যাম্পেইনের বাকি সেটিংসগুলো সেট করুন, হয়ে গেল।

৮. অভিনন্দন

অভিনন্দন, আপনি সফলভাবে আপনার Firebase এবং Google Ads সংযুক্ত করেছেন! এটি আপনার ক্যাম্পেইনের কার্যকারিতা বাড়াতে সাহায্য করবে।

আপনি শিখেছেন

• অ্যান্ড্রয়েডের জন্য ফায়ারবেস অ্যানালিটিক্স কীভাবে কনফিগার করবেন
• অ্যান্ড্রয়েড অ্যাপে ফায়ারবেস অ্যানালিটিক্স ব্যবহার করে কীভাবে ইভেন্ট লগ করবেন।
• কীভাবে ইভেন্ট ইম্পোর্ট করবেন এবং অ্যাকশন ক্যাম্পেইনের জন্য সেগুলো ব্যবহার করবেন।