এই নির্দেশিকা আপনাকে দেখায় কীভাবে Google Mobile Ads Unity Plugin ব্যবহার করে লোড এবং প্রদর্শন করতে হয় BIGO Ads SDK থেকে বিজ্ঞাপন ব্যবহার করে মধ্যস্থতা, বিডিং ইন্টিগ্রেশন কভার করে। এটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে কীভাবে BIGO Ads SDK যোগ করতে হয় এবং কীভাবে Unity অ্যাপে BIGO Ads SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করতে হয় তা কভার করে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
BIGO Ads SDK-এর জন্য Ad Manager মিডিয়েশন অ্যাডাপ্টারে নিম্নলিখিত ক্ষমতা আছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | ১ |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| অ্যাপ ওপেন | |
| ব্যানার | |
| স্থান | |
| পুরস্কার জিতেছেন | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
| নেটিভ | |
পূর্বশর্ত
এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করিয়ে নিন:
- লেটেস্ট Google Mobile Ads Unity Plugin ভার্সন।
- Unity Editor ভার্সন 2019.4 বা তার পরবর্তী যেকোনও ভার্সন।
- Android-এ ডিপ্লয় করতে
- Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
- iOS-এ ডিপ্লয় করতে
- iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Google Mobile Ads Unity Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Unity প্রোজেক্ট। আরও বিবরণের জন্য শুরু করুন বিকল্প দেখুন।
- মধ্যস্থতা সেট-আপ করুন।
ধাপ ১: BIGO Ads SDK UI-তে কনফিগারেশন সেট-আপ করুন
আপনার BIGO Ads ড্যাশবোর্ডে লগ-ইন করুন।
অ্যাপ তৈরি করুন
ইনভেনটরি ট্যাবে নেভিগেট করুন এবং অ্যাপ ও সাইট টেবিলের মধ্যে থেকে, + যোগ করুন বোতামটি বেছে নিন।
বাকি ফর্ম পূরণ করে জমা দিন বিকল্পে ক্লিক করুন।
আপনার আবেদন আইডি মনে রাখুন।
Android
iOS
বিজ্ঞাপন স্লট তৈরি করা
আপনার আবেদন পর্যালোচনা করা হয়ে গেলে, বিজ্ঞাপন স্লট টেবিলে গিয়ে + যোগ করুন বোতাম বেছে নিন।
নিলামের ধরন হিসেবে সার্ভার বিডিং বেছে নিন, বাকি ফর্ম পূরণ করুন এবং জমা দিন বিকল্পে ক্লিক করুন।
স্লট আইডি মনে রাখবেন
Android
iOS
আপনার app-ads.txt আপডেট করুন
অ্যাপের জন্য অনুমোদিত বিক্রেতা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে হওয়া উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
Ad Manager-এর জন্য একটি app-ads.txt ফাইল তৈরি করুন।
BIGO Ads SDK-এর জন্য app-ads.txt প্রয়োগ করতে, ড্যাশবোর্ড থেকে APP-ads.txt
ট্যাবে নেভিগেট করুন এবং
ট্যাবে দেওয়া নির্দেশাবলী অনুসরণ করুন।
ধাপ ২: Ad Manager UI-তে BIGO Ads SDK ডিমান্ড সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য গাইডের ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
জিডিপিআর (GDPR) ও মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারের তালিকায় BIGO TECHNOLOGY PTE LTD-কে যোগ করুন
Ad Manager UI-তে ইউরোপিয়ান রেগুলেশন বিজ্ঞাপন পার্টনারদের তালিকায় Empathy Technology Pte.Ltd. (BIGO Ads) এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারদের তালিকায় **BIGOAds** যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস বিকল্পে দেওয়া ধাপগুলি অনুসরণ করুন।
ধাপ ৩: BIGO Ads SDK ও অ্যাডাপ্টার ইম্পোর্ট করা
OpenUPM-CLI
আপনার OpenUPM-CLI ইনস্টল করা থাকলে, আপনার প্রকল্পের মূল ডিরেক্টরি থেকে নিম্নলিখিত কমান্ড চালিয়ে, আপনার প্রোজেক্টে Unity-এর জন্য Google Mobile Ads BIGO Ads SDK মধ্যস্থতা প্লাগ-ইন ইনস্টল করতে পারবেন:
openupm add com.google.ads.mobile.mediation.bigoOpenUPM
আপনার Unity প্রোজেক্ট এডিটরে, এডিট করুন > প্রোজেক্ট সেটিংস > প্যাকেজ ম্যানেজার বিকল্প বেছে নিন যাতে Unity প্যাকেজ ম্যানেজার সেটিংস খোলা যায়।
স্কোপড রেজিস্ট্রি ট্যাবের মধ্যে, নিম্নলিখিত বিবরণ সহ স্কোপড রেজিস্ট্রি হিসেবে OpenUPM যোগ করুন:
- নাম:
OpenUPM - URL:
https://package.openupm.com - স্কোপ:
com.google
তারপর, Unity Package Manager খুলতে Window > Package Manager বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।
Google Mobile Ads Bigo Mediation প্যাকেজ বেছে নিয়ে ইনস্টল করুন বিকল্পে ক্লিক করুন।
Unity প্যাকেজ
BIGO Ads SDK-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করতে,
চেঞ্জলগ-এ
দেওয়া ডাউনলোড লিঙ্ক ব্যবহার করুন এবং
জিপ ফাইল থেকে
GoogleMobileAdsBigoMediation.unitypackage এক্সট্র্যাক্ট করুন।
আপনার Unity প্রোজেক্ট এডিটরে, অ্যাসেট > প্যাকেজ ইমপোর্ট করুন >
কাস্টম প্যাকেজ বেছে নিন এবং আপনার ডাউনলোড করা
GoogleMobileAdsBigoMediation.unitypackage
ফাইলটি খুঁজুন। সব ফাইল বেছে নেওয়া হয়েছে কিনা তা দেখে নিয়ে
ইমপোর্ট করুন বিকল্পে ক্লিক করুন।
তারপর, অ্যাসেট > এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার >
Android Resolver > ফোর্স রিজলভ বিকল্প বেছে নিন। এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার
লাইব্রেরি শুরু থেকে ডিপেন্ডেন্সি রেজোলিউশন পারফর্ম করবে এবং
ঘোষিত ডিপেন্ডেন্সি আপনার Unity অ্যাপের Assets/Plugins/Android ডিরেক্টরিতে
কপি করবে।
ধাপ ৪: BIGO Ads SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
BIGO Ads SDK-এর জন্য গোপনীয়তা সেটিংস প্রয়োগ করতে এবং প্রাসঙ্গিক গোপনীয়তা রেগুলেশন মেনে চলতে, নিম্নলিখিত বিভাগগুলি পড়ুন।
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডে বসবাসকারী ব্যবহারকারীদের কাছে নির্দিষ্ট কিছু তথ্য প্রকাশ করতে হবে এবং আইনত প্রয়োজনীয় হলে কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য তাদের সম্মতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
BIGO Ads SDK, UMP SDK সহ কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা জিডিপিআর (GDPR) সম্মতি অটোমেটিক পড়ে। আরও তথ্যের জন্য, Android এবং iOS-এর জন্য BIGO Ads SDK-এর জিডিপিআর (GDPR) গাইড দেখুন।
মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে, ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।
BIGO Ads SDK-তে কীভাবে সম্মতি ফ্ল্যাগ পাস করতে হয় তা নিম্নলিখিত স্যাম্পেল কোড থেকে জানতে পারবেন। Google Mobile Ads Unity Plugin-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এই পদ্ধতি কল করুন।
using GoogleMobileAds.Mediation.Bigo.Api;
// ...
Bigo.SetCcpaConsent(true);
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
Android
BIGO Ads SDK ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোড প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে
BIGO Ads SDK-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করা
টেস্ট বিজ্ঞাপন চালু করুন
Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।
BIGO Ads, টেস্টিং ও ইন্টিগ্রেশনে সাহায্য করার জন্য Android এবং iOS -এর জন্য টেস্ট অ্যাপ্লিকেশন আইডি এবং বিজ্ঞাপন স্লট আইডি প্রদান করে।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি BIGO Ads SDK থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, BIGO Ads SDK (বিডিং) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
সমস্যার কোড
অ্যাডাপ্টার BIGO Ads SDK থেকে বিজ্ঞাপন না পেলে, আপনি
নিচের ক্লাস থেকে
ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে
আসল সমস্যা চেক করতে পারেন:
Android
sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter
iOS
GADMediationAdapterBigo
কোনও বিজ্ঞাপন লোড না হলে BIGO Ads SDK অ্যাডাপ্টার কোড এবং তার সাথে মেসেজ দেখায়:
Android
| সমস্যার কোড | ডোমেন | কারণ |
|---|---|---|
| ১০১ | com.google.ads.mediation.bigo | Bigo স্লট আইডি নেই বা ফাঁকা আছে। |
| 1000-1100 | BIGO Ads SDK-এর মাধ্যমে পাঠানো হয়েছে | BIGO Ads SDK-তে সমস্যা হয়েছে। আরও তথ্যের জন্য BIGO Ads SDK-এর ডকুমেন্টেশন দেখুন। |
iOS
| সমস্যার কোড | ডোমেন | কারণ |
|---|---|---|
| ১০১ | com.google.mediation.bigoadapter | সার্ভার কনফিগারেশনে প্রয়োজনীয় অ্যাপ্লিকেশন আইডি নেই। |
| 102 | com.google.mediation.bigoadapter | বিজ্ঞাপন কনফিগারেশন সঠিক নয়। |
| 103 | com.google.mediation.bigoadapter | বিজ্ঞাপন দেখানো যায়নি। |
| 104 | com.google.mediation.bigoadapter | ব্যানারের সাইজ কাজ করে না। |
| ১০৫ | com.google.mediation.bigoadapter | Bigo একটি ব্যানার বিজ্ঞাপন লোড করেছে কিন্তু বিজ্ঞাপন ভিউ নেই। |
| 1000-1100 | BIGO Ads SDK-এর মাধ্যমে পাঠানো হয়েছে | BIGO Ads SDK-তে সমস্যা হয়েছে। আরও তথ্যের জন্য BIGO Ads SDK-এর ডকুমেন্টেশন দেখুন। |
BIG Ads SDK Unity মেডিটেশন প্লাগ-ইন চেঞ্জলগ
ভার্সন 3.1.0 (কাজ চলছে)
ভার্সন 3.0.0
- BIGO Ads SDK Android অ্যাডাপ্টার ভার্সন 6.0.0.1-এ কাজ করে।
- BIGO Ads SDK iOS অ্যাডাপ্টার ভার্সন 6.0.0.0 কাজ করে।
- Google Mobile Ads Unity Plugin ভার্সন 11.5.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 2.0.0
- BIGO Ads SDK Android অ্যাডাপ্টার ভার্সন 6.0.0.0 কাজ করে।
- BIGO Ads SDK iOS অ্যাডাপ্টার ভার্সন 5.3.0.0-এর সাথে কাজ করে।
- Google Mobile Ads Unity প্লাগ-ইন ভার্সন ১১.৪.০-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.1.0
- BIGO Ads SDK Android অ্যাডাপ্টার ভার্সন 5.10.1.0 কাজ করে।
- BIGO Ads SDK iOS অ্যাডাপ্টার ভার্সন 5.3.0.0-এর সাথে কাজ করে।
- Google Mobile Ads Unity Plugin ভার্সন 11.3.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.0.0
- প্রারম্ভিক রিলিজ!
- BIGO Ads SDK Android অ্যাডাপ্টার ভার্সন 5.8.0.0 কাজ করে।
- BIGO Ads SDK iOS অ্যাডাপ্টার ভার্সন 5.1.2.0-এর সাথে কাজ করে।
- Google Mobile Ads Unity প্লাগ-ইন ভার্সন ১১.০.০-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।