মধ্যস্থতার সাথে ironSource Ads ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (পুরনো)

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

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

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

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

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

পূর্বশর্ত

চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:

  • লেটেস্ট Google Mobile Ads Flutter Plugin ভার্সন।
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads Flutter Plugin সেট-আপ করুন দেখুন।
  • AdMob মেডিয়েশন সেট-আপ করুন।

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

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

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

    নতুন অ্যাপ যোগ করতে, বিজ্ঞাপন > অ্যাপ বিকল্পে গিয়ে অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।

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

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

    Android

    iOS

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

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

    বিজ্ঞাপন > সেট-আপ > ইনস্ট্যান্স বিকল্পে যান। অ্যাপ বেছে নিয়ে ইনস্ট্যান্স তৈরি করুন বিকল্পে ক্লিক করুন।

    বিডিং

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

    Android

    iOS

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

    Android

    iOS

    জলপ্রপাত

    ফর্ম পূরণ করে সেভ করে বন্ধ করুন বিকল্পে ক্লিক করুন।

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

    আপনার রিপোর্টিং API Key খুঁজে নিন

    বিডিং

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

    জলপ্রপাত

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

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

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

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

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

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

    ধাপ ২: AdMob UI-তে ironSource Ads ডিমান্ড সেট-আপ করুন

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

    Android

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

    iOS

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

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

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

    ধাপ ৩: ironSource Ads SDK এবং অ্যাডাপ্টার ইম্পোর্ট করা

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

    (শুধুমাত্র Android) আপনার প্রোজেক্টের android ডিরেক্টরির মধ্যে থাকা build.gradle ফাইলে নিম্নলিখিত রিপোজিটরি যোগ করুন:

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

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

    dependencies:
  gma_mediation_ironsource: ^2.7.0

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

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

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

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

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

    ironSource Ads Flutter অ্যাডাপ্টার ভার্সন 1.0.0 এবং পরবর্তী ভার্সন UMP SDK থেকে জিডিপিআর (GDPR) সম্মতি সিগন্যাল পাস করা এবং সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্ম যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশন-এর সাথে ইন্টিগ্রেট করে, তা সাপোর্ট করে

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

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

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

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

GmaMediationIronsource().setDoNotSell(true);

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

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

    Android

    Proguard নিয়ম

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

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

    অ্যাপ্লিকেশন লাইফসাইকেল

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

    Java

    @Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

    Kotlin

    public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

    iOS

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

    ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন

    টেস্ট বিজ্ঞাপন চালু করুন

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

    টেস্ট বিজ্ঞাপন যাচাই করা

    আপনি ironSource Ads থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, ironSource Ads (বিডিং) এবং ironSource Ads (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করে অ্যাড ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

    ত্রুটি কোড

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

    Android

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

    iOS

    GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

    Android

    সমস্যার কোড কারণ
    ১০১ AdMob UI-তে কনফিগার করা ironSource Ads সার্ভার প্যারামিটার নেই/ভুল।
    102 ironSource Ads-এর SDK শুরু করার জন্য অ্যাক্টিভিটি কনটেক্সট প্রয়োজন।
    103 ironSource Ads প্রতিটি ironSource ইনস্ট্যান্স আইডিতে শুধুমাত্র ১টি বিজ্ঞাপন লোড করতে পারে।
    ১০৫ অনুরোধ করা ব্যানার বিজ্ঞাপনের সাইজ ironSource Ads-এ কাজ করে না।
    106 ironSource Ads SDK শুরু করা হয়নি।
    107 বিজ্ঞাপন ঠিকমতো লোড হওয়ার আগেই বিজ্ঞাপন দেখানোর অনুরোধ করা হয়েছে।
    108 ironSource Ads SDK ফাঁকা বা খালি বিডিং সিগন্যাল রিটার্ন করেছে।
    501-1056 ironSource Ads SDK সংক্রান্ত সমস্যা। আরও তথ্যের জন্য ডকুমেন্টেশন দেখুন।

    iOS

    সমস্যার কোড কারণ
    ১০১ AdMob UI-তে কনফিগার করা ironSource Ads সার্ভার প্যারামিটার নেই/ভুল।
    102 অনুরোধ করা বিজ্ঞাপনের ফর্ম্যাট ironSource Ads অ্যাডাপ্টারে কাজ করে না।
    103 এই নেটওয়ার্ক কনফিগারেশনের জন্য ironSource বিজ্ঞাপন আগে থেকেই লোড করা আছে।
    104 অনুরোধ করা ব্যানার বিজ্ঞাপনের সাইজ ironSource Ads-এ কাজ করে না।
    ১০৫ ironSource Ads বিজ্ঞাপন দেখাতে পারেনি।
    508-1037 ironSource Ads SDK সংক্রান্ত সমস্যা। আরও তথ্যের জন্য ডকুমেন্টেশন দেখুন।

    ironSource Flutter মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

    ভার্সন ২.৭.১ (কাজ চলছে)

    ভার্সন 2.7.0

    ভার্সন 2.6.0

    ভার্সন ২.৫.১

    ভার্সন 2.5.0

    ভার্সন ২.৪.৩

    ভার্সন ২.৪.২

    ভার্সন ২.৪.১

    ভার্সন ২.৪.০

    ভার্সন 2.3.0

    ভার্সন ২.২.০

    ভার্সন 2.1.0

    ভার্সন ২.০.১

    ভার্সন 2.0.0

    ভার্সন ১.৫.০

    ভার্সন ১.৪.১

    ভার্সন 1.4.0

    ভার্সন ১.৩.১

    ভার্সন ১.৩.০

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0