মধ্যস্থতার সাথে আই-মোবাইলকে একীভূত করুন

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

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

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

আই-মোবাইলের মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
স্থানীয়

প্রয়োজনীয়তা

  • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি

ধাপ ১: আই-মোবাইল UI-তে কনফিগারেশন সেট আপ করুন।

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

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

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

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

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

বিজ্ঞাপন তৈরি করুন

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

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

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

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

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

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

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

আই-মোবাইলের জন্য app-ads.txt প্রয়োগ করতে, তাদের প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী দেখুন।

ধাপ ২: অ্যাড ম্যানেজার UI-তে i-mobile ডিমান্ড সেট আপ করুন।

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

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

ডেলিভারি > ইল্ড গ্রুপস- এ যান এবং নিউ ইল্ড গ্রুপ বোতামে ক্লিক করুন।

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

এরপর, 'Add yield partner' বাটনটিতে ক্লিক করুন।

আপনার যদি আগে থেকেই আই-মোবাইলের জন্য কোনো ইয়েল্ড পার্টনার থাকে, তাহলে আপনি তাকে নির্বাচন করতে পারেন। অন্যথায়, ‘একটি নতুন ইয়েল্ড পার্টনার তৈরি করুন ’ নির্বাচন করুন।

অ্যাড নেটওয়ার্ক হিসেবে আই-মোবাইল (i-mobile) নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন (Mediation ) সক্রিয় করুন।

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

Yield পার্টনার নির্বাচন করা হয়ে গেলে, ইন্টিগ্রেশন টাইপ হিসেবে Mobile SDK Mediation , প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে Active বেছে নিন। পূর্ববর্তী বিভাগে প্রাপ্ত Publisher ID , Media ID এবং Spot ID প্রবেশ করান। তারপর, একটি ডিফল্ট CPM ভ্যালু প্রবেশ করান।

কাজ শেষ হলে পৃষ্ঠার নীচে থাকা সেভ বাটনে ক্লিক করুন।

ধাপ ৩: আই-মোবাইল এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

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

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

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

কোটলিন

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

গ্রুভি

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

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

  1. i-mobile SDK- এর সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং android-ad-sdk.aar ফাইলটি sdk ফোল্ডারের অধীনে এক্সট্র্যাক্ট করে আপনার প্রজেক্টে যুক্ত করুন।

  2. গুগলের মেভেন রিপোজিটরিতে থাকা আই-মোবাইল অ্যাডাপ্টার আর্টিফ্যাক্টস -এ যান। সর্বশেষ সংস্করণটি নির্বাচন করুন, আই-মোবাইল অ্যাডাপ্টারের .aar ফাইলটি ডাউনলোড করুন এবং আপনার প্রজেক্টে যোগ করুন।

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

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

ব্যানার, ইন্টারস্টিশিয়াল, রিওয়ার্ডেড এবং নেটিভ অ্যাড ফরম্যাট লোড করার সময় Activity কনটেক্সট পাস করুন। অ্যাক্টিভিটি কনটেক্সট ছাড়া অ্যাড লোড ব্যর্থ হবে।

ধাপ ৫: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

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

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

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

ঐচ্ছিক পদক্ষেপ

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

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

আই-মোবাইল অ্যাডাপ্টারটি একটি NativeAd জন্য নিম্নলিখিত ফিল্ডগুলি পূরণ করে।

মাঠ আই-মোবাইল অ্যাডাপ্টারের সাথে সর্বদা অন্তর্ভুক্ত অ্যাসেটসমূহ
শিরোনাম
ছবি
শরীর
অ্যাপ আইকন
পদক্ষেপ গ্রহণের আহ্বান
তারকা রেটিং
দোকান
মূল্য

নেটিভ বিজ্ঞাপনের জন্য, আই-মোবাইল এসডিকে কোনো অ্যাপ আইকন অ্যাসেট প্রদান করে না। এর পরিবর্তে, আই-মোবাইল অ্যাডাপ্টার একটি স্বচ্ছ ছবি দিয়ে অ্যাপ আইকনটি পূরণ করে দেয়।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি আই-মোবাইল থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdapterResponses() ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

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

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন আই-মোবাইল অ্যাডাপ্টার থেকে প্রদর্শিত কোড এবং তার সাথে থাকা বার্তাগুলো নিচে দেওয়া হলো:

