এই নির্দেশিকাটি আপনাকে দেখায় যে কীভাবে জলপ্রপাতের একীকরণকে কভার করে মধ্যস্থতা ব্যবহার করে ironSource থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করতে হয়৷ এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে ironSource যোগ করতে হয় এবং কীভাবে ironSource SDK এবং অ্যাডাপ্টারকে Flutter অ্যাপে একীভূত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
ironSource-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
মিশ্রণ | |
---|---|
বিডিং | |
জলপ্রপাত | |
বিন্যাস | |
ব্যানার | |
কৌশলে | |
পুরস্কৃত | |
পুরস্কৃত ইন্টারস্টিশিয়াল |
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: ironSource UI এ কনফিগারেশন সেট আপ করুন
সাইন আপ করুন এবং আপনার ironSource অ্যাকাউন্টে সাইন ইন করুন ।
ironSource ড্যাশবোর্ডে আপনার অ্যাপ্লিকেশন যোগ করতে, নতুন অ্যাপ বোতামে ক্লিক করুন।
অ্যাপের বিবরণ লিখুন
লাইভ অ্যাপ নির্বাচন করুন, আপনার অ্যাপের URL লিখুন এবং অ্যাপের তথ্য আমদানিতে ক্লিক করুন।
আপনার অ্যাপটি উপলব্ধ না হলে, অ্যাপ্লিকেশন স্টোরে অ্যাপ নট লাইভ নির্বাচন করুন এবং আপনার অ্যাপের জন্য একটি অস্থায়ী নাম প্রদান করুন। আপনার প্ল্যাটফর্ম নির্বাচন করুন.
বাকি ফর্মটি পূরণ করুন এবং অ্যাপ যোগ করুন ক্লিক করুন।
আপনার নতুন APP KEY- এর নোট নিন, যা অ্যাপ যোগ করার পরে প্রদর্শিত হয়। আপনারAdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য আপনার এই মানটির প্রয়োজন হবে। আপনার অ্যাপ সমর্থন করে এমন বিজ্ঞাপন ফর্ম্যাটগুলি নির্বাচন করুন৷ তারপর Continue এ ক্লিক করুন।
অ্যান্ড্রয়েড
iOS
উদাহরণ তৈরি করুন
এরপরে, আপনার যোগ করা অ্যাপের জন্য একটি নেটওয়ার্ক ইনস্ট্যান্স কনফিগার করুন; ironSource পুরস্কৃত এবং ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য একাধিক নেটওয়ার্ক উদাহরণ সমর্থন করে।
বিজ্ঞাপন > সেটআপ > দৃষ্টান্তে নেভিগেট করুন। অ্যাপটি নির্বাচন করুন এবং ইনস্ট্যান্স তৈরি করুন ক্লিক করুন।
প্রয়োজনীয় বিবরণ লিখুন এবং সংরক্ষণ করুন এবং বন্ধ করুন ক্লিক করুন।
একবার ইন্সট্যান্স তৈরি হয়ে গেলে, ইনস্ট্যান্স আইডি ইনস্ট্যান্স আইডি ফিল্ডে তালিকাভুক্ত হয়।
APP KEY এবং ইনস্ট্যান্স আইডি ছাড়াও, আপনারAdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করতে আপনার ironSource সিক্রেট কী এবং রিফ্রেশ টোকেনের প্রয়োজন হবে৷
আপনার ironSource প্রকাশক ড্যাশবোর্ডে আমার অ্যাকাউন্টে নেভিগেট করুন তারপর API ট্যাবে ক্লিক করুন। আপনার গোপন কী নোট নিন এবং টোকেন রিফ্রেশ করুন ।
পরীক্ষা মোড চালু করুন
কিভাবে ironSource পরীক্ষার বিজ্ঞাপনগুলি সক্ষম করতে হয় সে সম্পর্কে ironSource-এর ইন্টিগ্রেশন টেস্টিং গাইডের নির্দেশাবলী অনুসরণ করুন৷
ধাপ 2: AdMob UI এ আয়রনসোর্স চাহিদা সেট আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য,Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য,iOS- এর জন্য গাইডের ধাপ 2 দেখুন।
ironSource Mobile যোগ করুন GDPR এবং US রাজ্যের প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায়
GDPR সেটিংসএবংইউএস স্টেট রেগুলেশন সেটিংসএ ধাপগুলি অনুসরণ করুন AdMob UI এ।
ধাপ 3: ironSource SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
(কেবল অ্যান্ড্রয়েড) আপনার প্রোজেক্টের android
ডিরেক্টরির ভিতরে build.gradle
ফাইলে নিম্নলিখিত সংগ্রহস্থলগুলি যোগ করুন:
repositories {
google()
mavenCentral()
maven {
url = uri("https://android-sdk.is.com/")
}
}
আপনার প্যাকেজের pubspec.yaml
ফাইলেironSource SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন:
dependencies:
gma_mediation_ironsource: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
ironSource এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি বের করুন এবং এক্সট্রাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রকল্পে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml
ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_ironsource:
path: path/to/local/package
ধাপ 4: ironSource SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতির অধীনে, আপনাকে নিশ্চিত করতে হবে যে ডিভাইস শনাক্তকারী এবং ব্যক্তিগত ডেটার ব্যবহার সম্পর্কিত ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ব্যবহারকারীদের নির্দিষ্ট কিছু প্রকাশ দেওয়া হয়েছে এবং তাদের কাছ থেকে সম্মতি নেওয়া হয়েছে। এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ সম্মতি চাওয়ার সময়, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত ডেটা সংগ্রহ, গ্রহণ বা ব্যবহার করতে পারে এবং প্রতিটি নেটওয়ার্কের ব্যবহার সম্পর্কে তথ্য প্রদান করতে পারে। Google বর্তমানে স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
ironSourceএর জন্য Google মোবাইল বিজ্ঞাপনের মধ্যস্থতা প্লাগইনটিতেMethod GmaMediationIronsource().SetConsent()
. নিম্নোক্ত নমুনা কোডটি দেখায় কিভাবে সম্মতির তথ্য ironSource SDK-এ পাঠাতে হয়। আপনি যদি এই পদ্ধতিতে কল করতে চান, তাহলে Google Mobile Ads SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়।
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
আরও বিশদ বিবরণের জন্য রেগুলেশন অ্যাডভান্সড সেটিংসে আয়রনসোর্সের ডকুমেন্টেশন দেখুন।
মার্কিন রাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দেওয়ার প্রয়োজন (যেমন আইন সেই শর্তগুলিকে সংজ্ঞায়িত করে), অপ্ট-আউট সহ "বিক্রয়" পার্টির হোমপেজে একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অফার করা হয়েছে। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
ironSourceএর জন্য Google মোবাইল বিজ্ঞাপনের মধ্যস্থতা প্লাগইনটিতেGmaMediationIronsource().setDoNotSell
নিম্নোক্ত নমুনা কোডটি দেখায় কিভাবে সম্মতির তথ্য ironSource SDK-এ পাঠাতে হয়। আইরনসোর্স SDK-তে সঠিকভাবে ফরোয়ার্ড করা নিশ্চিত করতে আপনি Google মোবাইল বিজ্ঞাপন SDK শুরু করার আগে এই বিকল্পগুলি অবশ্যই সেট করতে হবে৷
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
আরও বিশদ বিবরণের জন্য অ্যান্ড্রয়েড এবং iOS উভয়ের জন্য রেগুলেশন অ্যাডভান্সড সেটিংসের উপর ironSource এর ডকুমেন্টেশন দেখুন এবং পদ্ধতিতে যে মানগুলি প্রদান করা যেতে পারে।
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
প্রোগার্ড নিয়ম
আপনি যদি আপনার অ্যাপকে সঙ্কুচিত করেন, অস্পষ্ট করেন এবং অপ্টিমাইজ করেন , IronSource-এর আপনার প্রকল্পের জন্য অতিরিক্ত ProGuard নিয়ম প্রয়োজন।
আপনার প্রকল্পের জন্য কী কী ProGuard নিয়মগুলি প্রয়োজন সে সম্পর্কে আরও তথ্যের জন্য IronSource-এর Android SDK ইন্টিগ্রেশন গাইডের সাথে পরামর্শ করুন এবং সেই নিয়মগুলি আপনার proguard-user.txt
ফাইলে যোগ করুন৷
অ্যাপ্লিকেশন জীবনচক্র
আপনার প্রতিটি ক্রিয়াকলাপে onPause()
এবং onResume()
পদ্ধতিগুলিকে ওভাররাইড করুন নিম্নরূপ সংশ্লিষ্ট ironSource পদ্ধতিগুলিকে কল করতে:
জাভা
@Override
public void onResume() {
super.onResume();
IronSource.onResume(this);
}
@Override
public void onPause() {
super.onPause();
IronSource.onPause(this);
}
কোটলিন
public override fun onResume() {
super.onResume()
IronSource.onResume(this)
}
public override fun onPause() {
super.onPause()
IronSource.onPause(this)
}
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist
ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে IronSource এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ 6: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনিAdMob এর জন্য আপনার পরীক্ষার ডিভাইসটি নিবন্ধন করেছেন এবং ironSource UI-তে পরীক্ষা মোড সক্ষম করেছেন ৷
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনিironSourceথেকে পরীক্ষামূলক বিজ্ঞাপনগুলি পাচ্ছেন তা যাচাই করতে, ironSource (Waterfall) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টার ironSource থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo
ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
যখন একটি বিজ্ঞাপন লোড হতে ব্যর্থ হয় তখন ironSource অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
অ্যান্ড্রয়েড
ভুল সংকেত | কারণ |
---|---|
101 | AdMob UI এ কনফিগার করা ironSource সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
102 | ironSource তাদের SDK শুরু করার জন্য একটি কার্যকলাপের প্রসঙ্গ প্রয়োজন। |
103 | ironSource শুধুমাত্র ironSource ইনস্ট্যান্স আইডি প্রতি 1টি বিজ্ঞাপন লোড করতে পারে। |
105 | অনুরোধ করা ব্যানার বিজ্ঞাপন আকার ironSource দ্বারা সমর্থিত নয়. |
106 | ironSource SDK আরম্ভ করা হয়নি। |
501-1056 | ironSource SDK ত্রুটি। আরো বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন. |
iOS
ভুল সংকেত | কারণ |
---|---|
101 | AdMob UI এ কনফিগার করা ironSource সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
102 | ironSource অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন বিন্যাস সমর্থন করে না. |
103 | এই নেটওয়ার্ক কনফিগারেশনের জন্য একটি ironSource বিজ্ঞাপন ইতিমধ্যেই লোড করা হয়েছে৷ |
104 | অনুরোধ করা ব্যানার বিজ্ঞাপন আকার ironSource দ্বারা সমর্থিত নয়. |
508-1037 | ironSource SDK ত্রুটি। আরো বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন. |
ironSource Flutter Mediation Adapter Changelog
1.0.0
- প্রাথমিক মুক্তি।
- ironSource Android অ্যাডাপ্টার সংস্করণ 8.0.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- ironSource iOS অ্যাডাপ্টার সংস্করণ 8.0.0.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।