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

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

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

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

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

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

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

পূর্বশর্ত

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

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

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

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

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

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

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

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

create_ad_spot

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

new_ad_spot_form

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

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-এর জন্য আপনার আগে থেকেই Yield পার্টনার থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, নতুন ইল্ড পার্টনার তৈরি করুন বিকল্প বেছে নিন।

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

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

Yield পার্টনার বেছে নেওয়া হয়ে গেলে, ইন্টিগ্রেশন ধরন হিসেবে মোবাইল 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.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.5.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'
}

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

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

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

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

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

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

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

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

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

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

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

i-mobile Android মধ্যস্থতা অ্যাডাপ্টার পরিবর্তনের লগ

ভার্সন 2.3.2.5

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

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

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

ভার্সন 2.3.2.3

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

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

  • Google Mobile Ads SDK ভার্সন 25.1.0.
  • Google Mobile Ads Next-Gen SDK ভার্সন 1.1.0.
  • IMobile SDK ভার্সন 2.3.2.

ভার্সন 2.3.2.2

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

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

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

ভার্সন 2.3.2.1

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

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

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

ভার্সন 2.3.2.0

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

ভার্সন 2.3.1.1

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

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

  • Google Mobile Ads SDK ভার্সন 22.0.0.
  • 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.1.

ভার্সন 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.3.0.

ভার্সন 2.0.23.1

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

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

  • Google Mobile Ads SDK ভার্সন 21.0.0.
  • 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 ভার্সন 20.5.0.
  • IMobile SDK ভার্সন 2.0.23.

ভার্সন 2.0.22.2

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

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

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

ভার্সন 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 ভার্সন 19.1.0.
  • IMobile SDK ভার্সন 2.0.21.

ভার্সন 2.0.20.2

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

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

  • Google Mobile Ads SDK ভার্সন 18.3.0.
  • IMobile SDK ভার্সন 2.0.20.

ভার্সন 2.0.20.1

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

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

  • Google Mobile Ads SDK ভার্সন 18.2.0.
  • IMobile SDK ভার্সন 2.0.20.

ভার্সন 2.0.20.0

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