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

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

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

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

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

¹ বিডিং ইন্টিগ্রেশন বন্ধ বিটাতে রয়েছে, অ্যাক্সেসের অনুরোধ করতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

² এই বিন্যাসটি শুধুমাত্র জলপ্রপাত একীকরণে সমর্থিত।

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

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

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

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

ironSource Ads ড্যাশবোর্ডে আপনার অ্যাপ্লিকেশন যোগ করতে, নতুন অ্যাপ বোতামে ক্লিক করুন।

অ্যাপের বিবরণ লিখুন

লাইভ অ্যাপ নির্বাচন করুন, আপনার অ্যাপটি লিখুন এবং অ্যাপের তথ্য আমদানিতে ক্লিক করুন।

আপনার অ্যাপটি উপলব্ধ না হলে, অ্যাপ্লিকেশন স্টোরে অ্যাপ নট লাইভ নির্বাচন করুন এবং আপনার অ্যাপের জন্য একটি অস্থায়ী নাম প্রদান করুন। আপনার প্ল্যাটফর্ম নির্বাচন করুন.

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

আপনার নতুন অ্যাপ কী নোট করুন, যা অ্যাপ যোগ করার পরে প্রদর্শিত হয়। আপনার AdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য আপনার এই মানটির প্রয়োজন হবে৷ আপনার অ্যাপ সমর্থন করে এমন বিজ্ঞাপন ফর্ম্যাটগুলি নির্বাচন করুন৷ তারপর Continue এ ক্লিক করুন।

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

iOS

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

এরপরে, আপনার যোগ করা অ্যাপের জন্য একটি নেটওয়ার্ক ইনস্ট্যান্স কনফিগার করুন।

বিডিং

LevelPlay > সেটআপ > SDK নেটওয়ার্কে নেভিগেট করুন, তারপর আপনার অ্যাপ নির্বাচন করুন। বিডিংয়ের অধীনে, বিডিং ইনস্ট্যান্স আইডি দেখতে সম্পাদনা আইকনে ক্লিক করুন।

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

iOS

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

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

iOS

জলপ্রপাত

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

প্রয়োজনীয় বিবরণ লিখুন এবং সংরক্ষণ করুন এবং বন্ধ করুন ক্লিক করুন।

দ্রষ্টব্য: আয়রনসোর্স আপনাকে সর্বাধিক সংখ্যক ইনস্ট্যান্স আইডি তৈরি করতে সীমাবদ্ধ করে। যদি আপনি একটি ত্রুটি পান যে আপনি আরও ইনস্ট্যান্স আইডি তৈরি করতে পারবেন না, সহায়তার জন্য IronSource সহায়তা দলের সাথে যোগাযোগ করুন ।

মূল পয়েন্ট: আপনি যদি পুরস্কৃত ইন্টারস্টিশিয়াল বিজ্ঞাপনগুলিকে সমর্থন করতে চান, তাহলে পুরস্কৃত ভিডিও ফর্ম্যাটটি নির্বাচন করুন এবং পদক্ষেপ 2 এ একটি বিজ্ঞাপন উত্স হিসাবে ironSource বিজ্ঞাপনগুলি যোগ করতে সেই ইনস্ট্যান্স আইডিটি ব্যবহার করুন৷ উপরন্তু, আপনাকে পুরস্কৃত ইন্টারস্টিশিয়াল সহায়তার জন্য আপনার ইনস্ট্যান্স আইডি সেট আপ করতে [e-mail] এ ironSource বিজ্ঞাপন সহায়তা দলের সাথে যোগাযোগ করতে হবে।

একবার ইন্সট্যান্স তৈরি হয়ে গেলে, ইনস্ট্যান্স আইডি ইনস্ট্যান্স আইডি ফিল্ডে তালিকাভুক্ত হয়।

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

বিডিং

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

জলপ্রপাত

অ্যাপ কী এবং ইনস্ট্যান্স আইডি ছাড়াও, আপনার AdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য আপনার ironSource বিজ্ঞাপন সিক্রেট কী এবং রিফ্রেশ টোকেনের প্রয়োজন হবে।

আপনার ironSource বিজ্ঞাপন প্রকাশক ড্যাশবোর্ডে আমার অ্যাকাউন্টে নেভিগেট করুন তারপর API ট্যাবে ক্লিক করুন। আপনার গোপন কী নোট নিন এবং টোকেন রিফ্রেশ করুন ।

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

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

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

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

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

নির্দেশাবলীর জন্য, নির্দেশিকাতে ধাপ 2 দেখুনঅ্যান্ড্রয়েড

iOS

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

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

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

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

দ্রষ্টব্য: সামঞ্জস্যপূর্ণ আয়রনসোর্স বিজ্ঞাপন এবং Google মোবাইল বিজ্ঞাপন SDK সংস্করণগুলিকে সংহত করতে ব্যর্থ হলে সমস্যা তৈরি হতে পারে৷

Pub.dev এর মাধ্যমে সংহতকরণ

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

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

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

dependencies:
  gma_mediation_ironsource: ^1.0.0

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

গুগল মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন এর সর্বশেষ সংস্করণটি ডাউনলোড করুনironSource , ডাউনলোড করা ফাইলটি বের করুন এবং আপনার ঝাঁকুনির প্রকল্পে নিষ্কাশিত প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) যুক্ত করুন। তারপরে, নিম্নলিখিত নির্ভরতা যুক্ত করে আপনার pubspec.yaml ফাইলটিতে প্লাগইনটি উল্লেখ করুন:

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

,

Pub.dev এর মাধ্যমে সংহতকরণ

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

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

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

dependencies:
  gma_mediation_ironsource: ^1.0.0

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

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

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

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

গুরুত্বপূর্ণ: আপনার অ্যাপ রিলিজ করার আগে AdMob এবং ironSource বিজ্ঞাপনের পরীক্ষা মোড অক্ষম করুন।

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

আপনি ironSource বিজ্ঞাপনগুলি থেকে পরীক্ষামূলক বিজ্ঞাপনগুলি পাচ্ছেন তা যাচাই করতে, ironSource Ads (Bidding) এবং ironSource Ads (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

পরবর্তী সংস্করণ

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

1.1.0

• ironSource Android অ্যাডাপ্টার সংস্করণ 8.2.1.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
• ironSource iOS অ্যাডাপ্টারের সংস্করণ 8.2.0.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
• Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।

1.0.0

• প্রাথমিক মুক্তি।
• ironSource Android অ্যাডাপ্টার সংস্করণ 8.0.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
• ironSource iOS অ্যাডাপ্টার সংস্করণ 8.0.0.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
• Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।