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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

আপনার অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে আই-মোবাইল যোগ করতে হবে।

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

নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, ‘মধ্যস্থতা গোষ্ঠী তৈরি করুন’ নির্বাচন করুন।

আপনার বিজ্ঞাপনের ধরণ ও প্ল্যাটফর্ম লিখুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

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

এই মিডিয়েশন গ্রুপটিকে আপনার বিদ্যমান এক বা একাধিক AdMob অ্যাড ইউনিটের সাথে যুক্ত করুন। তারপর 'Done'-এ ক্লিক করুন।

এখন আপনি অ্যাড ইউনিট কার্ডটিতে আপনার নির্বাচিত অ্যাড ইউনিটগুলো দেখতে পাবেন:

বিজ্ঞাপনের উৎস হিসেবে আই-মোবাইল যোগ করুন


Ad Sources সেকশনের Waterfall কার্ডের অধীনে, Add Ad Source নির্বাচন করুন।

আই-মোবাইল নির্বাচন করুন এবং অপটিমাইজ সুইচটি চালু করুন। আই-মোবাইলের জন্য বিজ্ঞাপন উৎস অপটিমাইজেশন সেট আপ করতে পূর্ববর্তী বিভাগে প্রাপ্ত লগইন নাম এবং এপিআই পাসওয়ার্ড লিখুন। তারপর আই-মোবাইলের জন্য একটি eCPM মান লিখুন এবং 'চালিয়ে যান' (Continue) এ ক্লিক করুন।



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

এরপর, পূর্ববর্তী ধাপে প্রাপ্ত পাবলিশার আইডি , মিডিয়া আইডি এবং স্পট আইডি প্রবেশ করান। তারপর 'Done' বাটনে ক্লিক করুন।

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

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

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

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

কোটলিন

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:imobile:2.3.2.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

গ্রুভি

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:imobile:2.3.2.1'
}

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- এর সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং android-ad-sdk.aar ফাইলটি sdk ফোল্ডারের অধীনে এক্সট্র্যাক্ট করে আপনার প্রজেক্টে যুক্ত করুন।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ত্রুটি কোড

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

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

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

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