মধ্যস্থতার সাথে আয়রনসোর্সকে একীভূত করুন

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

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

দ Ad Manager ironSource বিজ্ঞাপনের জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:

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

প্রয়োজনীয়তা

  • সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
  • ফ্লটার 3.7.0 বা উচ্চতর
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • Android API স্তর 21 বা উচ্চতর
  • iOS এ স্থাপন করতে
    • 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
  • একটি কাজ Flutter প্রোজেক্টটি Google Mobile Ads SDK-এর সাথে কনফিগার করা হয়েছে। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
  • মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড

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

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

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

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

নির্দেশাবলীর জন্য,Android ।

iOS

নির্দেশাবলীর জন্য,iOS ।

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

GDPR সেটিংসএবংইউএস স্টেট রেগুলেশন সেটিংস ironSource Mobileএ ধাপগুলি অনুসরণ করুন Ad Manager UI এ।

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

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

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

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

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

dependencies:
  gma_mediation_ironsource: ^1.0.0

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

এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণ ডাউনলোড করুনironSource , ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্রাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রোজেক্টে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার 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: প্রয়োজনীয় কোড যোগ করুন

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

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

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

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

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

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

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

ত্রুটি কোড

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

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

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

iOS 

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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

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

iOS

ত্রুটি কোড কারণ
101 ironSource বিজ্ঞাপন সার্ভার প্যারামিটার কনফিগার করা হয়েছে Ad Manager UI অনুপস্থিত/অবৈধ।
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 দিয়ে তৈরি এবং পরীক্ষিত।