মধ্যস্থতার সাথে BIGO বিজ্ঞাপন SDK একীভূত করুন

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে বিডিং ইন্টিগ্রেশন সহ, মিডিয়েশন ব্যবহার করে BIGO Ads SDK থেকে বিজ্ঞাপন লোড ও প্রদর্শন করতে Google Mobile Ads SDK (Legacy) ব্যবহার করতে হয়। এতে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে BIGO Ads SDK যোগ করার পদ্ধতি এবং একটি অ্যান্ড্রয়েড অ্যাপে BIGO Ads SDK ও অ্যাডাপ্টারকে ইন্টিগ্রেট করার পদ্ধতি আলোচনা করা হয়েছে।

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

BIGO Ads SDK-এর মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

^১. বিডিং ইন্টিগ্রেশন বর্তমানে ক্লোজড বিটা পর্যায়ে রয়েছে, অ্যাক্সেসের জন্য আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

প্রয়োজনীয়তা

• অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি

• সর্বশেষ Google Mobile Ads SDK (Legacy)

• মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন।

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

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

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

ইনভেন্টরি ট্যাবে যান এবং অ্যাপস ও সাইটস টেবিলের নিচে থাকা + অ্যাড বাটনটি নির্বাচন করুন।

ফর্মের বাকি অংশ পূরণ করুন এবং সাবমিট বাটনে ক্লিক করুন।

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

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

আপনার আবেদনটি পর্যালোচনা করা হয়ে গেলে, Ad Slots টেবিলে যান এবং + Add বোতামটি নির্বাচন করুন।

নিলামের ধরন হিসেবে সার্ভার বিডিং নির্বাচন করুন, ফর্মের বাকি অংশ পূরণ করুন এবং সাবমিট-এ ক্লিক করুন।

স্লট আইডিটি নোট করে রাখুন।

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

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

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

ধাপ ২: অ্যাড ম্যানেজার UI-তে BIGO Ads SDK ডিমান্ড সেট আপ করুন।

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

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

নিরাপদ সংকেত আদান-প্রদান সক্ষম করুন

দরপত্রের অনুরোধে সুরক্ষিত সংকেত শেয়ার করুন

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

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

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

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা অনুযায়ী বিজ্ঞাপন অংশীদারদের তালিকায় BIGO TECHNOLOGY PTE LTD-কে যুক্ত করুন।

অ্যাড ম্যানেজার UI-তে ইউরোপীয় এবং মার্কিন রাজ্য বিধিমালা বিজ্ঞাপন অংশীদারদের তালিকায় BIGO TECHNOLOGY PTE LTD-কে যুক্ত করতে , ইউরোপীয় বিধিমালা সেটিংস এবং মার্কিন রাজ্য বিধিমালা সেটিংস- এর ধাপগুলো অনুসরণ করুন।

ধাপ ৩: BIGO Ads SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন

অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("com.google.ads.mediation:bigo:5.10.1.0")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'com.google.ads.mediation:bigo:5.10.1.0'
}

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

Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে থাকা আপনার ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং যেখানে আইনত প্রয়োজন সেখানে কুকি বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপনের ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ePrivacy Directive এবং General Data Protection Regulation (GDPR)-এর প্রয়োজনীয়তাগুলো প্রতিফলিত করে। আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পৌঁছেছে কিনা তা যাচাই করার দায়িত্ব আপনার। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ প্রেরণ করতে অক্ষম।

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

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

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

নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে BIGO Ads SDK-তে কনসেন্ট ফ্ল্যাগ পাস করতে হয়। Google Mobile Ads SDK (Legacy) এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এই মেথডটি কল করুন।

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

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

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

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

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

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করা নিশ্চিত করুন।

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

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

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

ঐচ্ছিক পদক্ষেপ

স্থানীয় বিজ্ঞাপন

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

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

ত্রুটি কোড

যদি অ্যাডাপ্টারটি BIGO Ads SDK থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdapterResponses() ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

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

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন BIGO Ads SDK অ্যাডাপ্টার কর্তৃক প্রদর্শিত কোড এবং সংশ্লিষ্ট বার্তাগুলো নিচে দেওয়া হলো:

বিগো অ্যান্ড্রয়েড মেডিয়েশন অ্যাডাপ্টার পরিবর্তন তালিকা

সংস্করণ ৫.১০.১.০

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.৪.০।
• গুগল মোবাইল অ্যাডস নেক্সট-জেন এসডিকে সংস্করণ ১.২.১।
• বিগো অ্যাডস এসডিকে সংস্করণ ৫.১০.১।

সংস্করণ ৫.৯.০.১

• Bigo-এর COPPA API-তে মানচিত্র AgeRestrictedTreatment ।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.৪.০।
• গুগল মোবাইল অ্যাডস নেক্সট-জেন এসডিকে সংস্করণ ১.২.১।
• বিগো অ্যাডস এসডিকে সংস্করণ ৫.৯.০।

সংস্করণ ৫.৯.০.০

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.২.০।
• গুগল মোবাইল অ্যাডস নেক্সট-জেন এসডিকে সংস্করণ ১.০.১।
• বিগো অ্যাডস এসডিকে সংস্করণ ৫.৯.০।

সংস্করণ 5.8.0.0

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.১.০।
• বিগো অ্যাডস এসডিকে সংস্করণ ৫.৮.০।

সংস্করণ ৫.৭.১.০

• Bigo Ads SDK 5.7.1-এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৫.০.০।
• বিগো অ্যাডস এসডিকে সংস্করণ ৫.৭.১।

সংস্করণ 5.7.0.0

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৪.৯.০।
• বিগো অ্যাডস এসডিকে সংস্করণ ৫.৭.০।

সংস্করণ ৫.৫.২.০

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

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

• গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৪.৯.০।
• বিগো অ্যাডস এসডিকে সংস্করণ ৫.৫.২।