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

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

এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে mediation ব্যবহার করে ironSource Ads থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, যা ওয়াটারফল ইন্টিগ্রেশনগুলিকে অন্তর্ভুক্ত করে। এটি একটি বিজ্ঞাপন ইউনিটের mediation কনফিগারেশনে ironSource Ads কীভাবে যুক্ত করতে হয় এবং ironSource Ads SDK এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপে কীভাবে একীভূত করতে হয় তা কভার করে।

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

ironSource Ads-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:

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

এই ফর্ম্যাটটি শুধুমাত্র জলপ্রপাত ইন্টিগ্রেশনে সমর্থিত।

আবশ্যকতা

  • সর্বশেষ গুগল মোবাইল বিজ্ঞাপন SDK
  • ফ্লাটার ৩.৭.০ বা তার বেশি
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS স্থাপনার লক্ষ্য ১২.০ বা তার বেশি
  • Google মোবাইল বিজ্ঞাপন SDK দিয়ে কনফিগার করা একটি কার্যকরী Flutter প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
  • মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন

ধাপ ১: 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 বিজ্ঞাপনের চাহিদা সেট আপ করুন

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

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

নির্দেশাবলীর জন্য, Android এর জন্য নির্দেশিকায় ধাপ ২ দেখুন।

আইওএস

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

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

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

ধাপ ৩: 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: ^2.0.1

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

ironSource Ads এর জন্য Google Mobile Ads mediation plugin এর সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার Flutter প্রজেক্টে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml ফাইলে প্লাগইনটি উল্লেখ করুন:

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

ধাপ ৪: ironSource Ads SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করুন

Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডের ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং আইনত প্রয়োজনে কুকিজ বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, ভাগ করে নেওয়া এবং ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণ (GDPR) এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে। আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পাঠানো হয়েছে কিনা তা যাচাই করার জন্য আপনার দায়িত্ব। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতি পছন্দ প্রেরণ করতে অক্ষম।

ironSource অ্যাডাপ্টার ইউনিটি প্লাগইন সংস্করণ 2.6.0 থেকে শুরু করে, ironSource স্বয়ংক্রিয়ভাবে UMP SDK সহ Google এর অতিরিক্ত সম্মতি স্পেসিফিকেশন সমর্থনকারী সম্মতি ব্যবস্থাপনা প্ল্যাটফর্মগুলির দ্বারা সেট করা GDPR সম্মতি পড়ে। আরও তথ্যের জন্য, Google UMP এবং Google এর অতিরিক্ত সম্মতি সমর্থনকারী CMP গুলির জন্য সমর্থন দেখুন।

মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন

মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন অনুসারে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" (যেমন আইন এই শর্তাবলী সংজ্ঞায়িত করে) "বিক্রয়" থেকে বেরিয়ে আসার অধিকার দেওয়া হয়, যেখানে "বিক্রয়কারী" পক্ষের হোমপেজে "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউট করার সুযোগ দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন সম্মতি নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে অক্ষম। অতএব, আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্ক চিহ্নিত করতে হবে যারা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই প্রতিটি নেটওয়ার্কের নির্দেশিকা অনুসরণ করতে হবে।

ironSource Ads-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগইনটিতে GmaMediationIronsource().setDoNotSell পদ্ধতি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি ironSource Ads SDK-তে সম্মতির তথ্য কীভাবে পাঠাতে হয় তা দেখায়। Google Mobile Ads SDK শুরু করার আগে এই বিকল্পগুলি সেট করতে হবে যাতে সেগুলি ironSource Ads SDK-তে সঠিকভাবে ফরোয়ার্ড করা যায়।

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

GmaMediationIronsource().setDoNotSell(true);

আরও বিস্তারিত জানার জন্য এবং পদ্ধতিতে কী কী মান দেওয়া যেতে পারে তার জন্য ironSource Ads-এর Android এবং iOS উভয়ের জন্য Regulation Advanced Settings-এর ডকুমেন্টেশন দেখুন।

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

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

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

আপনি যদি আপনার অ্যাপটি সঙ্কুচিত, অস্পষ্ট এবং অপ্টিমাইজ করেন , তাহলে IronSource Ads আপনার প্রকল্পের জন্য অতিরিক্ত ProGuard নিয়মের প্রয়োজন হবে।

আপনার প্রকল্পের জন্য ProGuard নিয়মগুলি কী কী তা সম্পর্কে আরও তথ্যের জন্য IronSource Ads এর Android SDK ইন্টিগ্রেশন গাইডটি দেখুন এবং সেই নিয়মগুলি আপনার proguard-user.txt ফাইলে যুক্ত করুন।

অ্যাপ্লিকেশন জীবনচক্র

আপনার প্রতিটি কার্যকলাপে onPause() এবং onResume() পদ্ধতিগুলিকে ওভাররাইড করে সংশ্লিষ্ট ironSource Ads পদ্ধতিগুলিকে নিম্নরূপ কল করুন:

জাভা

@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 Ads এর ডকুমেন্টেশন অনুসরণ করুন।

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

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

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

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

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

ত্রুটি কোড

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

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

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

আইওএস

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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

ত্রুটি কোড কারণ
১০১ AdMob UI-তে কনফিগার করা ironSource Ads সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ।
১০২ ironSource Ads-এর SDK আরম্ভ করার জন্য একটি কার্যকলাপ প্রসঙ্গ প্রয়োজন।
১০৩ ironSource বিজ্ঞাপনগুলি প্রতি ironSource ইনস্ট্যান্স আইডিতে কেবল ১টি বিজ্ঞাপন লোড করতে পারে।
১০৫ অনুরোধকৃত ব্যানার বিজ্ঞাপনের আকার ironSource Ads দ্বারা সমর্থিত নয়।
১০৬ ironSource Ads SDK আরম্ভ করা হয়নি।
৫০১-১০৫৬ ironSource বিজ্ঞাপন SDK ত্রুটি। আরও বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন।

আইওএস

ত্রুটি কোড কারণ
১০১ AdMob UI-তে কনফিগার করা ironSource Ads সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ।
১০২ ironSource Ads Adapter অনুরোধ করা বিজ্ঞাপন ফর্ম্যাট সমর্থন করে না।
১০৩ এই নেটওয়ার্ক কনফিগারেশনের জন্য একটি ironSource বিজ্ঞাপন ইতিমধ্যেই লোড করা হয়েছে।
১০৪ অনুরোধকৃত ব্যানার বিজ্ঞাপনের আকার ironSource Ads দ্বারা সমর্থিত নয়।
৫০৮-১০৩৭ ironSource বিজ্ঞাপন SDK ত্রুটি। আরও বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন।

আয়রনসোর্স ফ্লাটার মেডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

সংস্করণ 2.0.0

সংস্করণ 1.5.0

সংস্করণ 1.4.1

সংস্করণ 1.4.0

সংস্করণ 1.3.1

সংস্করণ 1.3.0

সংস্করণ 1.2.0

সংস্করণ 1.1.0

সংস্করণ 1.0.0