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

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

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

i-mobile-এর ড্যাশবোর্ড ইন্টারফেসের লেবেল, বোতাম ও বিবরণে জাপানি টেক্সট ব্যবহার করা হয়। এই গাইডের স্ক্রিনশট অনুবাদ করা হয়নি। তবে, এই গাইডের বিবরণ ও নির্দেশাবলীতে, লেবেল ও বোতামের অনুবাদ করা হয়েছে এবং বন্ধনীতে সেগুলির ইংরেজি সমার্থক শব্দ দেওয়া হয়েছে।

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

i-mobile-এর জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:

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

পূর্বশর্ত

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

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

লেটেস্ট GMA Next-Gen SDK ভার্সন।
AdMob মেডিয়েশন সেট-আপ করুন।

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

আপনার i-mobile অ্যাকাউন্টে সাইন-আপ বা লগ-ইন করুন।

サイト／アプリ管理 (Site/Application Management) ট্যাব এবং আপনার অ্যাপের প্ল্যাটফর্মের জন্য বোতামে ক্লিক করে i-mobile ড্যাশবোর্ডে আপনার অ্যাপ যোগ করুন।

ফর্মটি পূরণ করে 新規登録 (সাইন-আপ করুন) বোতামে ক্লিক করুন।

নতুন বিজ্ঞাপন স্পট তৈরি করতে, サイト／アプリ管理 (সাইট/অ্যাপ্লিকেশন ম্যানেজমেন্ট) ট্যাবের অধীনে আপনার অ্যাপ বেছে নিন।

広告スポット管理 (Ad Spot Management) ট্যাবে গিয়ে 新規広告スポット (New Ad Spot) বোতামে ক্লিক করুন।

create_ad_spot

এরপর, 広告スポット名 (বিজ্ঞাপন স্পটের নাম), 広告スポットサイズ (বিজ্ঞাপন স্পটের সাইজ) এবং অন্যান্য বিবরণ দিয়ে ফর্মটি পূরণ করুন। তারপর, 新規登録 (সাইন-আপ করুন) বোতামে ক্লিক করুন।

new_ad_spot_form

আপনার নতুন বিজ্ঞাপন স্পট রেডি হয়ে গেছে। ইন্টিগ্রেশনের বিবরণ দেখতে, アプリ設定取得 (Get App settings) বোতামে ক্লিক করুন।

ad_spot_list

パブリッシャーID (প্রকাশক আইডি), メディアID (মিডিয়া আইডি), এবং スポットID (স্পট আইডি) নোট করুন। AdMob UI-তে মধ্যস্থতার জন্য i-mobile কনফিগার করার সময় আপনাকে এইসব প্যারামিটার ব্যবহার করতে হবে।

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

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

i-mobile-এর জন্য app-ads.txt প্রয়োগ করতে, তাদের প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।

ধাপ ২: AdMob UI-তে i-mobile ডিমান্ড সেট-আপ করা

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

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা কনফিগারেশনে i-mobile যোগ করতে হবে।

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

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

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

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

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

আপনার বেছে নেওয়া বিজ্ঞাপন ইউনিট দিয়ে বিজ্ঞাপন ইউনিটের কার্ডটি এখন পূরণ হয়ে গেছে:

বিজ্ঞাপন সোর্স হিসেবে i-mobile যোগ করুন

বিজ্ঞাপনের সোর্স বিভাগের ওয়াটারফল কার্ডে গিয়ে বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন।

i-mobile বেছে নিন এবং অপ্টিমাইজ করুন সুইচ চালু করুন। i-mobile-এর জন্য বিজ্ঞাপন সোর্স অপ্টিমাইজেশন সেট-আপ করতে, আগের বিভাগে পাওয়া লগ-ইন নাম এবং API পাসওয়ার্ড লিখুন। তারপর i-mobile-এর জন্য eCPM ভ্যালু লিখুন এবং চালিয়ে যান বিকল্পে ক্লিক করুন।

i-mobile-এর জন্য আপনার কাছে আগে থেকেই ম্যাপিং থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।

এরপর, আগের বিভাগ থেকে পাওয়া প্রকাশক আইডি, মিডিয়া আইডি এবং স্পট আইডি লিখুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

