মধ্যস্থতার সাথে ironSource বিজ্ঞাপনগুলিকে একীভূত করুন৷

এই নির্দেশিকাটি আপনাকে দেখায় যে কীভাবে জলপ্রপাতের একীকরণকে কভার করে মধ্যস্থতা ব্যবহার করে 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-এর সাথে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
  • মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড

ধাপ 1: ironSource Ads UI এ কনফিগারেশন সেট আপ করুন

সাইন আপ করুন এবং আপনার ironSource বিজ্ঞাপন অ্যাকাউন্টে সাইন ইন করুন ।

একটি নতুন অ্যাপ যোগ করুন

একটি নতুন অ্যাপ যোগ করতে, বিজ্ঞাপন > অ্যাপ- এ নেভিগেট করুন এবং অ্যাপ যোগ করুন-এ ক্লিক করুন।

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

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

অ্যান্ড্রয়েড iOS

একটি উদাহরণ তৈরি করুন

এরপরে, আপনি যে অ্যাপটি যোগ করেছেন তার জন্য একটি উদাহরণ কনফিগার করুন।

বিডিং জলপ্রপাত

লেভেলপ্লে > সেটআপ > ইনস্ট্যান্সে নেভিগেট করুন, তারপর আপনার অ্যাপ নির্বাচন করুন। বিডিংয়ের অধীনে, ironSource-এ ক্লিক করুন।

ইনস্ট্যান্স আইডি নোট নিন।

অ্যান্ড্রয়েড iOS

বিজ্ঞাপন > সেটআপ > দৃষ্টান্তে নেভিগেট করুন। অ্যাপটি নির্বাচন করুন এবং উদাহরণ তৈরি করুন ক্লিক করুন।

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

ইনস্ট্যান্স আইডি নোট নিন।

আপনার রিপোর্টিং API কী সনাক্ত করুন৷

বিডিং জলপ্রপাত

বিডিং ইন্টিগ্রেশনের জন্য এই ধাপের প্রয়োজন নেই।

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

পরীক্ষা মোড চালু করুন

কিভাবে ironSource বিজ্ঞাপন পরীক্ষা বিজ্ঞাপনগুলি সক্ষম করতে হয় সে সম্পর্কে ironSource Ads এর ইন্টিগ্রেশন টেস্টিং গাইডের নির্দেশাবলী অনুসরণ করুন৷

ধাপ 2: AdMob UI-তে ironSource বিজ্ঞাপনের চাহিদা সেট আপ করুন

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

অ্যান্ড্রয়েড iOS

নির্দেশাবলীর জন্য, Android এর জন্য গাইডের ধাপ 2 দেখুন।

নির্দেশাবলীর জন্য, iOS এর জন্য নির্দেশিকাতে ধাপ 2 দেখুন।

GDPR এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় ironSource Mobile যোগ করুন

AdMob UI-তে ইউরোপীয় এবং মার্কিন রাজ্যের প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় ironSource Mobile যোগ করতে ইউরোপীয় প্রবিধান সেটিংস এবং মার্কিন রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন৷

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

pub.dev এর মাধ্যমে ইন্টিগ্রেশন

(কেবল অ্যান্ড্রয়েড) আপনার প্রোজেক্টের android ডিরেক্টরির ভিতরে build.gradle ফাইলে নিম্নলিখিত সংগ্রহস্থলগুলি যোগ করুন:

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://android-sdk.is.com/")
      }
  }

আপনার প্যাকেজের pubspec.yaml ফাইলে ironSource Ads SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন:

dependencies:
  gma_mediation_ironsource: ^1.1.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 বিজ্ঞাপনের জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন 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 বিজ্ঞাপনের জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন GmaMediationIronsource().setDoNotSell পদ্ধতি অন্তর্ভুক্ত করে। নিম্নোক্ত নমুনা কোডটি দেখায় কিভাবে ironSource Ads SDK-এ সম্মতির তথ্য পাঠাতে হয়। আইরনসোর্স বিজ্ঞাপন SDK-তে সঠিকভাবে ফরওয়ার্ড করা হয়েছে তা নিশ্চিত করার জন্য আপনি Google মোবাইল বিজ্ঞাপন SDK শুরু করার আগে এই বিকল্পগুলি অবশ্যই সেট করতে হবে৷

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

আরও বিশদ বিবরণের জন্য এবং পদ্ধতিতে প্রদান করা যেতে পারে এমন মানগুলির জন্য অ্যান্ড্রয়েড এবং আইওএস উভয়ের জন্য রেগুলেশন অ্যাডভান্সড সেটিংসে ironSource বিজ্ঞাপনের ডকুমেন্টেশন দেখুন৷

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

অ্যান্ড্রয়েড iOS

প্রোগার্ড নিয়ম

আপনি যদি আপনার অ্যাপ সঙ্কুচিত, অস্পষ্ট এবং অপ্টিমাইজ করেন , তাহলে 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)
}

SKAdNetwork ইন্টিগ্রেশন

আপনার প্রকল্পের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে ironSource বিজ্ঞাপনের ডকুমেন্টেশন অনুসরণ করুন।

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

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

নিশ্চিত করুন যে আপনি AdMob-এর জন্য আপনার পরীক্ষার ডিভাইস নিবন্ধন করেছেন এবং ironSource Ads UI-তে পরীক্ষা মোড সক্ষম করেছেন ৷

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

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

ত্রুটি কোড

যদি অ্যাডাপ্টার ironSource বিজ্ঞাপন থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:

অ্যান্ড্রয়েড iOS 
com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

অ্যান্ড্রয়েড iOS
ত্রুটি কোড কারণ
101 AdMob UI এ কনফিগার করা ironSource বিজ্ঞাপন সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ।
102 ironSource বিজ্ঞাপনগুলির SDK শুরু করার জন্য একটি কার্যকলাপের প্রসঙ্গ প্রয়োজন।
103 ironSource বিজ্ঞাপন প্রতি ironSource ইনস্ট্যান্স আইডিতে শুধুমাত্র 1টি বিজ্ঞাপন লোড করতে পারে।
105 অনুরোধ করা ব্যানার বিজ্ঞাপন আকার ironSource বিজ্ঞাপন দ্বারা সমর্থিত নয়.
106 ironSource Ads SDK আরম্ভ করা হয়নি।
501-1056 ironSource বিজ্ঞাপন SDK ত্রুটি৷ আরো বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন.
ত্রুটি কোড কারণ
101 AdMob UI এ কনফিগার করা ironSource বিজ্ঞাপন সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ।
102 ironSource বিজ্ঞাপন অ্যাডাপ্টার অনুরোধ করা বিজ্ঞাপন বিন্যাস সমর্থন করে না.
103 এই নেটওয়ার্ক কনফিগারেশনের জন্য একটি ironSource বিজ্ঞাপন ইতিমধ্যেই লোড করা হয়েছে৷
104 অনুরোধ করা ব্যানার বিজ্ঞাপন আকার ironSource বিজ্ঞাপন দ্বারা সমর্থিত নয়.
508-1037 ironSource বিজ্ঞাপন SDK ত্রুটি৷ আরো বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন.

ironSource Flutter Mediation Adapter Changelog

1.1.0

  • iOS প্লাগইন এখন একটি স্ট্যাটিক ফ্রেমওয়ার্ক।
  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।

1.0.0

  • প্রাথমিক মুক্তি।
  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।