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

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

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

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

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

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

পূর্বশর্ত

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

  • Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।

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

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

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

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

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

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

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

আপনার আবেদন আইডি মনে রাখুন।

আবেদনের আইডি

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

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

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

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

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

স্লট আইডি মনে রাখবেন

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

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

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

BIGO Ads SDK-এর জন্য app-ads.txt প্রয়োগ করতে, ড্যাশবোর্ড থেকে 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-এর জন্য আপনার আগে থেকেই কোনও ম্যাপিং থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।



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



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

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

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

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

Kotlin

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

Groovy

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

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

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

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

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

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

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

Java

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

Kotlin

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

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

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

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

ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

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

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

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

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

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

ঐচ্ছিক ধাপ

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

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

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

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

সমস্যার কোড

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

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 ভার্সন 25.5.0.
  • 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 ভার্সন 25.4.0.
  • Google Mobile Ads Next-Gen SDK ভার্সন 1.4.0.
  • Bigo Ads SDK ভার্সন 6.0.1.

ভার্সন 6.0.0.1

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

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

  • Google Mobile Ads SDK ভার্সন 25.4.0.
  • 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 ভার্সন 25.4.0.
  • Google Mobile Ads Next-Gen SDK ভার্সন 1.3.1.
  • Bigo Ads SDK ভার্সন 6.0.0.

ভার্সন 5.10.1.0

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

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

  • Google Mobile Ads SDK ভার্সন 25.4.0.
  • Google Mobile Ads Next-Gen SDK ভার্সন 1.2.1.
  • Bigo Ads SDK ভার্সন 5.10.1.

ভার্সন 5.9.0.1

  • Maps AgeRestrictedTreatment থেকে Bigo-র COPPA API-তে।

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

  • Google Mobile Ads SDK ভার্সন 25.4.0.
  • Google Mobile Ads Next-Gen SDK ভার্সন 1.2.1.
  • Bigo Ads SDK ভার্সন 5.9.0.

ভার্সন 5.9.0.0

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

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

  • Google Mobile Ads SDK ভার্সন 25.2.0.
  • 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 ভার্সন 25.1.0.
  • Bigo Ads SDK ভার্সন 5.8.0.

ভার্সন 5.7.1.0

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

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

  • Google Mobile Ads SDK ভার্সন 25.0.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-এর সাথে মানানসই হিসেবে যাচাই করা হয়েছে।

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

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