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

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

এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে AdMob মিডিয়েশন ব্যবহার করে BIGO Ads SDK থেকে বিজ্ঞাপন লোড ও দেখানোর জন্য GMA Next-Gen SDK ব্যবহার করতে হয়, এতে বিডিং ইন্টিগ্রেশনও কভার করা হয়েছে। এতে বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে BIGO Ads SDK যোগ করার পদ্ধতি এবং Android অ্যাপে BIGO Ads SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করার পদ্ধতি সম্পর্কে আলোচনা করা হয়েছে।

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

BIGO Ads SDK-এর জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খোলার সাথে সাথে দেখা যায়
ব্যানার
স্থান
পুরস্কার জিতেছেন
পুরস্কৃত ইন্টারস্টিশিয়াল
নেটিভ

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:

• Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।

• লেটেস্ট GMA Next-Gen SDK ভার্সন।

• AdMob মেডিয়েশন সেট-আপ করুন।

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

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

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

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

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

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

গুরুত্বপূর্ণ: আপনি নতুন আবেদন তৈরি করার পরে, সেটি পর্যালোচনা করা হচ্ছে স্ট্যাটাসে থাকবে। পরবর্তী ধাপে যাওয়ার আগে আবেদনটি পর্যালোচনা করতে হবে।

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

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

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

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

আপনার app-ads.txt আপডেট করুন

অ্যাপের জন্য অনুমোদিত বিক্রেতা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। আপনি আগে থেকে এটি না করে থাকলে, আপনার অ্যাপের জন্য app-ads.txt ফাইল সেট-আপ করুন।

BIGO Ads SDK-এর জন্য app-ads.txt প্রয়োগ করতে, ড্যাশবোর্ড থেকে APP-ads.txt ট্যাবে নেভিগেট করুন এবং ট্যাবে দেওয়া নির্দেশাবলী অনুসরণ করুন।

ধাপ ২: AdMob UI-তে BIGO Ads SDK চাহিদা সেট-আপ করুন

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন

আপনার বিজ্ঞাপন ইউনিটের জন্য মিডিয়েশন কনফিগারেশনে আপনাকে BIGO Ads SDK যোগ করতে হবে।

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন-ইন করুন। এরপর, মধ্যস্থতা ট্যাবে নেভিগেট করুন। আপনার যদি আগে থেকে কোনও মধ্যস্থতা গ্রুপ থাকে এবং আপনি সেটি পরিবর্তন করতে চান, তাহলে সেই মধ্যস্থতা গ্রুপের নামে ক্লিক করে সেটি এডিট করুন এবং বিজ্ঞাপনের সোর্স হিসেবে BIGO Ads SDK যোগ করুন বিকল্পে যান।

নতুন মধ্যস্থতা গ্রুপ তৈরি করতে, মধ্যস্থতা গ্রুপ তৈরি করুন বিকল্প বেছে নিন।

আপনার বিজ্ঞাপনের ফর্ম্যাট ও প্ল্যাটফর্ম লিখুন, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।

আপনার মধ্যস্থতা গ্রুপের নাম দিন এবং টার্গেট করার জন্য লোকেশন বেছে নিন। এরপর, মধ্যস্থতা গ্রুপের স্ট্যাটাস চালু করা আছে হিসেবে সেট করুন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।

আপনার আগে থেকে থাকা এক বা একাধিক AdMob বিজ্ঞাপন ইউনিটের সাথে এই মধ্যস্থতা গ্রুপ যুক্ত করুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

আপনি এখন বিজ্ঞাপন ইউনিটের কার্ডে আপনার বেছে নেওয়া বিজ্ঞাপন ইউনিট দেখতে পাবেন:

বিজ্ঞাপন সোর্স হিসেবে BIGO Ads SDK যোগ করুন

বিজ্ঞাপনের সোর্স বিভাগে, বিডিং কার্ড খুঁজে নিন এবং বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন। তারপর BIGO Ads SDK বেছে নিন ।

BIGO Ads SDK-এর সাথে কীভাবে পার্টনারশিপ চুক্তিতে স্বাক্ষর করবেন এবং বিডিং পার্টনারশিপ সেট-আপ করবেন তা জানতে ক্লিক করুন।



স্বীকার করুন ও সম্মতি দিন বিকল্পে ক্লিক করুন, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।



