মেডিটেশনের সাথে BIGO Ads SDK ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Android (Legacy)

এই নির্দেশিকা আপনাকে দেখায় কীভাবে 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 লেভেল ২৪ বা তার পরের ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Unity Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Unity প্রোজেক্ট। আরও বিবরণের জন্য শুরু করুন বিকল্প দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

ধাপ ১: BIGO Ads SDK UI-তে কনফিগারেশন সেট-আপ করুন

আপনার BIGO Ads ড্যাশবোর্ডে লগ-ইন করুন।

অ্যাপ তৈরি করুন

ইনভেনটরি ট্যাবে গিয়ে অ্যাপ ও সাইট টেবিলের মধ্যে + যোগ করুন বোতাম বেছে নিন।

অ্যাপ যোগ করুন

ফর্মের বাকি অংশ পূরণ করে জমা দিন বিকল্পে ক্লিক করুন।

নতুন অ্যাপ ফর্ম

আপনার অ্যাপ্লিকেশন আইডি নোট করে রাখুন।

Android

Android অ্যাপ্লিকেশন আইডি

iOS

iOS অ্যাপ্লিকেশন আইডি

বিজ্ঞাপন স্লট তৈরি করা

আপনার আবেদন পর্যালোচনা করা হয়ে গেলে, বিজ্ঞাপন স্লট টেবিলে গিয়ে + যোগ করুন বোতাম বেছে নিন।

বিজ্ঞাপন স্লট যোগ করুন

নিলামের ধরন-এর জন্য সার্ভার বিডিং বেছে নিন, ফর্মের বাকি অংশ পূরণ করুন এবং জমা দিন বিকল্পে ক্লিক করুন।

নতুন বিজ্ঞাপন স্লট ফর্ম

স্লট আইডি নোট করুন

Android

Android বিজ্ঞাপন স্লট আইডি

iOS

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 ট্যাবে নেভিগেট করুন এবং ট্যাবে দেওয়া নির্দেশাবলী অনুসরণ করুন।

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.bigo

OpenUPM

আপনার Unity প্রোজেক্ট এডিটরে, এডিট করুন > প্রোজেক্ট সেটিংস > প্যাকেজ ম্যানেজার বিকল্প বেছে নিন যাতে Unity প্যাকেজ ম্যানেজার সেটিংস খোলা যায়।

স্কোপড রেজিস্ট্রি ট্যাবের মধ্যে, নিম্নলিখিত বিবরণ সহ স্কোপড রেজিস্ট্রি হিসেবে OpenUPM যোগ করুন:

  • নাম: OpenUPM
  • URL: https://package.openupm.com
  • স্কোপ: com.google

OpenUPM-এর বিবরণ

তারপর, Unity প্যাকেজ ম্যানেজার খুলতে উইন্ডো > প্যাকেজ ম্যানেজার বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

Unity Registries

Google Mobile Ads Bigo Mediation প্যাকেজ বেছে নিয়ে ইনস্টল করুন বিকল্পে ক্লিক করুন।

OpenUPM থেকে ইনস্টল করুন

Unity প্যাকেজ

BIGO Ads SDK-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করতে, চেঞ্জলগ-এ দেওয়া ডাউনলোড লিঙ্ক ব্যবহার করুন এবং জিপ ফাইল থেকে GoogleMobileAdsBigoMediation.unitypackage এক্সট্র্যাক্ট করুন।

আপনার Unity প্রোজেক্ট এডিটরে, অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ বেছে নিন এবং আপনার ডাউনলোড করা GoogleMobileAdsBigoMediation.unitypackage ফাইলটি খুঁজুন। সব ফাইল বেছে নেওয়া হয়েছে কিনা তা দেখে নিয়ে ইমপোর্ট করুন বিকল্পে ক্লিক করুন।

Unity থেকে ইমপোর্ট করুন

তারপর, অ্যাসেট > এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার > Android রিজলভার > ফোর্স রিজলভ বিকল্প বেছে নিন। এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার লাইব্রেরি শুরু থেকে ডিপেন্ডেন্সি রেজোলিউশন পারফর্ম করবে এবং ঘোষিত ডিপেন্ডেন্সি আপনার Unity অ্যাপের Assets/Plugins/Android ডিরেক্টরিতে কপি করবে।

ফোর্স রিজলভ

ধাপ ৪: BIGO Ads SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা

BIGO Ads SDK-এর জন্য গোপনীয়তা সেটিংস প্রয়োগ করতে এবং প্রাসঙ্গিক গোপনীয়তা রেগুলেশন মেনে চলতে, নিম্নলিখিত বিভাগগুলি পড়ুন।

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-এর ডকুমেন্টেশন দেখুন।

BIGO Ads SDK Unity Mediation প্লাগ-ইন চেঞ্জলগ

ভার্সন 3.1.0 (কাজ চলছে)

ভার্সন 3.0.0

ভার্সন 2.0.0

ভার্সন 1.1.0

ভার্সন 1.0.0