১. ভূমিকা
সর্বশেষ হালনাগাদ: ২০২১-০২-১৯
আপনি যা তৈরি করবেন
এই কোডল্যাবে আপনি শিখবেন কিভাবে ইউনিটি এনভায়রনমেন্টে GA4F iOS ব্যবহার করে কাস্টম ইভেন্ট ইমপ্লিমেন্ট করতে হয় এবং গুগল অ্যাডসের মাধ্যমে অ্যাকশন ক্যাম্পেইন চালু করতে হয়।
এই কোডল্যাব জুড়ে, আপনি আমাদের ক্লায়েন্টদের সম্মুখীন হওয়া অ্যাপ ব্যবসার সম্পূর্ণ প্রক্রিয়াটি অভিজ্ঞতা করতে পারবেন। আপনি যদি iOS-এ Firebase এবং Admob-এর একটি সহজ পরিচিতি শিখতে চান, তাহলে AdMob+Firebase 101 Unity: Setup & Analytics Basics দিয়ে শুরু করুন।
আপনি যা শিখবেন
- Unity ও iOS-এ GA4F (Google Analytics for Firebase) কীভাবে চালু করবেন
- কাস্টম ইভেন্ট এবং প্যারামিটার কীভাবে তৈরি করবেন।
- ফায়ারবেস থেকে গুগল অ্যাডস-এ ইভেন্ট কীভাবে ইম্পোর্ট করবেন।
- কাস্টম ইভেন্ট ব্যবহার করে অ্যাকশন ক্যাম্পেইন চালু করুন।
আপনার যা যা লাগবে
- এক্সকোড
- ঐক্য
- ফায়ারবেস অ্যাকাউন্ট
- গুগল বিজ্ঞাপন অ্যাকাউন্ট
২. একটি নতুন ইউনিটি প্রজেক্ট শুরু করুন।
একটি সাধারণ টেমপ্লেটযুক্ত ইউনিটি অ্যাপ তৈরি করুন। চূড়ান্ত অ্যাপটি তৈরি করার জন্য আপনি এই সাধারণ অ্যাপটিকেই পরিবর্তন করবেন।
ইউনিটি চালু করুন
- আপনার যদি কোনো খোলা প্রজেক্ট না থাকে, তাহলে একটি নতুন প্রজেক্ট তৈরি করুন নির্বাচন করুন।
- ডায়ালগ বক্স থেকে 3D টেমপ্লেট নির্বাচন করুন।
- প্রজেক্টের নাম পূরণ করুন: যেমন Unity Firebase Custom Event।
- আপনার প্রজেক্টটি সংরক্ষণ করার জন্য একটি স্থান নির্বাচন করুন এবং তৈরি করুন (CREATE) বোতামে ক্লিক করুন।
- ইউনিটি আপনার নতুন প্রজেক্টটি ওয়ার্কস্পেস উইন্ডোতে খোলে।
৩. একটি ফায়ারবেস প্রজেক্ট তৈরি ও সেট আপ করুন।
Firebase ব্যবহার শুরু করতে, আপনাকে একটি Firebase প্রজেক্ট তৈরি ও সেট আপ করতে হবে।
আপনার যদি এমন কোনো ফায়ারবেস প্রজেক্ট থাকে যেখানে গুগল অ্যানালিটিক্স সক্রিয় করা নেই, তাহলে আপনি আপনার সেটিংস > প্রজেক্ট সেটিংস-এর ইন্টিগ্রেশন ট্যাব থেকে গুগল অ্যানালিটিক্স সক্রিয় করতে পারেন। এরপর ফায়ারবেস কনফিগারেশন ধাপে যান।
- Firebase- এ সাইন ইন করুন।
Firebase কনসোলে, Add Project (বা Create a project)-এ ক্লিক করুন এবং আপনার Firebase প্রজেক্টটির নাম দিন Firebase-iOS-Ads।
- প্রজেক্ট তৈরির অপশনগুলো একে একে দেখুন। অনুরোধ করা হলে Firebase-এর শর্তাবলী মেনে নিন। এই প্রজেক্টের জন্য আপনাকে Google Analytics চালু করতে হবে, কারণ অ্যাকশন ইভেন্ট এবং কনভার্সন ট্র্যাক করার জন্য আপনার Google Analytics ইভেন্টের প্রয়োজন হবে।
ফায়ারবেস প্রজেক্ট সম্পর্কে আরও জানতে, “ফায়ারবেস প্রজেক্ট বুঝুন” দেখুন।
৪. ইউনিটি কনফিগারেশন
- ইউনিটি > ফাইল > বিল্ড সেটিংস-এ যান। গুরুত্বপূর্ণ বিষয়টি হলো iOS বান্ডেল আইডি সেট করা, যা আপনি নিম্নলিখিত ধাপটি অনুসরণ করে পাবেন।
আপনি পরবর্তী স্ক্রিনে দেখানো ডায়ালগটি দেখতে পাবেন।
- আপনার ইউনিটি প্রজেক্টের iOS অ্যাপে বিল্ড সেটিংস ডায়ালগটি খুলুন, ফাইল > বিল্ড সেটিংস (যদি প্ল্যাটফর্মটি iOS-এ সেট করা না থাকে, তাহলে আপনি iOS প্ল্যাটফর্ম নির্বাচন করে সুইচ প্ল্যাটফর্ম বোতামে ক্লিক করতে পারেন)।
- প্ল্যাটফর্ম পরিবর্তনের পর বান্ডেল আইডি সেট করতে প্লেয়ার সেটিংস বোতামে ক্লিক করুন। আপনি আইডেন্টিফিকেশন এলাকার চারপাশে টেক্সট ফিল্ডটি দেখতে পাবেন।
- বান্ডেল আইডেন্টিফায়ার ফিল্ডের মান হলো আইওএস বান্ডেল আইডি (যেমন
com.yourcompany.yourproject)। এই মানটি কপি করুন অথবা আপনার নিজের মান সেট করে সেটি কপি করুন। - Firebase ডায়ালগ বক্সে, কপি করা বান্ডেল আইডিটি
iOS bundle IDফিল্ডে পেস্ট করুন। - অ্যাপটি নিবন্ধন করুন- এ ক্লিক করুন।
- এরপর Firebase-এ,
GoogleService-Info.plistকনফিগারেশন ফাইলটি ডাউনলোড করার জন্য নির্দেশাবলী অনুসরণ করুন। - আপনার ইউনিটি প্রজেক্টের প্রজেক্ট উইন্ডোটি খুলুন, এরপর আপনার কনফিগ ফাইলগুলো অ্যাসেটস ফোল্ডারে সরিয়ে নিন।
- বাকি ধাপগুলো এড়িয়ে যান এবং ফায়ারবেস কনসোলের মূল পাতায় ফিরে যান।
৫. ইউনিটিতে ফায়ারবেস অ্যানালিটিক্স কনফিগার করুন
এই ধাপে, আপনি আপনার ইউনিটি প্রজেক্টে ফায়ারবেস এসডিকে যোগ করা শুরু করবেন।
- ফায়ারবেস কনসোলে যান।
- প্রজেক্ট ওভারভিউ পেজের মাঝখানে, ইউনিটি আইকনে ক্লিক করুন (
সেটআপ ওয়ার্কফ্লো চালু করতে। আপনি যদি আপনার ফায়ারবেস প্রজেক্টে আগে থেকেই কোনো অ্যাপ যোগ করে থাকেন, তাহলে প্ল্যাটফর্ম অপশনগুলো দেখতে 'অ্যাড অ্যাপ'-এ ক্লিক করুন। - আপনার ইউনিটি প্রোজেক্টের কোন বিল্ড টার্গেটটি রেজিস্টার করতে চান তা নির্বাচন করুন, অথবা আপনি চাইলে এখনই একই সাথে দুটি টার্গেটই রেজিস্টার করতে পারেন।
- আপনার ইউনিটি প্রোজেক্টের প্ল্যাটফর্ম-নির্দিষ্ট আইডি(গুলি) প্রবেশ করান।
- iOS-এর জন্য — iOS বান্ডেল আইডি ফিল্ডে আপনার ইউনিটি প্রজেক্টের iOS আইডিটি প্রবেশ করান।
- অ্যান্ড্রয়েডের জন্য — অ্যান্ড্রয়েড প্যাকেজ নেম ফিল্ডে আপনার ইউনিটি প্রজেক্টের অ্যান্ড্রয়েড আইডি লিখুন। প্যাকেজ নেম এবং অ্যাপ্লিকেশন আইডি শব্দ দুটি প্রায়শই একে অপরের পরিবর্তে ব্যবহৃত হয়।
- আপনার ইউনিটি প্রজেক্টের আইডি কোথায় খুঁজে পান?
- (ঐচ্ছিক) আপনার ইউনিটি প্রোজেক্টের প্ল্যাটফর্ম-নির্দিষ্ট ডাকনাম(গুলি) লিখুন। এই ডাকনামগুলি অভ্যন্তরীণ, সুবিধার্থে ব্যবহৃত শনাক্তকারী এবং এগুলি শুধুমাত্র ফায়ারবেস কনসোলে আপনিই দেখতে পাবেন।
- অ্যাপটি রেজিস্টার করতে ক্লিক করুন।
ফায়ারবেস অ্যানালিটিক্স ইউনিটি এসডিকে যোগ করুন
- Firebase কনসোলে, ‘Download Firebase Unity SDK’- তে ক্লিক করুন, তারপর SDK-টি আপনার সুবিধামত কোনো জায়গায় আনজিপ করুন।
- আপনি যেকোনো সময় ফায়ারবেস ইউনিটি এসডিকে পুনরায় ডাউনলোড করতে পারেন।
- ফায়ারবেস ইউনিটি এসডিকে কোনো নির্দিষ্ট প্ল্যাটফর্মের জন্য নয়।
- আপনার খোলা ইউনিটি প্রজেক্টে, Assets > Import Package > Custom Package- এ যান।
- আনজিপ করা SDK থেকে, আপনার অ্যাপে ব্যবহার করতে চান এমন সমর্থিত Firebase প্রোডাক্টগুলো নির্বাচন করুন।
- Google Analytics-এর জন্য Firebase প্যাকেজটি যোগ করুন: FirebaseAnalytics.unitypackage
- আপনার অ্যাপে ব্যবহার করতে চান এমন অন্য যেকোনো ফায়ারবেস প্রোডাক্টের জন্য প্যাকেজগুলো যোগ করুন। উদাহরণস্বরূপ, ফায়ারবেস অথেনটিকেশন এবং ফায়ারবেস রিয়েলটাইম ডেটাবেস ব্যবহার করতে: FirebaseAuth.unitypackage এবং FirebaseDatabase.unitypackage।
- ইমপোর্ট ইউনিটি প্যাকেজ উইন্ডোতে, ইমপোর্ট-এ ক্লিক করুন।
- Firebase কনসোলে ফিরে এসে, সেটআপ ওয়ার্কফ্লোতে, Next বাটনে ক্লিক করুন।
৬. ফায়ারবেস অ্যানালিটিক্স দিয়ে কাস্টম ইভেন্ট লগ করুন
এই ধাপে, আপনি শিখবেন কীভাবে ইউনিটি আইওএস অ্যাপে ফায়ারবেস অ্যানালিটিক্স ব্যবহার করে কাস্টম ইভেন্ট লগ করতে হয়।
ফায়ারবেস অ্যানালিটিক্স স্বয়ংক্রিয়ভাবে আপনার জন্য কিছু ইভেন্ট লগ করে; সেগুলি গ্রহণ করার জন্য আপনাকে কোনো কোড যোগ করতে হবে না। যদি আপনার অ্যাপের অতিরিক্ত ডেটা সংগ্রহের প্রয়োজন হয়, তবে আপনি আপনার অ্যাপে ৫০০টি পর্যন্ত বিভিন্ন অ্যানালিটিক্স কাস্টম ইভেন্ট টাইপ লগ করতে পারেন।
লগ ইভেন্ট
FirebaseApp ইনস্ট্যান্সটি কনফিগার করার পরে, আপনি logEvent() মেথড ব্যবহার করে ইভেন্ট লগ করা শুরু করতে পারেন।
Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);
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-কে Unity এবং Google Ads-এর সাথে সংযুক্ত করেছেন! এটি আপনার ক্যাম্পেইনের কার্যকারিতা বাড়াতে সাহায্য করবে।
আপনি শিখেছেন
- ইউনিটি আইওএস প্ল্যাটফর্মের জন্য ফায়ারবেস কীভাবে কনফিগার করবেন
- ইউনিটি এবং ফায়ারবেস অ্যানালিটিক্স ব্যবহার করে কাস্টম ইভেন্টগুলি কীভাবে লগ করবেন
- কীভাবে ইভেন্ট ইম্পোর্ট করবেন এবং অ্যাকশন ক্যাম্পেইনের জন্য তা ব্যবহার করবেন।