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

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

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

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

পূর্বশর্ত

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

• Android API লেভেল ২৪ বা তার পরের ভার্সন।

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

• মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

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

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

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

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

আপনার 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 ডিমান্ড সেট-আপ করুন

আপনার Ad Manager অ্যাকাউন্টে সাইন-ইন করুন।

কোম্পানিতে BIGO Ads SDK যোগ করুন

সুরক্ষিত করা সিগন্যাল শেয়ার করার সুবিধা চালু করুন

বিড করার জন্য অনুরোধে নিরাপদ সিগন্যাল শেয়ার করুন

SDK বিডিংয়ের জন্য নিরাপদ সিগন্যাল শেয়ারিং অনুমোদন করুন

BIGO Ads SDK বিডিং কনফিগার করুন

বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করা

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

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

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

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

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

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")
}

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-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এই পদ্ধতি কল করুন।

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

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

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

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

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

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

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

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

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

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

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

ঐচ্ছিক ধাপ

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

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

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

ত্রুটি কোড

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

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

কোনও বিজ্ঞাপন লোড না হলে 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 ভার্সন 1.4.0.
• 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 ভার্সন 1.4.0.
• 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 ভার্সন 1.4.0.
• 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 ভার্সন ২৪.৯.০।
• Bigo Ads SDK ভার্সন 5.7.0.

ভার্সন 5.5.2.0

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

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

• Google Mobile Ads SDK ভার্সন ২৪.৯.০।
• Bigo Ads SDK ভার্সন 5.5.2.