আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

মেডিয়েশনের সাথে maio ইন্টিগ্রেট করা

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

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

maio-এর ড্যাশবোর্ড ইন্টারফেসের লেবেল, বোতাম ও বিবরণে জাপানি টেক্সট ব্যবহার করা হয় এবং এই গাইডের স্ক্রিনশট অনুবাদ করা হয়নি। তবে, এই গাইডের বিবরণ ও নির্দেশাবলীতে, লেবেল ও বোতামের নাম ইংরেজি ভাষায় উল্লেখ করা হয়েছে। "URL スキーム," for example, is "URL Scheme".

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

maio-এর জন্য মিডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:

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

পূর্বশর্ত

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

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

maio SDK 1.0.7 বা তার পরের ভার্সন।

লেটেস্ট GMA Next-Gen SDK ভার্সন।
মধ্যস্থতা সেট-আপ করুন।

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

প্রথমে, আপনার maio অ্যাকাউন্টে সাইন-আপ করুন অথবা লগ-ইন করুন। বাঁদিকের সাইডবারে অ্যাপ্লিকেশন ম্যানেজমেন্ট বোতামে ক্লিক করুন এবং নতুন অ্যাপ বিকল্পে ক্লিক করুন।

আপনার পছন্দের বিজ্ঞাপনের ধরন অনুযায়ী ট্যাব বেছে নিন।

স্থান

আপনার অ্যাপের নাম লিখুন, প্ল্যাটফর্ম বেছে নিন এবং আপনার অ্যাপ URL দিন। বিজ্ঞাপনের ধরন হিসেবে ভিডিও ইন্টারস্টিশিয়াল বেছে নিন এবং তারপরে আপডেট করুন বিকল্পে ক্লিক করুন।

পুরস্কার জিতেছেন

আপনার অ্যাপের নাম লিখুন, প্ল্যাটফর্ম বেছে নিন এবং আপনার অ্যাপ URL দিন। বিজ্ঞাপনের ধরন হিসেবে ভিডিও পুরস্কার বেছে নিন এবং তারপরে আপডেট করুন বিকল্পে ক্লিক করুন।

অ্যাপ্লিকেশন ম্যানেজমেন্ট পৃষ্ঠায়, মিডিয়া আইডি নোট করে রাখুন। পরবর্তী বিভাগে আপনার Ad Manager বিজ্ঞাপন ইউনিট সেট-আপ করার জন্য এটি প্রয়োজন।

জোন ম্যানেজমেন্ট পৃষ্ঠায়, জোন আইডি নোট করে রাখুন। এছাড়াও, পরবর্তী বিভাগে আপনার Ad Manager বিজ্ঞাপন ইউনিট সেট-আপ করার জন্য এটি প্রয়োজন হবে।

মিডিয়া আইডি এবং জোন আইডি ছাড়াও, মধ্যস্থতার জন্য আপনার বিজ্ঞাপন ইউনিট আইডি সেট-আপ করতে API আইডি এবং API KEY প্রয়োজন হবে। Reporting API পৃষ্ঠা থেকে, API ID এবং API KEY নোট করে নিন।

ধাপ ২: Ad Manager UI-তে maio ডিমান্ড সেট-আপ করা

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

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

ডেলিভারি > ইয়েল্ড গ্রুপ বিকল্পে গিয়ে নতুন ইয়েল্ড গ্রুপ বোতামে ক্লিক করুন।

আপনার ইল্ড গ্রুপের জন্য একটি অনন্য নাম লিখুন, স্ট্যাটাস অ্যাক্টিভ হিসেবে সেট করুন, আপনার বিজ্ঞাপনের ফর্ম্যাট বেছে নিন এবং ইনভেনটরির ধরন মোবাইল অ্যাপ হিসেবে সেট করুন। টার্গেট করা > ইনভেনটরি বিভাগের অধীনে, ইনভেনটরি এবং মোবাইল অ্যাপ্লিকেশন-এর অধীনে বিজ্ঞাপন ইউনিট বেছে নিন, যেখানে আপনি মধ্যস্থতা যোগ করতে চান।