আপনার কাছে আগে থেকেই BIGO Ads SDK-এর জন্য ম্যাপিং থাকলে, আপনি এটি বেছে নিতে পারেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।



এরপর, আগের বিভাগে পাওয়া স্লট আইডি লিখুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

গুরুত্বপূর্ণ: অ্যাপ্লিকেশন আইডি অবশ্যই BIGO Ads SDK UI-এর মতো টার্গেট করা অ্যাপের সাথে যুক্ত থাকতে হবে।

জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য রেগুলেশন বিজ্ঞাপন পার্টনারদের তালিকায় BIGO TECHNOLOGY PTE LTD যোগ করুন

গুরুত্বপূর্ণ: ইউরোপীয় ইউনিয়নের সম্মতি ও জিডিপিআর (GDPR), মার্কিন যুক্তরাষ্ট্রের রাজ্য রেগুলেশন এবং ব্যবহারকারীর মেসেজিং প্ল্যাটফর্মের জন্য কনফিগারেশন সম্পূর্ণ করতে আপনার কাছে অ্যাকাউন্ট ম্যানেজমেন্ট সংক্রান্ত অনুমতি আছে কিনা তা যাচাই করুন। বিস্তারিত জানতে আপনার অ্যাকাউন্টে ব্যবহারকারীর অ্যাক্সেস ম্যানেজ করুন দেখুন।

AdMob UI-তে ইউরোপিয়ান রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় Empathy Technology Pte.Ltd. (BIGO Ads) এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় **BIGOAds** যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস বিকল্পে দেওয়া ধাপগুলি অনুসরণ করুন।

ধাপ ৩: BIGO Ads SDK ও অ্যাডাপ্টার ইম্পোর্ট করা

মনে রাখবেন: মানানসই BIGO Ads SDK এবং Google Mobile Ads SDK ভার্সন ইন্টিগ্রেট করতে না পারলে, বিল্ড সংক্রান্ত সমস্যা হতে পারে।

Android Studio ইন্টিগ্রেশন (সাজেস্ট করা হয়েছে)

আপনার অ্যাপ-লেভেল গ্রেডেল ফাইলে, নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি ও কনফিগারেশন যোগ করুন:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:bigo:6.1.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:bigo:6.1.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

EU কনসেন্ট ও জিডিপিআর (GDPR)

Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।

BIGO Ads SDK, UMP SDK সহ কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা জিডিপিআর (GDPR) সম্মতি অটোমেটিক পড়ে। আরও তথ্যের জন্য, জিডিপিআর-এর উপর BIGO Ads SDK-এর ইন্টিগ্রেশন গাইড দেখুন।

মার্কিন যুক্তরাষ্ট্রের প্রদেশগুলির গোপনীয়তা আইন

মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে, ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।

BIGO Ads SDK-তে কীভাবে সম্মতি ফ্ল্যাগ পাস করতে হয় তা নিম্নলিখিত স্যাম্পেল কোড থেকে জানতে পারবেন। GMA Next-Gen SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এই পদ্ধতি কল করুন।

Java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

Kotlin

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

আরও তথ্যের জন্য, BIGO Ads SDK-এর ইন্টিগ্রেশন গাইড দেখুন, যা CCPA-তে রয়েছে।

ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন

BIGO Ads SDK ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।

ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করা

টেস্ট বিজ্ঞাপন চালু করুন

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

BIGO Ads, টেস্টিং ও ইন্টিগ্রেশনে সাহায্য করার জন্য Android -এর জন্য টেস্ট অ্যাপ্লিকেশন আইডি ও বিজ্ঞাপন স্লট আইডি প্রদান করে।

গুরুত্বপূর্ণ: আপনার অ্যাপ রিলিজ করার আগে AdMob এবং BIGO Ads SDK-এর জন্য টেস্ট মোড বন্ধ করুন।

টেস্ট বিজ্ঞাপন যাচাই করা

আপনি BIGO Ads SDK থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, BIGO Ads SDK (বিডিং) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

ঐচ্ছিক ধাপ

নেটিভ বিজ্ঞাপন

বিজ্ঞাপন রেন্ডারিং

BIGO Ads SDK অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনকে NativeAd অবজেক্ট হিসেবে ফিরিয়ে দেয়। এটি NativeAd-এর জন্য নিম্নলিখিত ফিল্ড পূরণ করে।

