এই নির্দেশিকাটি আপনাকে দেখায় যে কীভাবে জলপ্রপাতের একীকরণকে কভার করে মধ্যস্থতা ব্যবহার করে ironSource বিজ্ঞাপনগুলি থেকে বিজ্ঞাপনগুলি লোড এবং প্রদর্শন করতে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করতে হয়৷ এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে ironSource বিজ্ঞাপনগুলি যোগ করতে হয় এবং কীভাবে ironSource Ads SDK এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপে সংহত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
ironSource বিজ্ঞাপনের জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
মিশ্রণ | |
---|---|
বিডিং | 1 |
জলপ্রপাত | |
বিন্যাস | |
ব্যানার | 2 |
কৌশলে | |
পুরস্কৃত | |
পুরস্কৃত ইন্টারস্টিশিয়াল | 2 |
1 বিডিং ইন্টিগ্রেশন বন্ধ বিটাতে রয়েছে, অ্যাক্সেসের অনুরোধ করতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।
2 এই বিন্যাসটি শুধুমাত্র জলপ্রপাত একীকরণে সমর্থিত।
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: ironSource Ads UI এ কনফিগারেশন সেট আপ করুন
সাইন আপ করুন এবং আপনার ironSource বিজ্ঞাপন অ্যাকাউন্টে সাইন ইন করুন ।
ironSource Ads ড্যাশবোর্ডে আপনার অ্যাপ্লিকেশন যোগ করতে, নতুন অ্যাপ বোতামে ক্লিক করুন।
অ্যাপের বিবরণ লিখুন
লাইভ অ্যাপ নির্বাচন করুন, আপনার অ্যাপের URL লিখুন এবং অ্যাপের তথ্য আমদানিতে ক্লিক করুন।
আপনার অ্যাপটি উপলব্ধ না হলে, অ্যাপ্লিকেশন স্টোরে অ্যাপ নট লাইভ নির্বাচন করুন এবং আপনার অ্যাপের জন্য একটি অস্থায়ী নাম প্রদান করুন। আপনার প্ল্যাটফর্ম নির্বাচন করুন.
বাকি ফর্মটি পূরণ করুন এবং অ্যাপ যোগ করুন ক্লিক করুন।
আপনার নতুন অ্যাপ কী নোট করুন, যা অ্যাপ যোগ করার পরে প্রদর্শিত হয়। আপনারAdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য আপনার এই মানটির প্রয়োজন হবে। আপনার অ্যাপ সমর্থন করে এমন বিজ্ঞাপন ফর্ম্যাটগুলি নির্বাচন করুন৷ তারপর Continue এ ক্লিক করুন।
অ্যান্ড্রয়েড
iOS
উদাহরণ তৈরি করুন
এরপরে, আপনার যোগ করা অ্যাপের জন্য একটি নেটওয়ার্ক ইনস্ট্যান্স কনফিগার করুন।
বিডিং
LevelPlay > সেটআপ > SDK নেটওয়ার্কে নেভিগেট করুন, তারপর আপনার অ্যাপ নির্বাচন করুন। বিডিংয়ের অধীনে, বিডিং ইনস্ট্যান্স আইডি দেখতে সম্পাদনা আইকনে ক্লিক করুন।
অ্যান্ড্রয়েড
iOS
ইনস্ট্যান্স আইডি নোট নিন।
অ্যান্ড্রয়েড
iOS
জলপ্রপাত
বিজ্ঞাপন > সেটআপ > দৃষ্টান্তে নেভিগেট করুন। অ্যাপটি নির্বাচন করুন এবং ইনস্ট্যান্স তৈরি করুন ক্লিক করুন।
প্রয়োজনীয় বিবরণ লিখুন এবং সংরক্ষণ করুন এবং বন্ধ করুন ক্লিক করুন।
একবার ইন্সট্যান্স তৈরি হয়ে গেলে, ইনস্ট্যান্স আইডি ইনস্ট্যান্স আইডি ফিল্ডে তালিকাভুক্ত হয়।
আপনার রিপোর্টিং API কী সনাক্ত করুন৷
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপের প্রয়োজন নেই।
জলপ্রপাত
অ্যাপ কী এবং ইনস্ট্যান্স আইডি ছাড়াও, আপনারAdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য আপনার ironSource Ads Secret Key এবং Refresh Token- এরও প্রয়োজন হবে।
আপনার ironSource বিজ্ঞাপন প্রকাশক ড্যাশবোর্ডে আমার অ্যাকাউন্টে নেভিগেট করুন তারপর API ট্যাবে ক্লিক করুন। আপনার গোপন কী নোট নিন এবং টোকেন রিফ্রেশ করুন ।
পরীক্ষা মোড চালু করুন
কিভাবে ironSource বিজ্ঞাপন পরীক্ষা বিজ্ঞাপনগুলি সক্ষম করতে হয় সে সম্পর্কে ironSource Ads এর ইন্টিগ্রেশন টেস্টিং গাইডের নির্দেশাবলী অনুসরণ করুন৷
ধাপ 2: AdMob UI এ ironSource বিজ্ঞাপনের চাহিদা সেট আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য,Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য,iOS- এর জন্য গাইডের ধাপ 2 দেখুন।
ironSource Mobile যোগ করুন GDPR এবং US রাজ্যের প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায়
GDPR সেটিংসএবংইউএস স্টেট রেগুলেশন সেটিংসএ ধাপগুলি অনুসরণ করুন AdMob UI এ।
ধাপ 3: ironSource Ads 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 Ads SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতির অধীনে, আপনাকে নিশ্চিত করতে হবে যে ডিভাইস শনাক্তকারী এবং ব্যক্তিগত ডেটার ব্যবহার সম্পর্কিত ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ব্যবহারকারীদের নির্দিষ্ট কিছু প্রকাশ দেওয়া হয়েছে এবং তাদের কাছ থেকে সম্মতি নেওয়া হয়েছে। এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ সম্মতি চাওয়ার সময়, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত ডেটা সংগ্রহ, গ্রহণ বা ব্যবহার করতে পারে এবং প্রতিটি নেটওয়ার্কের ব্যবহার সম্পর্কে তথ্য প্রদান করতে পারে। Google বর্তমানে স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
ironSource Adsএর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন-এGmaMediationSetholder184Method GmaMediationIronsource().SetConsent()
নিম্নোক্ত নমুনা কোডটি দেখায় কিভাবে ironSource Ads SDK-এ সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই পদ্ধতিতে কল করতে চান, তাহলে Google Mobile Ads SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়।
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setConsent(true);
আরও বিশদ বিবরণের জন্য রেগুলেশন অ্যাডভান্সড সেটিংসে ironSource বিজ্ঞাপনের ডকুমেন্টেশন দেখুন।
মার্কিন রাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দেওয়ার প্রয়োজন (যেমন আইন সেই শর্তাদি সংজ্ঞায়িত করে), অপ্ট-আউট সহ "বিক্রয়" পার্টির হোমপেজে একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অফার করা হয়েছে। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
ironSource Adsএর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন-এGmaMediationIronsource().setDoNotSell
. নিম্নোক্ত নমুনা কোডটি দেখায় কিভাবে ironSource Ads SDK-এ সম্মতির তথ্য পাঠাতে হয়। আইরনসোর্স বিজ্ঞাপন SDK-তে সঠিকভাবে ফরওয়ার্ড করা হয়েছে তা নিশ্চিত করার জন্য আপনি Google মোবাইল বিজ্ঞাপন SDK শুরু করার আগে এই বিকল্পগুলি অবশ্যই সেট করতে হবে৷
import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...
GmaMediationIronsource().setDoNotSell(true);
আরও বিশদ বিবরণের জন্য এবং পদ্ধতিতে প্রদান করা যেতে পারে এমন মানগুলির জন্য অ্যান্ড্রয়েড এবং আইওএস উভয়ের জন্য রেগুলেশন অ্যাডভান্সড সেটিংসে ironSource বিজ্ঞাপনের ডকুমেন্টেশন দেখুন৷
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
প্রোগার্ড নিয়ম
আপনি যদি আপনার অ্যাপ সঙ্কুচিত, অস্পষ্ট এবং অপ্টিমাইজ করেন , তাহলে IronSource বিজ্ঞাপনের জন্য আপনার প্রকল্পের জন্য অতিরিক্ত ProGuard নিয়ম প্রয়োজন।
আপনার প্রকল্পের জন্য কী কী ProGuard নিয়মগুলি প্রয়োজন সে সম্পর্কে আরও তথ্যের জন্য IronSource Ads-এর Android SDK ইন্টিগ্রেশন গাইডের সাথে পরামর্শ করুন এবং সেই নিয়মগুলি আপনার proguard-user.txt
ফাইলে যোগ করুন৷
অ্যাপ্লিকেশন জীবনচক্র
অনুরূপ আয়রনসোর্স বিজ্ঞাপন পদ্ধতিগুলিকে নিম্নরূপ কল করতে আপনার প্রতিটি ক্রিয়াকলাপে onPause()
এবং onResume()
পদ্ধতিগুলিকে ওভাররাইড করুন:
জাভা
@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 Ads (Waterfall) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টার ironSource বিজ্ঞাপন থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo
ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter
iOS
GADMAdapterIronSource
GADMAdapterIronSourceRewarded
যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয় তখন ironSource Ads অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
অ্যান্ড্রয়েড
ভুল সংকেত | কারণ |
---|---|
101 | AdMob UI-তে কনফিগার করা ironSource বিজ্ঞাপন সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
102 | ironSource বিজ্ঞাপনগুলির SDK শুরু করার জন্য একটি কার্যকলাপের প্রসঙ্গ প্রয়োজন। |
103 | ironSource বিজ্ঞাপন প্রতি ironSource ইনস্ট্যান্স আইডিতে শুধুমাত্র 1টি বিজ্ঞাপন লোড করতে পারে। |
105 | অনুরোধ করা ব্যানার বিজ্ঞাপন আকার ironSource বিজ্ঞাপন দ্বারা সমর্থিত নয়. |
106 | ironSource Ads 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 দিয়ে তৈরি এবং পরীক্ষিত।