এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে AdMob Mediation ব্যবহার করে ironSource Ads থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে GMA Next-Gen SDK ব্যবহার করতে হয়, যা ওয়াটারফল ইন্টিগ্রেশনগুলিকে অন্তর্ভুক্ত করে। এটি একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে ironSource Ads কীভাবে যুক্ত করতে হয়, কীভাবে বিজ্ঞাপন সোর্স অপ্টিমাইজেশন সেট আপ করতে হয় এবং কীভাবে আপনার অ্যান্ড্রয়েড অ্যাপে ironSource Ads SDK এবং অ্যাডাপ্টার সংহত করতে হয় তা কভার করে।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
ironSource Ads-এর জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | ১ |
| স্থানীয় | |
১ এই ফর্ম্যাটটি শুধুমাত্র জলপ্রপাত ইন্টিগ্রেশনে সমর্থিত।
আবশ্যকতা
- অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি
- [বিডিংয়ের জন্য]: বিডিংয়ে সমস্ত সমর্থিত বিজ্ঞাপন ফর্ম্যাট একীভূত করতে, IronSource অ্যাডাপ্টার 8.5.0.1 বা উচ্চতর ( সর্বশেষ সংস্করণ প্রস্তাবিত ) ব্যবহার করুন।
সর্বশেষ GMA Next-Gen SDK ।
মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন।
ধাপ ১: ironSource Ads UI-তে কনফিগারেশন সেট আপ করুন
সাইন আপ করুন এবং আপনার ironSource বিজ্ঞাপন অ্যাকাউন্টে সাইন ইন করুন ।
একটি নতুন অ্যাপ যোগ করুন
নতুন অ্যাপ যোগ করতে, বিজ্ঞাপন > অ্যাপে যান এবং অ্যাপ যোগ করুন এ ক্লিক করুন।

ফর্মটি পূরণ করুন এবং অ্যাপ যোগ করুন এ ক্লিক করুন।

অ্যাপ কীটি লক্ষ্য করুন, তারপর আপনার অ্যাপ যে বিজ্ঞাপন ফর্ম্যাটগুলি সমর্থন করে তা নির্বাচন করুন এবং চালিয়ে যান ক্লিক করুন।

একটি উদাহরণ তৈরি করুন
এরপর, আপনার যোগ করা অ্যাপটির জন্য একটি উদাহরণ কনফিগার করুন।
বিজ্ঞাপন > সেটআপ > ইনস্ট্যান্স এ নেভিগেট করুন। অ্যাপটি নির্বাচন করুন এবং Create instance এ ক্লিক করুন।

বিডিং
ফর্মটি পূরণ করুন এবং মূল্য নির্ধারণের জন্য বিডিং নির্বাচন করুন। সংরক্ষণ করুন এবং বন্ধ করুন এ ক্লিক করুন।

ইনস্ট্যান্স আইডিটি লক্ষ্য করুন।

জলপ্রপাত
ফর্মটি পূরণ করুন এবং সংরক্ষণ করুন এবং বন্ধ করুন এ ক্লিক করুন।

ইনস্ট্যান্স আইডিটি লক্ষ্য করুন।

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

আপনার app-ads.txt আপডেট করুন
অ্যাপসের জন্য অনুমোদিত বিক্রেতারা app-ads.txt হল একটি IAB টেক ল্যাব উদ্যোগ যা নিশ্চিত করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেন্টরি কেবলমাত্র সেই চ্যানেলগুলির মাধ্যমে বিক্রি করা হচ্ছে যেগুলি আপনি অনুমোদিত হিসাবে চিহ্নিত করেছেন। বিজ্ঞাপনের আয়ের উল্লেখযোগ্য ক্ষতি রোধ করতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। যদি আপনি ইতিমধ্যে এটি না করে থাকেন, তাহলে আপনার অ্যাপের জন্য একটি app-ads.txt ফাইল সেট আপ করুন ।
ironSource-এর জন্য app-ads.txt বাস্তবায়ন করতে, ironSource অনুমোদিত রিসেলার দেখুন।
পরীক্ষা মোড চালু করুন
ironSource Ads পরীক্ষার বিজ্ঞাপনগুলি কীভাবে সক্ষম করবেন সে সম্পর্কে ironSource Ads এর ইন্টিগ্রেশন টেস্টিং গাইডের নির্দেশাবলী অনুসরণ করুন।
ধাপ ২: AdMob UI-তে ironSource বিজ্ঞাপনের চাহিদা সেট আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
আপনার বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে ironSource বিজ্ঞাপন যোগ করতে হবে।
প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, "মধ্যস্থতা" ট্যাবে যান। যদি আপনার কাছে এমন কোনও মধ্যস্থতা গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তাহলে সেই মধ্যস্থতা গ্রুপের নামে ক্লিক করে এটি সম্পাদনা করুন এবং "আয়রনসোর্স বিজ্ঞাপনগুলিকে বিজ্ঞাপন উৎস হিসেবে যোগ করুন" এ যান ।
একটি নতুন মধ্যস্থতা গ্রুপ তৈরি করতে, মধ্যস্থতা গ্রুপ তৈরি করুন নির্বাচন করুন।

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

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

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

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