মনে রাখবেন: মধ্যস্থতা নেটওয়ার্কের জন্য eCPM সঠিকভাবে গণনা করতে, বিজ্ঞাপন সোর্স অপ্টিমাইজেশন পর্যাপ্ত ডেটা সংগ্রহ করতে কয়েক দিন সময় নেয়। ইতিমধ্যে, বিজ্ঞাপন সোর্স অপ্টিমাইজেশন স্ট্যাটাস হল PENDING, তাই আপনাকে অবশ্যই নেটওয়ার্কের জন্য ম্যানুয়ালি eCPM ভ্যালু সেট করতে হবে। eCPM গণনা করা হয়ে গেলে, বিজ্ঞাপন সোর্স অটোমেটিক আপনার হয়ে eCPM আপডেট করা শুরু করে দেয়।

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

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

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

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

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

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.6.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

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

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

i-mobile SDK-এর লেটেস্ট ভার্সন ডাউনলোড করুন এবং sdk ফোল্ডারের মধ্যে থেকে android-ad-sdk.aar এক্সট্র্যাক্ট করে আপনার প্রোজেক্টে যোগ করুন।
Google-এর Maven রিপোজিটরিতে i-mobile অ্যাডাপ্টার আর্টিফ্যাক্ট নেভিগেট করুন। লেটেস্ট ভার্সন বেছে নিন, i-mobile অ্যাডাপ্টারের .aar ফাইল ডাউনলোড করুন এবং আপনার প্রোজেক্টে এটি যোগ করুন।

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

অ্যাক্টিভিটি কনটেক্সট সহ বিজ্ঞাপন লোড করুন

ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কার প্রদানকারী এবং নেটিভ বিজ্ঞাপন ফর্ম্যাট লোড করার সময় Activity প্রসঙ্গ পাস করুন। অ্যাক্টিভিটি প্রসঙ্গ ছাড়া, বিজ্ঞাপন লোড করা যাবে না।

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

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

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না। i-mobile পরীক্ষার জন্য Spot আইডি, মিডিয়া আইডি, এবং প্রকাশক আইডি প্রদান করে, আপনি সেগুলি এখানে খুঁজে পেতে পারেন।

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

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

ঐচ্ছিক ধাপ

নেটিভ বিজ্ঞাপন ব্যবহার করা

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

i-mobile অ্যাডাপ্টার NativeAd-এর জন্য নেটিভ বিজ্ঞাপনের উন্নত ফিল্ডের বিবরণ পপুলেট করে।

ফিল্ড	i-mobile অ্যাডাপ্টারের মাধ্যমে সবসময় অ্যাসেট অন্তর্ভুক্ত করা হয়
শিরোনাম
ছবি
Body
অ্যাপ আইকন	^১
কল টু অ্যাকশন
তারকা রেটিং
স্টোর
দাম

^১ নেটিভ বিজ্ঞাপনের জন্য, i-mobile SDK কোনও অ্যাপ আইকন অ্যাসেট প্রদান করে না। পরিবর্তে, i-mobile অ্যাডাপ্টার অ্যাপ আইকনকে একটি স্বচ্ছ ছবি দিয়ে পপুলেট করে।

ত্রুটি কোড

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

ফর্ম্যাট	ক্লাসের নাম
ব্যানার	com.google.ads.mediation.imobile.IMobileAdapter
স্থান	com.google.ads.mediation.imobile.IMobileAdapter
নেটিভ	com.google.ads.mediation.imobile.IMobileMediationAdapter

কোনও বিজ্ঞাপন লোড না হলে i-mobile অ্যাডাপ্টারের মাধ্যমে দেখানো কোড ও মেসেজ এখানে দেওয়া হল:

সমস্যার কোড	কারণ
0-99	i-mobile SDK-তে সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন।
১০১	i-mobile-এ বিজ্ঞাপন লোড করার জন্য `Activity` কনটেক্সট প্রয়োজন।
102	AdMob UI-তে কনফিগার করা i-mobile সার্ভার প্যারামিটার নেই/ভুল।
103	অনুরোধ করা বিজ্ঞাপনের সাইজ i-mobile-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
104	i-mobile-এর নেটিভ বিজ্ঞাপন লোড করার সাকসেস কলব্যাক একটি খালি নেটিভ বিজ্ঞাপনের তালিকা ফিরিয়ে দিয়েছে।
১০৫	অনুরোধে বয়স সংক্রান্ত বিধিনিষেধযুক্ত ট্রিটমেন্ট ছিল, কিন্তু i-mobile SDK বয়স সংক্রান্ত বিধিনিষেধযুক্ত সিগন্যাল গ্রহণ করতে পারে না

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