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

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

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

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

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

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

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

পূর্বশর্ত

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

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

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

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

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

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

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

広告スポット管理 (বিজ্ঞাপন স্পট ম্যানেজমেন্ট) ট্যাবে নেভিগেট করুন এবং 新規広告スポット (নতুন বিজ্ঞাপন স্পট) বোতামে ক্লিক করুন।

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

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

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

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

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

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

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

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

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

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

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

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

অটোমেটিক ডেটা সংগ্রহ চালু করুন এবং লগ-ইন নাম ও API পাসওয়ার্ড লিখুন

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

হয়ে গেলে, পৃষ্ঠার নিচে সেভ করুন বিকল্পে ক্লিক করুন।

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

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

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

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

Kotlin

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

Groovy

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

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

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

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

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

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

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

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

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

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

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

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

ঐচ্ছিক ধাপ

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

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

i-mobile অ্যাডাপ্টার NativeAd-এর জন্য নিম্নলিখিত ফিল্ড পূরণ করে।

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

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

সমস্যার কোড

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

ফর্ম্যাট ক্লাসের নাম
ব্যানার 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 Ad Manager UI-তে কনফিগার করা i-mobile সার্ভার প্যারামিটার নেই/ভুল।
103 অনুরোধ করা বিজ্ঞাপনের সাইজ i-mobile-এ কাজ করে এমন ব্যানার সাইজের সাথে মিলছে না।
104 i-mobile-এর নেটিভ বিজ্ঞাপন লোড হওয়ার সাকসেস কলব্যাক একটি খালি নেটিভ বিজ্ঞাপন তালিকা রিটার্ন করেছে।
১০৫ অনুরোধে বয়স সংক্রান্ত বিধিনিষেধযুক্ত ট্রিটমেন্ট ছিল, কিন্তু i-mobile SDK বয়স সংক্রান্ত বিধিনিষেধযুক্ত সিগন্যাল গ্রহণ করতে পারে না

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

ভার্সন 2.3.2.5

  • অ্যাডাপ্টারের Kotlin ডিপেন্ডেন্সি ১.৯.০-এ পিন করুন (GMA NextGen SDK-এর মাধ্যমে সমর্থিত Kotlin-এর ন্যূনতম ভার্সন)।
  • বিজ্ঞাপন শুরু করা এবং বিজ্ঞাপন লোড করার অনুরোধের সময় বয়স-সীমাবদ্ধ ব্যর্থতার ব্রাঞ্চে ফল-থ্রু আচরণ ঠিক করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন ২৫.৪.০।
  • Google Mobile Ads Next-Gen SDK ভার্সন ১.৪.০।
  • IMobile SDK ভার্সন 2.3.2.

ভার্সন 2.3.2.4

  • নতুন AgeRestrictedTreatment, CHILD-এ সেট করা হলে, i-mobile SDK-এর জন্য বয়স সংক্রান্ত বিধিনিষেধের অনুরোধ ফিল্টার করুন।

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

  • Google Mobile Ads SDK ভার্সন 25.4.0.
  • Google Mobile Ads Next-Gen SDK ভার্সন 1.2.0.
  • IMobile SDK ভার্সন ২.৩.২।

ভার্সন ২.৩.২.৩

  • i-mobile SDK-এর জন্য বয়স সংক্রান্ত বিধিনিষেধযুক্ত অনুরোধ ফিল্টার করুন কারণ এটি বয়স সংক্রান্ত বিধিনিষেধযুক্ত সিগন্যাল গ্রহণ করতে পারে না।

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

  • Google Mobile Ads SDK ভার্সন ২৫.১.০।
  • Google Mobile Ads Next-Gen SDK ভার্সন ১.১.০।
  • IMobile SDK ভার্সন 2.3.2.

ভার্সন 2.3.2.2

  • GMA নেক্সট-জেন SDK ডিপেন্ডেন্সির সাথে অ্যাডাপ্টার তৈরি করার জন্য প্রপার্টি যোগ করা হয়েছে।
  • পুরনো API থেকে নতুন API-তে মাইগ্রেট করা ব্যানার, ইন্টারস্টিশিয়াল ও নেটিভ বিজ্ঞাপন ইমপ্লিমেন্টেশন।

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

  • Google Mobile Ads SDK ভার্সন ২৫.১.০।
  • IMobile SDK ভার্সন ২.৩.২।