ফিল্ড	BIGO Ads SDK অ্যাডাপ্টার সবসময় অ্যাসেট অন্তর্ভুক্ত করে
শিরোনাম
ছবি
Body
আইকন
কল টু অ্যাকশন
তারকা রেটিং
স্টোর
দাম
বিজ্ঞাপনদাতা

সমস্যার কোড

BIGO Ads SDK থেকে অ্যাডাপ্টার বিজ্ঞাপন পেতে না পারলে, আপনি নিম্নলিখিত ক্লাসের অধীনে ResponseInfo.getAdSourceResponses() ব্যবহার করে বিজ্ঞাপন রেসপন্স থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন:

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

কোনও বিজ্ঞাপন লোড না হলে BIGO Ads SDK অ্যাডাপ্টারের মাধ্যমে দেখানো কোড এবং মেসেজ এখানে দেওয়া হল:

সমস্যার কোড	ডোমেন	কারণ
১০১	com.google.ads.mediation.bigo	Bigo স্লট আইডি নেই বা ফাঁকা আছে।
1000-1100	BIGO Ads SDK-এর মাধ্যমে পাঠানো হয়েছে	BIGO Ads SDK-তে সমস্যা হয়েছে। আরও তথ্যের জন্য BIGO Ads SDK-এর ডকুমেন্টেশন দেখুন।

Bigo Android মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

ভার্সন 6.1.0.0

• Bigo Ads SDK 6.1.0-এর সাথে যাচাই করা কম্প্যাটিবিলিটি।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৫.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
• Bigo Ads SDK ভার্সন 6.1.0.

ভার্সন 6.0.1.0

• Bigo Ads SDK 6.0.1-এর সাথে যাচাই করা কম্প্যাটিবিলিটি।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
• Bigo Ads SDK ভার্সন 6.0.1.

ভার্সন 6.0.0.1

• অ্যাডাপ্টারের Kotlin ডিপেন্ডেন্সি ১.৯.০-এ পিন করুন (GMA NextGen SDK-এর মাধ্যমে সমর্থিত Kotlin-এর ন্যূনতম ভার্সন)।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
• Bigo Ads SDK ভার্সন 6.0.0.

ভার্সন 6.0.0.0

• Bigo Ads SDK 6.0.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.৩.১।
• Bigo Ads SDK ভার্সন 6.0.0.

ভার্সন 5.10.1.0

• Bigo Ads SDK 5.10.1-এর সাথে যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.২.১।
• Bigo Ads SDK ভার্সন ৫.১০.১।

ভার্সন 5.9.0.1

• Bigo-এর COPPA API-তে AgeRestrictedTreatment ম্যাপ করে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.৪.০।
• Google Mobile Ads Next-Gen SDK ভার্সন ১.২.১।
• Bigo Ads SDK ভার্সন 5.9.0.

ভার্সন 5.9.0.0

• Bigo Ads SDK 5.9.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.২.০।
• Google Mobile Ads Next-Gen SDK ভার্সন 1.0.1।
• Bigo Ads SDK ভার্সন 5.9.0.

ভার্সন 5.8.0.0

• GMA নেক্সট-জেন SDK ডিপেন্ডেন্সির সাথে অ্যাডাপ্টার তৈরি করার জন্য প্রপার্টি যোগ করা হয়েছে।
• Bigo Ads SDK 5.8.0-এর সাথে যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.১.০।
• Bigo Ads SDK ভার্সন 5.8.0.

ভার্সন 5.7.1.0

• Bigo Ads SDK 5.7.1-এর সাথে কাজ করার বিষয়টি যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন ২৫.০.০।
• Bigo Ads SDK ভার্সন 5.7.1.

ভার্সন 5.7.0.0

• Bigo Ads SDK-তে tagForUnderAgeOfConsent Google Mobile Ads SDK প্যারামিটার ফরওয়ার্ড করার জন্য সহায়তা যোগ করা হয়েছে।
• Bigo Ads SDK 5.7.0-এর সাথে যাচাই করা কম্প্যাটিবিলিটি।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 24.9.0.
• Bigo Ads SDK ভার্সন 5.7.0.

ভার্সন 5.5.2.0

• ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কার প্রদানকারী ও নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য সহায়তা যোগ করা হয়েছে।
• Bigo Ads SDK 5.5.2-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।

এটির সাথে তৈরি ও পরীক্ষা করা হয়েছে:

• Google Mobile Ads SDK ভার্সন 24.9.0.
• Bigo Ads SDK ভার্সন 5.5.2.