১. ভূমিকা
সর্বশেষ হালনাগাদ: ২০২০-১২-১৪
আপনি যা তৈরি করবেন
এই কোডল্যাবে, আপনি শিখবেন কিভাবে GA4F iOS SDK ব্যবহার করে কাস্টম ইভেন্ট প্রয়োগ করতে হয় এবং গুগল অ্যাডসের মাধ্যমে অ্যাকশন ক্যাম্পেইন চালু করতে হয়।
এই কোডল্যাবের মাধ্যমে, আপনি আমাদের ক্লায়েন্টদের সম্মুখীন হওয়া অ্যাপ ব্যবসার সম্পূর্ণ প্রক্রিয়াটি অভিজ্ঞতা করতে পারবেন। আপনি যদি Firebase iOS-এর একটি সহজ পরিচিতি শিখতে চান, তাহলে Firebase iOS Codelab Swift দিয়ে শুরু করুন।
আপনি যা শিখবেন
- iOS Swift-এ GA4F (Google Analytics for Firebase) কীভাবে ইনিশিয়ালাইজ করবেন
- কাস্টম ইভেন্ট এবং প্যারামিটার কীভাবে তৈরি করবেন।
- ফায়ারবেস থেকে গুগল অ্যাডস-এ ইভেন্ট ইম্পোর্ট করার পদ্ধতি
- কাস্টম ইভেন্ট ব্যবহার করে অ্যাকশন ক্যাম্পেইন চালু করুন।
আপনার যা যা লাগবে
- এক্সকোড
- ফায়ারবেস অ্যাকাউন্ট
- গুগল বিজ্ঞাপন অ্যাকাউন্ট
২. একটি নতুন iOS Swift প্রজেক্ট শুরু করুন।
একটি সহজ টেমপ্লেটযুক্ত iOS সুইফট অ্যাপ তৈরি করুন। সম্পূর্ণ অ্যাপটি তৈরি করতে আপনি এই স্টার্টার অ্যাপটি পরিবর্তন করবেন।
প্রথমে, Xcode চালু করুন।
- আপনার যদি কোনো খোলা প্রজেক্ট না থাকে, তাহলে ওয়েলকাম পেজ থেকে 'Create a new Xcode project' নির্বাচন করুন।
- ডায়ালগ বক্সের শীর্ষে iOS নির্বাচন করুন।
- অ্যাপ্লিকেশন বিভাগে, অ্যাপ নির্বাচন করুন এবং তারপরে পরবর্তী ক্লিক করুন।
- প্রদর্শিত ডায়ালগ বক্সে, আপনার অ্যাপের নাম দিতে এবং প্রজেক্টের জন্য অতিরিক্ত অপশন বেছে নিতে নিম্নলিখিত মানগুলি ব্যবহার করুন এবং 'Next' এ ক্লিক করুন:
- পণ্যের নাম: যেমন আইওএস-অ্যাপ
আপনার প্রজেক্ট এবং অ্যাপের নামকরণ করার জন্য Xcode আপনার দেওয়া প্রোডাক্টের নামটি ব্যবহার করে।
- টিম: যদি এটি স্বয়ংক্রিয়ভাবে পূরণ না হয়, তাহলে টিমকে 'None' সেট করুন।
- প্রতিষ্ঠানের নাম: আপনার প্রতিষ্ঠানের নাম অথবা আপনার নিজের নাম।
- বান্ডেল শনাক্তকারী: এই মানটি আপনার পণ্যের নাম এবং প্রতিষ্ঠান শনাক্তকারীর উপর ভিত্তি করে স্বয়ংক্রিয়ভাবে তৈরি হয়।
- ভাষা: সুইফট
- আপনার প্রজেক্টটি সংরক্ষণ করার জন্য একটি স্থান নির্বাচন করুন এবং তৈরি করুন-এ ক্লিক করুন।
- Xcode আপনার নতুন প্রজেক্টটি ওয়ার্কস্পেস উইন্ডোতে খোলে।
৩. একটি ফায়ারবেস প্রজেক্ট তৈরি ও সেট আপ করুন।
Firebase ব্যবহার শুরু করতে, আপনাকে একটি Firebase প্রজেক্ট তৈরি ও সেট আপ করতে হবে।
একটি ফায়ারবেস প্রজেক্ট তৈরি করুন
আপনার যদি এমন কোনো ফায়ারবেস প্রজেক্ট থাকে যেখানে গুগল অ্যানালিটিক্স সক্রিয় করা নেই, তাহলে আপনি আপনার সেটিংস > প্রজেক্ট সেটিংস-এর ইন্টিগ্রেশন ট্যাব থেকে গুগল অ্যানালিটিক্স সক্রিয় করতে পারেন। এরপর ফায়ারবেস কনফিগারেশন ধাপে যান।
- Firebase- এ সাইন ইন করুন।
Firebase কনসোলে, Add Project (বা Create a project)-এ ক্লিক করুন এবং আপনার Firebase প্রজেক্টটির নাম দিন Firebase-iOS-Ads।
- প্রজেক্ট তৈরির অপশনগুলো একে একে দেখুন। অনুরোধ করা হলে Firebase-এর শর্তাবলী মেনে নিন। এই প্রজেক্টের জন্য আপনাকে Google Analytics চালু করতে হবে, কারণ অ্যাকশন ইভেন্ট এবং কনভার্সন ট্র্যাক করার জন্য আপনার Google Analytics ইভেন্টের প্রয়োজন হবে।
ফায়ারবেস প্রজেক্ট সম্পর্কে আরও জানতে, “ফায়ারবেস প্রজেক্ট বুঝুন” দেখুন।
৪. ফায়ারবেস কনফিগারেশন
- Firebase কনসোলে, বাম দিকের নেভিগেশন থেকে Project Overview > Project Settings নির্বাচন করুন, তারপর General > Your apps-এর অধীনে থাকা iOS বোতামটিতে ক্লিক করুন।
আপনি পরবর্তী স্ক্রিনে দেখানো ডায়ালগটি দেখতে পাবেন।
- প্রদান করার জন্য গুরুত্বপূর্ণ মানটি হলো iOS বান্ডেল আইডি, যা আপনি পরবর্তী ধাপটি অনুসরণ করে পাবেন।
- আপনার iOS অ্যাপের Xcode প্রজেক্টে, প্রজেক্ট নেভিগেটর থেকে টপ-লেভেল অ্যাপটি সিলেক্ট করুন, এরপর জেনারেল ট্যাবটি সিলেক্ট করুন।
- Bundle Identifier ফিল্ডের মান হলো iOS বান্ডেল আইডি (যেমন
com.yourcompany.yourproject)। এই মানটি কপি করুন। - Firebase ডায়ালগ বক্সে, কপি করা বান্ডেল আইডিটি
iOS bundle IDফিল্ডে পেস্ট করুন। - অ্যাপটি নিবন্ধন করুন- এ ক্লিক করুন।
- এরপর Firebase-এ,
GoogleService-Info.plistকনফিগারেশন ফাইলটি ডাউনলোড করার জন্য নির্দেশাবলী অনুসরণ করুন।
- আপনার Xcode প্রজেক্টে যান, তারপর (এইমাত্র ডাউনলোড করা)
GoogleService-Info.plistফাইলটি আপনার Xcode প্রজেক্টের রুটে সরিয়ে নিন। - বাকি ধাপগুলো এড়িয়ে যান এবং ফায়ারবেস কনসোলের মূল পাতায় ফিরে যান।
৫. Xcode-এ Firebase Analytics কনফিগার করুন
এই ধাপে, আপনি আপনার Xcode প্রজেক্টে Firebase SDK যোগ করা শুরু করবেন।
- একটি টার্মিনাল উইন্ডো খুলুন এবং আপনার অ্যাপের এক্সকোড প্রজেক্টের অবস্থানে যান।
- আপনার যদি Podfile না থাকে তবে একটি তৈরি করুন:
$ pod init
- আপনার Podfile খুলুন এবং যোগ করুন:
$ vi Podfile
$ pod 'Firebase/Analytics' 
- ফাইলটি সংরক্ষণ করুন এবং চালান :
$ pod install
- প্রারম্ভিক কোড যোগ করুন:
আপনার অ্যাপ চালু হওয়ার সময় Firebase সংযোগ করতে, নিচের ইনিশিয়ালাইজেশন কোডটি আপনার প্রধান AppDelegate ক্লাসে যোগ করুন।
import UIKit
import Firebase
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions:
[UIApplicationLaunchOptionsKey: Any]?) -> Bool {
FirebaseApp.configure()
return true
}
}
- আপনার কাজ হয়ে গেছে! সান্ত্বনা দেওয়া চালিয়ে যান।
এখন আপনি কিছু কাস্টম ইভেন্ট লগ চালু করার জন্য প্রস্তুত!
৬. ফায়ারবেস অ্যানালিটিক্স দিয়ে কাস্টম ইভেন্ট লগ করুন
এই ধাপে, আপনি শিখবেন কীভাবে iOS অ্যাপে Firebase Analytics ব্যবহার করে কাস্টম ইভেন্ট লগ করতে হয়।
ফায়ারবেস অ্যানালিটিক্স স্বয়ংক্রিয়ভাবে আপনার জন্য কিছু ইভেন্ট লগ করে; সেগুলি গ্রহণ করার জন্য আপনাকে কোনো কোড যোগ করতে হবে না। যদি আপনার অ্যাপের অতিরিক্ত ডেটা সংগ্রহের প্রয়োজন হয়, তবে আপনি আপনার অ্যাপে ৫০০টি পর্যন্ত বিভিন্ন অ্যানালিটিক্স কাস্টম ইভেন্ট টাইপ লগ করতে পারেন।
লগ ইভেন্ট
FirebaseApp ইনস্ট্যান্সটি কনফিগার করার পরে, আপনি logEvent() মেথড ব্যবহার করে ইভেন্ট লগ করা শুরু করতে পারেন।
Analytics.logEvent("text_search", parameters: [
"name": name as NSObject,
"full_text": text as NSObject
])
ডিফল্ট ইভেন্ট প্যারামিটার সেট করুন
আপনি setDefaultEventParameters ব্যবহার করে বিভিন্ন ইভেন্টে প্যারামিটার লগ করতে পারেন। ডিফল্ট প্যারামিটারগুলো ভবিষ্যতে লগ করা সমস্ত ইভেন্টের সাথে যুক্ত থাকে।
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
Xcode ডিবাগ কনসোলে ইভেন্টগুলি দেখুন
ইভেন্টগুলো সঠিকভাবে লগ হচ্ছে কিনা তা যাচাই করতে, আপনি SDK দ্বারা ইভেন্ট লগিং নিরীক্ষণের জন্য ভার্বোস লগিং সক্রিয় করতে পারেন। এর মধ্যে স্বয়ংক্রিয়ভাবে এবং ম্যানুয়ালি লগ করা উভয় ধরনের ইভেন্টই অন্তর্ভুক্ত।
আপনি নিম্নলিখিত উপায়ে বিশদ লগিং সক্রিয় করতে পারেন:
- Xcode-এ, Product > Scheme > Edit scheme... নির্বাচন করুন।
- বাম দিকের মেনু থেকে রান নির্বাচন করুন।
- আর্গুমেন্টস ট্যাবটি নির্বাচন করুন।
- "Arguments Passed On Launch" বিভাগে, "-FIRAnalyticsDebugEnabled" যোগ করুন।
পরবর্তী বার যখন আপনি আপনার অ্যাপটি চালাবেন, তখন আপনার ইভেন্টগুলো এক্সকোড ডিবাগ কনসোলে প্রদর্শিত হবে, যা আপনাকে ইভেন্টগুলো পাঠানো হচ্ছে কিনা তা তাৎক্ষণিকভাবে যাচাই করতে সাহায্য করবে।
ড্যাশবোর্ডে ইভেন্টগুলো দেখুন
কয়েক ঘণ্টার মধ্যে আপনি আপনার লগ করা ইভেন্টটি ফায়ারবেস কনসোলে দেখতে পাবেন। এটি অ্যানালিটিক্স → ইভেন্টস-এ অবস্থিত। ইভেন্টটিতে ক্লিক করে আপনি প্যারামিটারের মানগুলোও খুঁজে নিতে পারেন।
'mark as conversion' সুইচটি ডানদিকে স্লাইড করে আপনি 'text_search'-কে রূপান্তর হিসেবে চিহ্নিত করবেন।
ইভেন্টটি সফলভাবে কনভার্সন হিসেবে চিহ্নিত হয়েছে কিনা, তা আপনি Firebase Analytics-এর কনভার্সন ট্যাবের মাধ্যমে পুনরায় যাচাই করতে পারেন। ইভেন্টটিকে কনভার্সন হিসেবে চিহ্নিত করার ফলে, Google Ads-ও এটিকে একটি কনভার্সন হিসেবে ইম্পোর্ট করতে পারবে।
৭. গুগল অ্যাডস-এ অ্যানালিটিক্স ইভেন্ট ইম্পোর্ট করা
আপনার Firebase-iOS সেটআপ সম্পন্ন হয়েছে এবং আপনি লগ করা অ্যাকশন ইভেন্টসহ অ্যাপ ক্যাম্পেইন চালু করার জন্য প্রস্তুত। আপনি Firebase-কে Google Ads-এর সাথে লিঙ্ক করার মাধ্যমে শুরু করবেন। Firebase-কে Google Ads-এর সাথে লিঙ্ক করার মাধ্যমে, অ্যাপ ক্যাম্পেইনগুলো অডিয়েন্স সম্পর্কে আরও জানতে পারবে এবং ক্যাম্পেইনের শিক্ষণীয় বিষয়গুলোকে আরও উন্নত করতে পারবে, যা সাধারণত আরও ভালো পারফরম্যান্স এবং কনভার্সনের দিকে পরিচালিত করে।
- প্রজেক্ট ওভারভিউ-এর ঠিক পাশের বোতামটিতে ক্লিক করে ফায়ারবেস সেটিংস-এ যান।
- ইন্টিগ্রেশন ট্যাবে আপনি গুগল অ্যাডস এবং একটি লিঙ্ক বাটন দেখতে পাবেন। লিঙ্কে ক্লিক করুন এবং চালিয়ে যান।
- গুগল অ্যাডস অ্যাকাউন্ট বেছে নিন।
এখন ফায়ারবেসের অংশটি সম্পন্ন হয়েছে।
এখন, গুগল অ্যাডস-এ যান এবং লগইন করুন।
- Google Ads- এ গিয়ে লগ ইন করুন এবং কাস্টম ইভেন্টগুলোকে কনভার্সন হিসেবে ইম্পোর্ট করার জন্য Tools & Settings → Measurement → Conversions-এ যান।
- নতুন রূপান্তর ক্রিয়া যোগ করতে + বোতামে ক্লিক করুন।
- Google Analytics 4 প্রোপার্টিজ (ফায়ারবেস) বেছে নিন এবং চালিয়ে যান-এ ক্লিক করুন।
- আপনি কনভার্সন হিসেবে চিহ্নিত সমস্ত অ্যানালিটিক্স ইভেন্ট দেখতে পারেন। আমরা আগে যে
clicked_counterইভেন্টটি প্রয়োগ করেছিলাম, সেটি খুঁজুন।
- চেক করুন এবং ইমপোর্ট ও কন্টিনিউ বাটনটিতে ক্লিক করুন।
কনভার্সন অ্যাকশন হিসেবে text_search সেট করার পর, এখন এমন ব্যবহারকারীদের লক্ষ্য করে একটি ক্যাম্পেইন চালু করার সময়, যারা সম্ভবত text_search ইভেন্টগুলো সক্রিয় করবে।
৮. ইম্পোর্ট করা ইভেন্ট ব্যবহার করে অ্যাপ অ্যাকশন ক্যাম্পেইন চালু করা
- আপনার বর্তমান অ্যাকাউন্টের ক্যাম্পেইন ট্যাবে যান এবং + বোতামে ক্লিক করে একটি নতুন ক্যাম্পেইন শুরু করুন। নতুন ক্যাম্পেইনটিতে ক্লিক করুন এবং চালিয়ে যান।
- এইবার আমরা অ্যাপ ইনস্টল অপশন সহ একটি অ্যাপ প্রচার অভিযান চালু করব।
- অ্যাপের নাম, প্যাকেজ নাম বা প্রকাশকের নাম দিয়ে আপনার অ্যাপটি খুঁজুন।
- বিডিং সেকশনে, বিজ্ঞাপনগুলোকে অ্যাকশনের উপর ফোকাস করানোর জন্য ড্রপবক্স থেকে ‘ইন-অ্যাপ অ্যাকশন’ নির্বাচন করুন।
- প্রদত্ত তালিকায় আপনি আপনার নিজস্ব ইভেন্টগুলো খুঁজে নিতে পারেন। প্রতিটি কাজের জন্য লক্ষ্যমাত্রা খরচ নির্ধারণ করুন এবং অন্যান্য বিকল্পগুলোও পূরণ করুন।
- ক্যাম্পেইনের সেটিংস কনফিগার করুন। এটি কোডল্যাবের আওতার বাইরে থাকবে, তাই সেটিংস অপ্টিমাইজ করার জন্য এই ডকুমেন্টগুলো দেখুন, অথবা অন্য কোনো মাধ্যমে যোগাযোগ করুন।
৯. অভিনন্দন
অভিনন্দন, আপনি সফলভাবে আপনার Firebase এবং Google Ads সংযুক্ত করেছেন! এটি আপনার ক্যাম্পেইনের কার্যকারিতা বাড়াতে সাহায্য করবে।
আপনি স্ক্রিপ্টটি ইনস্টল করেছেন, একটি নতুন কোডল্যাব চেঞ্জলিস্ট তৈরি ও স্টেজ করেছেন, অপেক্ষমান কোডল্যাব চেঞ্জলিস্টটি আপডেট ও স্টেজ করেছেন, কোডল্যাব চেঞ্জলিস্টটি পর্যালোচনা ও অনুমোদন করেছেন এবং কোডল্যাব চেঞ্জলিস্টটি জমা ও প্রকাশ করেছেন।
আপনি শিখেছেন
- iOS-এর জন্য Firebase কীভাবে কনফিগার করবেন
- iOS এবং Firebase Analytics ব্যবহার করে কাস্টম ইভেন্টগুলি কীভাবে লগ করবেন
- কীভাবে ইভেন্ট ইম্পোর্ট করবেন এবং অ্যাকশন ক্যাম্পেইনের জন্য তা ব্যবহার করবেন।