ত্রুটি কোড কারণ
০-৯৯ আই-মোবাইল এসডিকে একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে কোড দেখুন।
১০১ আই-মোবাইলে বিজ্ঞাপন লোড করার জন্য একটি Activity কনটেক্সট প্রয়োজন।
১০২ অ্যাড ম্যানেজার UI-তে কনফিগার করা i-mobile সার্ভার প্যারামিটারগুলো অনুপস্থিত/অবৈধ।
১০৩ অনুরোধ করা বিজ্ঞাপনের আকারটি আই-মোবাইল সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৪ আই-মোবাইলের নেটিভ বিজ্ঞাপন লোড সফল হওয়ার কলব্যাকটি একটি খালি নেটিভ বিজ্ঞাপনের তালিকা ফেরত দিয়েছে।

আই-মোবাইল অ্যান্ড্রয়েড মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

পরবর্তী সংস্করণ

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

সংস্করণ ২.৩.২.১

  • ন্যূনতম প্রয়োজনীয় অ্যান্ড্রয়েড এপিআই লেভেল ২৩-এ আপডেট করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে ভার্সন ২৪.০.০-তে আপডেট করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৪.০.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.৩.২।

সংস্করণ ২.৩.২.০

  • আই-মোবাইল এসডিকে ভি২.৩.২ এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৩.১.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.৩.২।

সংস্করণ ২.৩.১.২

  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ২৩.০.০-এ আপডেট করা হয়েছে।
  • আই-মোবাইল এসডিকে ভি২.৩.১ এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২৩.০.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.৩.১।

সংস্করণ ২.৩.১.১

  • নতুন VersionInfo ক্লাস ব্যবহার করার জন্য অ্যাডাপ্টারটি আপডেট করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ২২.০.০-এ আপডেট করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২২.০.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.৩.১।

সংস্করণ ২.৩.১.০

  • আই-মোবাইল এসডিকে ভি২.৩.১ এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ২১.৫.০-তে আপডেট করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২১.৫.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.৩.১।

সংস্করণ ২.৩.০.০

  • আই-মোবাইল এসডিকে ভি২.৩.০-এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ২১.৩.০-তে আপডেট করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২১.৩.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.৩.০।

সংস্করণ ২.০.২৩.১

  • compileSdkVersion এবং targetSdkVersion এপিআই ৩১-এ আপডেট করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ২১.০.০-এ আপডেট করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় অ্যান্ড্রয়েড এপিআই লেভেল ১৯-এ আপডেট করা হয়েছে।

যা দিয়ে তৈরি ও পরীক্ষা করা হয়েছে:

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২১.০.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.০.২৩।

সংস্করণ ২.০.২৩.০

  • আই-মোবাইল এসডিকে ভি২.০.২৩-এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ২০.৫.০-তে আপডেট করা হয়েছে।

নির্মিত এবং পরীক্ষিত

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২০.৫.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.০.২৩।

সংস্করণ ২.০.২২.২

  • প্রমিত অ্যাডাপ্টার ত্রুটি কোড এবং বার্তা যোগ করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ২০.১.০-তে আপডেট করা হয়েছে।

নির্মিত এবং পরীক্ষিত

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২০.১.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.০.২২।

সংস্করণ ২.০.২২.১

  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ ২০.০.০-এ আপডেট করা হয়েছে।

নির্মিত এবং পরীক্ষিত

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ২০.০.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.০.২২।

সংস্করণ ২.০.২২.০

  • আই-মোবাইল এসডিকে ভি২.০.২২ এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।
  • ইনলাইন অ্যাডাপ্টিভ ব্যানার অনুরোধ সমর্থন করার জন্য অ্যাডাপ্টারটি আপডেট করা হয়েছে।

নির্মিত এবং পরীক্ষিত

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৯.১.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.০.২২।

সংস্করণ ২.০.২১.০

  • আই-মোবাইল এসডিকে ভি২.০.২১ এর সাথে সামঞ্জস্যতা যাচাই করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে সংস্করণ 19.1.0-এ আপডেট করা হয়েছে।
  • অ্যাডাপ্টিভ ব্যানার বিজ্ঞাপন স্কেল করার সুবিধা যোগ করা হয়েছে।

নির্মিত এবং পরীক্ষিত

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৯.১.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.০.২১।

সংস্করণ ২.০.২০.২

  • নমনীয় ব্যানার বিজ্ঞাপনের আকারের সুবিধা যোগ করা হয়েছে।
  • ন্যূনতম প্রয়োজনীয় গুগল মোবাইল অ্যাডস এসডিকে ভার্সন ১৮.৩.০-তে আপডেট করা হয়েছে।

নির্মিত এবং পরীক্ষিত

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৮.৩.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.০.২০।

সংস্করণ ২.০.২০.১

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

নির্মিত এবং পরীক্ষিত

  • গুগল মোবাইল বিজ্ঞাপন এসডিকে সংস্করণ ১৮.২.০।
  • আইমোবাইল এসডিকে সংস্করণ ২.০.২০।

সংস্করণ ২.০.২০.০

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