বিজ্ঞাপন উৎস হিসেবে ironSource বিজ্ঞাপন যোগ করুন
বিডিং
বিজ্ঞাপন উৎস বিভাগের বিডিং কার্ডের অধীনে, বিজ্ঞাপন উৎস যোগ করুন নির্বাচন করুন। তারপর ironSource বিজ্ঞাপন নির্বাচন করুন।
"কীভাবে একটি অংশীদারিত্ব চুক্তি স্বাক্ষর করবেন" এ ক্লিক করুন এবং ironSource Ads এর সাথে একটি বিডিং অংশীদারিত্ব স্থাপন করুন ।

Acknowledge & agree এ ক্লিক করুন, তারপর Continue এ ক্লিক করুন।

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

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

জলপ্রপাত
বিজ্ঞাপন উৎস বিভাগের ওয়াটারফল কার্ডের অধীনে, বিজ্ঞাপন উৎস যোগ করুন নির্বাচন করুন।
ironSource Ads নির্বাচন করুন এবং Optimize সুইচটি সক্রিয় করুন। ironSource Ads এর জন্য বিজ্ঞাপন সোর্স অপ্টিমাইজেশন সেট আপ করতে পূর্ববর্তী বিভাগে প্রাপ্ত সিক্রেট কী এবং রিফ্রেশ টোকেনটি প্রবেশ করান। তারপর ironSource Ads এর জন্য একটি eCPM মান প্রবেশ করান এবং Continue এ ক্লিক করুন।

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

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

