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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

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

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

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

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

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

আবশ্যকতা

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

• সর্বশেষ GMA Next-Gen SDK

• মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন

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

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

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

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

দ্রষ্টব্য: আই-মোবাইলকে আপনার নিবন্ধনের অনুমোদন দিতে হবে। একবার অনুমোদিত হলে, আপনি একটি বিজ্ঞাপন স্পট তৈরি করতে পারেন।

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

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

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

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

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

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

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

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

ধাপ ২: AdMob UI-তে i-mobile চাহিদা সেট আপ করুন

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

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

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, "মধ্যস্থতা" ট্যাবে যান। যদি আপনার কাছে এমন কোনও মধ্যস্থতা গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তাহলে সেই মধ্যস্থতা গ্রুপের নামে ক্লিক করে এটি সম্পাদনা করুন এবং "i-mobile as an ad source" এ যান।

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

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

আপনার মধ্যস্থতা গোষ্ঠীর একটি নাম দিন এবং লক্ষ্য করার জন্য অবস্থানগুলি নির্বাচন করুন। এরপর, মধ্যস্থতা গোষ্ঠীর স্থিতি সক্ষম করুন তে সেট করুন, এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন এ ক্লিক করুন।

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

এখন আপনার নির্বাচিত বিজ্ঞাপন ইউনিটগুলি দিয়ে বিজ্ঞাপন ইউনিট কার্ডটি পূর্ণ দেখতে পাবেন:

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

বিজ্ঞাপন উৎস বিভাগের ওয়াটারফল কার্ডের অধীনে, বিজ্ঞাপন উৎস যোগ করুন নির্বাচন করুন।

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

দ্রষ্টব্য : আপনাকে প্রতি নেটওয়ার্কে শুধুমাত্র একবার বিজ্ঞাপন উৎস অপ্টিমাইজেশন সেট আপ করতে হবে।

যদি আপনার ইতিমধ্যেই i-mobile এর জন্য একটি ম্যাপিং থাকে, তাহলে আপনি এটি নির্বাচন করতে পারেন। অন্যথায়, Add mapping এ ক্লিক করুন।

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

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

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

দ্রষ্টব্য: সামঞ্জস্যপূর্ণ আই-মোবাইল এবং GMA Next-Gen SDK সংস্করণগুলিকে একীভূত করতে ব্যর্থ হলে বিল্ড সমস্যা হতে পারে।

অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)

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

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

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

কার্যকলাপ প্রসঙ্গ সহ বিজ্ঞাপন লোড করুন

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

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

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

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

গুরুত্বপূর্ণ: আপনার অ্যাপ প্রকাশ করার আগে AdMob এবং i-mobile এর জন্য পরীক্ষা মোড অক্ষম করুন।

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

আপনি i-mobile থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, i-mobile (Waterfall) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।

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

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

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

আই-মোবাইল অ্যাডাপ্টারটি একটি NativeAd এর জন্য নিম্নলিখিত Native ads উন্নত ক্ষেত্র বিবরণ পূরণ করে।

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

^১. নেটিভ বিজ্ঞাপনের জন্য, 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 SDK একটি ত্রুটি ফেরত দিয়েছে। আরও বিস্তারিত জানার জন্য কোড দেখুন।
১০১	বিজ্ঞাপন লোড করার জন্য আই-মোবাইলের একটি Activity কনটেক্সট প্রয়োজন।
১০২	AdMob UI-তে কনফিগার করা i-mobile সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ।
১০৩	অনুরোধ করা বিজ্ঞাপনের আকার আই-মোবাইল সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৪	আই-মোবাইলের নেটিভ বিজ্ঞাপন লোড সফল কলব্যাকের ফলে একটি খালি নেটিভ বিজ্ঞাপন তালিকা ফিরে এসেছে।