ভার্সন 2.3.2.1

  • ন্যূনতম প্রয়োজনীয় Android API লেভেল আপডেট করে 23 করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 24.0.0 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন 24.0.0.
  • IMobile SDK ভার্সন ২.৩.২।

ভার্সন ২.৩.২.০

  • i-mobile SDK v2.3.2-এর সাথে মানানসই হিসেবে যাচাই করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন 23.1.0.
  • IMobile SDK ভার্সন 2.3.2.

ভার্সন 2.3.1.2

  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 23.0.0 করা হয়েছে।
  • i-mobile SDK v2.3.1-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন 23.0.0.
  • IMobile SDK ভার্সন 2.3.1.

ভার্সন ২.৩.১.১

  • নতুন VersionInfo ক্লাস ব্যবহার করার জন্য অ্যাডাপ্টার আপডেট করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 22.0.0 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন ২২.০.০।
  • IMobile SDK ভার্সন 2.3.1.

ভার্সন 2.3.1.0

  • i-mobile SDK v2.3.1-এর সাথে কম্প্যাটিবিলিটি যাচাই করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 21.5.0 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন 21.5.0.
  • IMobile SDK ভার্সন ২.৩.১।

ভার্সন 2.3.0.0

  • i-mobile SDK v2.3.0-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 21.3.0 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন 21.3.0.
  • IMobile SDK ভার্সন ২.৩.০।

ভার্সন 2.0.23.1

  • API 31-এ compileSdkVersion ও targetSdkVersion আপডেট করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 21.0.0 করা হয়েছে।
  • প্রয়োজনীয় ন্যূনতম Android API লেভেল আপডেট করে 19 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন ২১.০.০।
  • IMobile SDK ভার্সন 2.0.23.

ভার্সন 2.0.23.0

  • i-mobile SDK v2.0.23-এর সাথে মানানসই কিনা তা যাচাই করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 20.5.0 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন ২০.৫.০।
  • IMobile SDK ভার্সন 2.0.23।

ভার্সন 2.0.22.2

  • স্ট্যান্ডার্ডাইজড অ্যাডাপ্টার সংক্রান্ত সমস্যার কোড ও মেসেজ যোগ করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 20.1.0 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন ২০.১.০।
  • IMobile SDK ভার্সন ২.০.২২।

ভার্সন 2.0.22.1

  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 20.0.0 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন 20.0.0.
  • IMobile SDK ভার্সন 2.0.22.

ভার্সন 2.0.22.0

  • i-mobile SDK v2.0.22-এর সাথে মানানসই হিসেবে যাচাই করা হয়েছে।
  • ইনলাইন অ্যাডাপ্টিভ ব্যানার অনুরোধের ক্ষেত্রে কাজ করার জন্য অ্যাডাপ্টার আপডেট করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন 19.1.0.
  • IMobile SDK ভার্সন 2.0.22.

ভার্সন 2.0.21.0

  • i-mobile SDK v2.0.21-এর সাথে মানানসই হিসেবে যাচাই করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 19.1.0 করা হয়েছে।
  • অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপন স্কেল করার সুবিধা যোগ করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন ১৯.১.০।
  • IMobile SDK ভার্সন ২.০.২১।

ভার্সন 2.0.20.2

  • ফ্লেক্সিবল ব্যানার বিজ্ঞাপনের সাইজের জন্য সহায়তা যোগ করা হয়েছে।
  • Google Mobile Ads SDK-এর ন্যূনতম প্রয়োজনীয় ভার্সন আপডেট করে 18.3.0 করা হয়েছে।

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

  • Google Mobile Ads SDK ভার্সন ১৮.৩.০।
  • IMobile SDK ভার্সন 2.0.20.

ভার্সন 2.0.20.1

  • অ্যাডাপ্টার এখন শূন্য নয় এমন mediaContent অ্যাস্পেক্ট রেশিও দেখায়।

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

  • Google Mobile Ads SDK ভার্সন ১৮.২.০।
  • IMobile SDK ভার্সন 2.0.20.

ভার্সন 2.0.20.0

  • প্রারম্ভিক রিলিজ!
  • ব্যানার, ইন্টারস্টিশিয়াল ও নেটিভ বিজ্ঞাপনের জন্য সহায়তা যোগ করা হয়েছে।