জিডিপিআর এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালার বিজ্ঞাপন অংশীদারদের তালিকায় আয়রনসোর্স মোবাইল যোগ করুন
AdMob UI-তে ইউরোপীয় এবং মার্কিন যুক্তরাষ্ট্রের রাজ্যের নিয়মাবলীর বিজ্ঞাপন অংশীদারদের তালিকায় ironSource Mobile যোগ করতে ইউরোপীয় নিয়মাবলী সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের রাজ্যের নিয়মাবলী সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ ৩: ironSource Ads SDK এবং অ্যাডাপ্টার আমদানি করুন
অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)
আপনার প্রজেক্ট-লেভেল settings.gradle.kts ফাইলে, নিম্নলিখিত সংগ্রহস্থলগুলি যোগ করুন:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
}
আপনার অ্যাপ-লেভেল গ্রেডল ফাইলে, নিম্নলিখিত বাস্তবায়ন নির্ভরতা এবং কনফিগারেশন যোগ করুন:
কোটলিন
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03") implementation("com.google.ads.mediation:ironsource:9.3.0.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:ironsource:9.3.0.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
ম্যানুয়াল ইন্টিগ্রেশন
ironSource Ads Android SDK এর সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং এটি আপনার প্রকল্পে যুক্ত করুন।
গুগলের ম্যাভেন রিপোজিটরিতে ironSource Ads অ্যাডাপ্টার আর্টিফ্যাক্টগুলিতে নেভিগেট করুন। সর্বশেষ সংস্করণটি নির্বাচন করুন, IronSource অ্যাডাপ্টারের
.aarফাইলটি ডাউনলোড করুন এবং এটি আপনার প্রকল্পে যুক্ত করুন।
ধাপ ৪: ironSource Ads SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডের ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং আইনত প্রয়োজনে কুকিজ বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, ভাগ করে নেওয়া এবং ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণ (GDPR) এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে। আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পাঠানো হয়েছে কিনা তা যাচাই করার জন্য আপনার দায়িত্ব। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতি পছন্দ প্রেরণ করতে অক্ষম।
ironSource SDK সংস্করণ 7.7.0 থেকে শুরু করে, ironSource স্বয়ংক্রিয়ভাবে Google এর অতিরিক্ত সম্মতি স্পেসিফিকেশন সমর্থনকারী সম্মতি ব্যবস্থাপনা প্ল্যাটফর্মগুলির দ্বারা সেট করা GDPR সম্মতি পড়ে, যার মধ্যে UMP SDKও অন্তর্ভুক্ত। আরও তথ্যের জন্য, Google UMP এবং Google এর অতিরিক্ত সম্মতি সমর্থনকারী CMP গুলির জন্য সমর্থন দেখুন।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন অনুসারে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" (যেমন আইন এই শর্তাবলী সংজ্ঞায়িত করে) "বিক্রয়" থেকে বেরিয়ে আসার অধিকার দেওয়া হয়, যেখানে "বিক্রয়কারী" পক্ষের হোমপেজে "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউট করার সুযোগ দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন সম্মতি নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে অক্ষম। অতএব, আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্ক চিহ্নিত করতে হবে যারা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই প্রতিটি নেটওয়ার্কের নির্দেশিকা অনুসরণ করতে হবে।
SDK ভার্সন 6.14.0-এ, ironSource Ads CCPA রেগুলেশন সমর্থন করার জন্য একটি API যোগ করেছে। নিম্নলিখিত নমুনা কোডটি দেখায় যে কীভাবে এই সম্মতি তথ্য ironSource Ads SDK-তে পাঠানো হয়। GMA Next-Gen SDK চালু করার আগে এই বিকল্পগুলি সেট করতে হবে যাতে সেগুলি ironSource Ads SDK-তে সঠিকভাবে ফরোয়ার্ড করা যায়।
জাভা
LevelPlay.setMetaData("do_not_sell", "true");
কোটলিন
LevelPlay.setMetaData("do_not_sell", "true")
আরও বিস্তারিত জানার জন্য এবং পদ্ধতিতে কী কী মান দেওয়া যেতে পারে তার জন্য ironSource Ads-এর রেগুলেশন অ্যাডভান্সড সেটিংস- এর ডকুমেন্টেশন দেখুন।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
কার্যকলাপের প্রসঙ্গ সহ বিজ্ঞাপন লোড করুন
ব্যানার, ইন্টারস্টিশিয়াল এবং পুরস্কৃত বিজ্ঞাপন ফর্ম্যাট লোড করার সময় Activity কনটেক্সট পাস করুন। অ্যাক্টিভিটি কনটেক্সট ছাড়া, বিজ্ঞাপন লোড ব্যর্থ হবে।
প্রোগার্ড নিয়ম
যদি আপনি আপনার অ্যাপটি সঙ্কুচিত, অস্পষ্ট এবং অপ্টিমাইজ করেন , তাহলে ironSource Ads আপনার প্রোজেক্টে অতিরিক্ত ProGuard নিয়ম প্রয়োজন করে। আরও তথ্যের জন্য ironSource Ads এর Android SDK ইন্টিগ্রেশন গাইড দেখুন।
ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষামূলক বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনি AdMob-এর জন্য আপনার পরীক্ষামূলক ডিভাইসটি নিবন্ধন করেছেন এবং ironSource Ads UI-তে পরীক্ষামূলক মোড সক্ষম করেছেন ।
পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন
আপনি ironSource Ads থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, ironSource Ads (বিডিং) এবং ironSource Ads (ওয়াটারফল) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক বিভাগে একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টারটি ironSource Ads থেকে কোনও বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdSourceResponses() ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
কোনও বিজ্ঞাপন লোড না হলে ironSource Ads অ্যাডাপ্টার দ্বারা প্রেরিত কোড এবং তার সাথে থাকা বার্তাগুলি এখানে দেওয়া হল:
| ত্রুটি কোড | কারণ |
|---|---|
| ১০১ | AdMob UI-তে কনফিগার করা ironSource Ads সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ। |
| ১০২ | ironSource Ads-এর SDK আরম্ভ করার জন্য একটি কার্যকলাপ প্রসঙ্গ প্রয়োজন। |
| ১০৩ | ironSource Ads প্রতি ironSource Ads ইনস্ট্যান্স আইডিতে কেবল ১টি বিজ্ঞাপন লোড করতে পারে। |
| ১০৫ | অনুরোধকৃত ব্যানার বিজ্ঞাপনের আকার ironSource Ads দ্বারা সমর্থিত নয়। |
| ১০৬ | ironSource Ads SDK আরম্ভ করা হয়নি। |
| ৫০১-১০৫৬ | ironSource বিজ্ঞাপন SDK ত্রুটি। আরও বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন। |