এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে বিডিং ইন্টিগ্রেশন কভার করে AdMob মধ্যস্থতা ব্যবহার করে BIGO Ads SDK থেকে বিজ্ঞাপন লোড ও দেখাতে Google Mobile Ads Unity Plugin হয়। এতে কীভাবে কোনও বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে BIGO Ads SDK যোগ করতে হয় এবং কীভাবে Unity অ্যাপে BIGO Ads SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করতে হয় তা বলা আছে।
কাজ করে এমন ইন্টিগ্রেশন ও বিজ্ঞাপন ফর্ম্যাট
BIGO Ads SDK-এর জন্য AdMob মেডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| অ্যাপ ওপেন | |
| ব্যানার | |
| স্থান | |
| পুরস্কার জিতেছেন | |
| পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল | |
| নেটিভ | |
পূর্বশর্ত
এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করিয়ে নিন:
- Google Mobile Ads Unity Plugin-এর লেটেস্ট ভার্সন।
- Unity Editor ভার্সন 2019.4 বা তার পরবর্তী যেকোনও ভার্সন।
- Android-এ ডেপ্লয় করতে
- Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।
- iOS-এ ডেপ্লয় করতে
- iOS ডিপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
- Google Mobile Ads Unity Plugin-এর সাথে কনফিগার করা একটি চালু Unity প্রোজেক্ট। বিবরণের জন্য শুরু করুন দেখুন।
- AdMob মধ্যস্থতা সেট-আপ করুন।
ধাপ ১: BIGO Ads SDK UI-তে কনফিগারেশন সেট-আপ করুন
BIGO Ads ড্যাশবোর্ডে লগ-ইন করুন।
অ্যাপ তৈরি করা
ইনভেনটরি ট্যাবে নেভিগেট করুন এবং অ্যাপ ও সাইট টেবিলের মধ্যে থেকে, + যোগ করুন বোতামটি বেছে নিন।
বাকি ফর্ম পূরণ করে জমা দিন বিকল্পে ক্লিক করুন।
আপনার আবেদন আইডি মনে রাখুন।
Android
iOS
বিজ্ঞাপন স্লট তৈরি করা
আপনার আবেদন পর্যালোচনা করা হয়ে গেলে, বিজ্ঞাপনের স্লট সারণীতে যান এবং + যোগ করুন বোতামটি বেছে নিন।
নিলামের ধরন হিসেবে সার্ভার বিডিং বেছে নিন, বাকি ফর্ম পূরণ করুন এবং জমা দিন বিকল্পে ক্লিক করুন।
স্লট আইডি মনে রাখবেন
Android
iOS
আপনার app-ads.txt আপডেট করা
অ্যাপের জন্য অনুমোদিত বিক্রেতা app-ads.txt হল একটি IAB টেক ল্যাব ইনিশিয়েটিভ যা কনফার্ম করতে সাহায্য করে যে আপনার
অ্যাপ বিজ্ঞাপনের ইনভেনটরি আপনি যাদের অনুমোদিত হিসেবে শনাক্ত করেছেন, শুধুমাত্র সেইসব চ্যানেলের মাধ্যমেই বিক্রি করা কনফার্ম করতে সাহায্য করে। বিজ্ঞাপন থেকে হওয়া উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
আপনার অ্যাপের জন্য একটি app-ads.txt ফাইল সেট-আপ করুন।
BIGO Ads SDK-এর জন্য app-ads.txt প্রয়োগ করতে, ড্যাশবোর্ড থেকে APP-ads.txt
ট্যাবে নেভিগেট করুন এবং ট্যাবে
থাকা নির্দেশাবলী অনুসরণ করুন।
ধাপ ২: AdMob UI-তে BIGO Ads SDK চাহিদা সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করা
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
জিডিপিআর (GDPR) ও মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারের তালিকায় BIGO TECHNOLOGY PTE LTD-কে যোগ করুন
AdMob 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 খুলতে উইন্ডো > প্যাকেজ ম্যানেজার বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।
Google Mobile Ads Bigo Mediation প্যাকেজ বেছে নিয়ে ইনস্টল করুন বিকল্পে ক্লিক করুন।
Unity প্যাকেজ
BIGO Ads SDK-এর জন্য Google Mobile Ads মেডিটেশন প্লাগ-ইনের লেটেস্ট ভার্সন
পরিবর্তনের লগ
থেকে ডাউনলোড করুন এবং zip
ফাইল থেকে
GoogleMobileAdsBigoMediation.unitypackage এক্সট্র্যাক্ট করুন।
আপনার Unity প্রোজেক্ট এডিটরে, অ্যাসেট > প্যাকেজ ইমপোর্ট করুন >
কাস্টম প্যাকেজ বিকল্প বেছে নিন এবং
GoogleMobileAdsBigoMediation.unitypackage
আপনার ডাউনলোড করা ফাইলটি খুঁজে নিন। সব ফাইল বেছে নেওয়া হয়েছে কিনা তা নিশ্চিত করুন এবং
ইমপোর্ট করুন বিকল্পে ক্লিক করুন।
তারপর, অ্যাসেট > এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার >
Android Resolver > ফোর্স রিজলভ বিকল্প বেছে নিন। এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার
লাইব্রেরি, শুরু থেকে ডিপেন্ডেন্সি রেজোলিউশন পারফর্ম করবে এবং
ঘোষিত ডিপেন্ডেন্সি আপনার
Unity অ্যাপের Assets/Plugins/Android ডিরেক্টরিতে কপি করবে।
ধাপ ৪: BIGO Ads SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
BIGO Ads SDK-এর জন্য গোপনীয়তা সেটিংস প্রয়োগ করতে এবং প্রাসঙ্গিক গোপনীয়তা নিয়ম মেনে চলতে, নিম্নলিখিত বিভাগগুলি পড়ুন।
ইউরোপীয় ইউনিয়নের ব্যবহারকারীর সম্মতি ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডে বসবাসকারী ব্যবহারকারীদের কাছে নির্দিষ্ট কিছু তথ্য প্রকাশ করতে হবে এবং আইনত প্রয়োজনীয় হলে কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য তাদের সম্মতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রেরণ করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
BIGO Ads SDK, UMP SDK সহ সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্মের সেট করা জিডিপিআর (GDPR) সম্মতি অটোমেটিক পড়ে নেয়। আরও তথ্যের জন্য, Android এবং iOS-এর জন্য BIGO Ads SDK-এর জিডিপিআর (GDPR) গাইড দেখুন।
মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের গোপনীয়তা আইন ব্যবহারকারীদের অধিকার দেয় যে তারা তাদের "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প থেকে অপ্ট-আউট করতে পারবেন (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত করা হয়েছে)। অপ্ট-আউট করার এই বিকল্প "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google-এর বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রসেসিং চালু করার সুবিধা দেয়, কিন্তু 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-এর ডকুমেন্টেশন
অনুসরণ করুন।
ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করা
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা তা ভালোভাবে দেখে নিন।
টেস্টিং ও ইন্টিগ্রেশনে সাহায্য করার জন্য 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.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 Plugin ভার্সন 11.4.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 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 Plugin ভার্সন 11.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।