এরপর, ইল্ড পার্টনার যোগ করুন বোতামে ক্লিক করুন।

maio-এর জন্য আপনার আগে থেকেই কোনও ইল্ড পার্টনার থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, নতুন ইল্ড পার্টনার তৈরি করুন বিকল্প বেছে নিন।

বিজ্ঞাপন নেটওয়ার্ক হিসেবে maio বেছে নিন, একটি অনন্য নাম লিখুন এবং মেডিয়েশন চালু করুন।

অটোমেটিক ডেটা সংগ্রহ বিকল্প চালু করুন এবং আগের বিভাগে পাওয়া API ID ও API KEY লিখুন।

ইল্ড পার্টনার বেছে নেওয়ার পরে, ইন্টিগ্রেশনের ধরন হিসেবে মোবাইল SDK মধ্যস্থতা, প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে অ্যাক্টিভ বিকল্প বেছে নিন। আগের বিভাগে পাওয়া মিডিয়া আইডি এবং জোন আইডি লিখুন। তারপর, ডিফল্ট CPM ভ্যালু লিখুন।

হয়ে গেলে, পৃষ্ঠার একদম নিচে সেভ করুন বিকল্পে ক্লিক করুন।

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

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

আপনার প্রোজেক্ট-লেভেল settings.gradle.kts ফাইলে, নিম্নলিখিত রিপোজিটরি যোগ করুন:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile-maio.github.io/maven")
    }
  }
}

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

Kotlin

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

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:maio:2.0.9.1'
}

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

ম্যানুয়াল ইন্টিগ্রেশন

maio Android SDK-এর লেটেস্ট ভার্সন ডাউনলোড করে আপনার প্রোজেক্টে যোগ করুন।
Google-এর Maven রিপোজিটরিতে maio অ্যাডাপ্টার আর্টিফ্যাক্ট-এ নেভিগেট করুন। লেটেস্ট ভার্সন বেছে নিন, maio অ্যাডাপ্টারের `.aar' ফাইল ডাউনলোড করুন এবং আপনার প্রোজেক্টে এটি যোগ করুন।

ধাপ ৪: প্রয়োজনীয় কোড যোগ করুন

maio Android ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।

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

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

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

GMA Next-Gen SDK-এর 11.6.0 বা তার পরবর্তী ভার্সন ব্যবহারকারী প্রকাশকরা অনুরোধ করার সময় টেস্ট ডিভাইস হিসেবে রেজিস্টার করা ফোন ও ট্যাবলেটে maio থেকে অটোমেটিক টেস্ট বিজ্ঞাপন পাবেন।

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

আপনি maio থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, maio (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

ত্রুটি কোড

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

ফর্ম্যাট	ক্লাসের নাম
স্থান	jp.maio.sdk.android.mediation.admob.adapter.Interstitial
পুরস্কার জিতেছেন	jp.maio.sdk.android.mediation.admob.adapter.Rewarded

কোনও বিজ্ঞাপন লোড হতে না পারলে, maio অ্যাডাপ্টার যেসব কোড ও মেসেজ দেখায় সেগুলি এখানে দেওয়া হল:

সমস্যার কোড	কারণ
0-10	maio একটি SDK-নির্দিষ্ট ত্রুটি রিটার্ন করেছে। আরও বিবরণের জন্য কোড এবং maio-এর ডকুমেন্টেশন দেখুন।
১০১	Maio-তে কোনও বিজ্ঞাপন উপলভ্য নেই।
102	সার্ভার প্যারামিটার ভুল (যেমন, প্লেসমেন্ট আইডি নেই)।
103	বিজ্ঞাপন লোড করার জন্য ব্যবহৃত প্রসঙ্গটি কোনও `Activity` ইনস্ট্যান্স ছিল না।
104	অনুরোধে বয়স সংক্রান্ত বিধিনিষেধযুক্ত ট্রিটমেন্ট ছিল, কিন্তু maio SDK বয়স সংক্রান্ত বিধিনিষেধযুক্ত সিগন্যাল গ্রহণ করতে পারে না

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