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

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

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

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

ironSource Ads-এর জন্য Ad Manager মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
ব্যানার ১
ইন্টারস্টিশিয়াল
পুরস্কৃত
পুরস্কৃত ইন্টারস্টিশিয়াল ১

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

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

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

ধাপ ১: ironSource Ads UI-তে কনফিগারেশন সেট আপ করুন।

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

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

নতুন অ্যাপ যোগ করতে, Ads > Apps- এ যান এবং Add app-এ ক্লিক করুন।

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

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

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

আইওএস

একটি ইনস্ট্যান্স তৈরি করুন

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

Ads > Setup > Instances- এ যান। অ্যাপটি নির্বাচন করুন এবং Create instance-এ ক্লিক করুন।

নিলাম

ফর্মটি পূরণ করুন এবং মূল্য নির্ধারণের জন্য বিডিং নির্বাচন করুন। সেভ এবং ক্লোজ-এ ক্লিক করুন।

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

আইওএস

ইনস্ট্যান্স আইডিটি লিখে রাখুন।

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

আইওএস

জলপ্রপাত

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

ইনস্ট্যান্স আইডিটি লিখে রাখুন।

আপনার রিপোর্টিং এপিআই কী খুঁজুন

নিলাম

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

জলপ্রপাত

আমার অ্যাকাউন্ট পেজে থাকা API ট্যাবে ক্লিক করুন এবং আপনার সিক্রেট কী ও রিফ্রেশ টোকেন লিখে নিন।

আপনার app-ads.txt আপডেট করুন।

Apps-এর জন্য অনুমোদিত বিক্রেতা app-ads.txt হলো IAB টেক ল্যাবের একটি উদ্যোগ, যা নিশ্চিত করতে সাহায্য করে যে আপনার অ্যাপের বিজ্ঞাপন ইনভেন্টরি শুধুমাত্র আপনার দ্বারা অনুমোদিত হিসেবে চিহ্নিত চ্যানেলগুলোর মাধ্যমেই বিক্রি হয়। বিজ্ঞাপনের আয়ে বড় ধরনের ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে Ad Manager-এর জন্য একটি app-ads.txt ফাইল তৈরি করুন ।

ironSource-এর জন্য app-ads.txt প্রয়োগ করতে, ironSource অনুমোদিত রিসেলারদের দেখুন।

টেস্ট মোড চালু করুন

ironSource Ads টেস্ট অ্যাড চালু করার জন্য, ironSource Ads-এর ইন্টিগ্রেশন টেস্টিং গাইডের নির্দেশাবলী অনুসরণ করুন।

ধাপ ২: অ্যাড ম্যানেজার UI-তে ironSource বিজ্ঞাপনের চাহিদা সেট আপ করুন।

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

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

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

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

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

অ্যাড ম্যানেজার 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.3.0

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

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

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

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

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

ironSource অ্যাডাপ্টার ইউনিটি প্লাগইন সংস্করণ 2.6.0 থেকে শুরু করে, ironSource স্বয়ংক্রিয়ভাবে সেইসব কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা সেট করা GDPR সম্মতি পড়ে নেয়, যেগুলো Google-এর Additional Consent স্পেসিফিকেশন সমর্থন করে, যার মধ্যে UMP SDK অন্তর্ভুক্ত। আরও তথ্যের জন্য, “Support for Google UMP and CMPs that support Google's Additional Consent” দেখুন।

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

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

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

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

GmaMediationIronsource().setDoNotSell(true);

আরও বিস্তারিত তথ্যের জন্য এবং মেথডটিতে যে ভ্যালুগুলো প্রদান করা যায়, সে সম্পর্কে জানতে অ্যান্ড্রয়েড এবং আইওএস উভয়ের জন্য ironSource Ads-এর 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)
}

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

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

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

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করুন এবং ironSource Ads UI-তে টেস্ট মোড চালু করুন ।

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

আপনি ironSource Ads থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে ironSource Ads (Bidding) এবং ironSource Ads (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ত্রুটি কোড

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

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

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

আইওএস 

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

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

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

আইওএস

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

ironSource ফ্লাটার মিডিয়েশন অ্যাডাপ্টার পরিবর্তন তালিকা

সংস্করণ ২.৩.০

সংস্করণ ২.২.০

সংস্করণ ২.১.০

সংস্করণ ২.০.১

সংস্করণ ২.০.০

সংস্করণ ১.৫.০

সংস্করণ ১.৪.১

সংস্করণ ১.৪.০

সংস্করণ ১.৩.১

সংস্করণ ১.৩.০

সংস্করণ ১.২.০

সংস্করণ ১.১.০

সংস্করণ ১.০.০