মধ্যস্থতার সাথে মায়োকে একীভূত করুন

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

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

maio-এর ড্যাশবোর্ড ইন্টারফেসটি তার লেবেল, বোতাম এবং বর্ণনার জন্য জাপানি টেক্সট ব্যবহার করে এবং এই নির্দেশিকার স্ক্রিনশটগুলি অনুবাদ করা হয়নি। তবে এই নির্দেশিকার বর্ণনা এবং নির্দেশাবলীতে, লেবেল এবং বোতামগুলিকে তাদের ইংরেজি ভাষার সমতুল্য হিসাবে উল্লেখ করা হয়েছে। উদাহরণস্বরূপ, "URL スキーム" হল "URL Scheme"।

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

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

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

আবশ্যকতা

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

• maio SDK 1.0.7 বা উচ্চতর

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

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

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

প্রথমে, আপনার maio অ্যাকাউন্টে সাইন আপ করুন অথবা লগ ইন করুন । বাম সাইডবারে অ্যাপ্লিকেশন ব্যবস্থাপনা বোতামে ক্লিক করুন এবং নতুন অ্যাপে ক্লিক করুন।

আপনার পছন্দের বিজ্ঞাপনের ধরণের সাথে সম্পর্কিত ট্যাবটি নির্বাচন করুন।

ইন্টারস্টিশিয়াল

আপনার অ্যাপের নাম লিখুন, প্ল্যাটফর্মটি নির্বাচন করুন এবং আপনার অ্যাপের URL প্রদান করুন। বিজ্ঞাপনের ধরণ হিসেবে ভিডিও ইন্টারস্টিশিয়াল নির্বাচন করুন, এবং তারপর আপডেট ক্লিক করুন।

দ্রষ্টব্য: maio থেকে ইন্টারস্টিশিয়াল বিজ্ঞাপনগুলি ডিফল্টরূপে এড়িয়ে যাওয়া যায়।

পুরস্কৃত

আপনার অ্যাপের নাম লিখুন, প্ল্যাটফর্মটি নির্বাচন করুন এবং আপনার অ্যাপের URL প্রদান করুন। বিজ্ঞাপনের ধরণ হিসেবে ভিডিও রিওয়ার্ডস নির্বাচন করুন, এবং তারপর আপডেট ক্লিক করুন।

দ্রষ্টব্য: maio থেকে পুরস্কৃত ভিডিও বিজ্ঞাপনগুলি ডিফল্টরূপে এড়িয়ে যাওয়া যায় না ।

অ্যাপ্লিকেশন ম্যানেজমেন্ট পৃষ্ঠায়, মিডিয়া আইডিটি নোট করুন। পরবর্তী বিভাগে আপনার AdMob বিজ্ঞাপন ইউনিট সেট আপ করার জন্য এটি প্রয়োজন।

জোন ম্যানেজমেন্ট পৃষ্ঠায়, জোন আইডিটি নোট করুন। পরবর্তী বিভাগে আপনার অ্যাডমব বিজ্ঞাপন ইউনিট সেট আপ করার জন্যও এটির প্রয়োজন হবে।

মিডিয়া আইডি এবং জোন আইডি ছাড়াও, আপনার বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য API আইডি এবং API KEY এর প্রয়োজন হবে। রিপোর্টিং API পৃষ্ঠায় , API আইডি এবং API KEY এর একটি নোট তৈরি করুন।

দ্রষ্টব্য: যদি আপনি প্রথমবারের মতো আপনার maio অ্যাকাউন্ট সেট আপ করেন, তাহলে আপনার API ID এবং API KEY ইস্যু করার জন্য আপনাকে maio এর সহায়তা দলের সাথে যোগাযোগ করতে হতে পারে।

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

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

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

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, "মধ্যস্থতা" ট্যাবে যান। যদি আপনার কাছে এমন কোনও মধ্যস্থতা গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তাহলে সেই মধ্যস্থতা গ্রুপের নামে ক্লিক করে এটি সম্পাদনা করুন এবং "মধ্যস্থতা গ্রুপকে বিজ্ঞাপন উৎস হিসেবে যোগ করুন" এ যান ।

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

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

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

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

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

বিজ্ঞাপনের উৎস হিসেবে maio যোগ করুন

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

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

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

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

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

গুরুত্বপূর্ণ : মিডিয়া আইডি অবশ্যই maio UI-এর মতো লক্ষ্যযুক্ত অ্যাপের সাথে যুক্ত থাকতে হবে।

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

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

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

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

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

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

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

কোটলিন

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03")
    implementation("com.google.ads.mediation:maio:2.0.8.0")
}

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:maio:2.0.8.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

মায়ো অ্যান্ড্রয়েড ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।

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

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

আপনার টেস্ট ডিভাইসটি AdMob-এর জন্য নিবন্ধন করুন ।

GMA Next-Gen SDK এর ১১.৬.০ বা তার বেশি সংস্করণ ব্যবহারকারী প্রকাশকরা অনুরোধ করার সময় টেস্ট ডিভাইস হিসেবে নিবন্ধিত ফোন এবং ট্যাবলেটে স্বয়ংক্রিয়ভাবে maio থেকে পরীক্ষামূলক বিজ্ঞাপন পাবেন।

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

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

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

ত্রুটি কোড

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

বিন্যাস	ক্লাসের নাম
ইন্টারস্টিশিয়াল	jp.maio.sdk.android.mediation.admob.adapter.Interstitial সম্পর্কে
পুরস্কৃত	jp.maio.sdk.android.mediation.admob.adapter.পুরস্কৃত

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

ত্রুটি কোড	কারণ
০-১০	maio একটি SDK-নির্দিষ্ট ত্রুটি ফেরত দিয়েছে। আরও বিস্তারিত জানার জন্য কোড এবং maio এর ডকুমেন্টেশন দেখুন।
১০১	মাইওর কোনও বিজ্ঞাপন নেই।
১০২	ভুল সার্ভার প্যারামিটার (যেমন প্লেসমেন্ট আইডি অনুপস্থিত)।
১০৩	বিজ্ঞাপন লোড করার জন্য ব্যবহৃত প্রসঙ্গটি ``কার্যকলাপ'' উদাহরণ ছিল না।