মেডিয়েশনের সাথে i-mobile ইন্টিগ্রেট করা

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

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

i-mobile-এর ড্যাশবোর্ড ইন্টারফেসের লেবেল, বোতাম ও বিবরণে জাপানি টেক্সট ব্যবহার করা হয়। এই গাইডের স্ক্রিনশটগুলি অনুবাদ করা হয়নি। তবে, এই গাইডের বিবরণ ও নির্দেশাবলীতে, লেবেল ও বোতামের অনুবাদ করা হয়েছে এবং বন্ধনীতে সেগুলির ইংরেজি সমার্থক শব্দ দেওয়া হয়েছে।

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

i-mobile-এর জন্য Ad Manager মিডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:

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

পূর্বশর্ত

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

  • লেটেস্ট 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 সেট-আপ করুন দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।
  • ধাপ ১: i-mobile UI-তে কনফিগারেশন সেট-আপ করা

    আপনার i-mobile অ্যাকাউন্টে সাইন-আপ বা লগ-ইন করুন।

    サイト/アプリ管理 (Site/Application Management) ট্যাব এবং আপনার অ্যাপের প্ল্যাটফর্মের জন্য বোতামে ক্লিক করে i-mobile ড্যাশবোর্ডে আপনার অ্যাপ যোগ করুন।

    Android

    iOS

    ফর্ম পূরণ করে 新規登録 (সাইন-আপ করুন) বোতামে ক্লিক করুন।

    Android

    iOS

    নতুন বিজ্ঞাপন স্পট তৈরি করতে, サイト/アプリ管理 (সাইট/অ্যাপ্লিকেশন ম্যানেজমেন্ট) ট্যাবের অধীনে আপনার অ্যাপ বেছে নিন।

    Android

    iOS

    広告スポット管理 (Ad Spot Management) ট্যাবে গিয়ে 新規広告スポット (New Ad Spot) বোতামে ক্লিক করুন।

    create_ad_spot

    এরপর, 広告スポット名 (বিজ্ঞাপন স্পটের নাম), 広告スポットサイズ (বিজ্ঞাপন স্পটের সাইজ) এবং অন্যান্য বিবরণ দিয়ে ফর্মটি পূরণ করুন। তারপর, 新規登録 (সাইন-আপ করুন) বোতামে ক্লিক করুন।

    new_ad_spot_form

    আপনার নতুন বিজ্ঞাপন স্পট রেডি আছে। ইন্টিগ্রেশন সংক্রান্ত বিবরণ দেখতে, アプリ設定取得 (Get App settings) বোতামে ক্লিক করুন।

    ad_spot_list

    パブリッシャーID (প্রকাশক আইডি), メディアID (মিডিয়া আইডি), এবং スポットID (স্পট আইডি) নোট করে রাখুন। Ad Manager UI-তে মধ্যস্থতার জন্য i-mobile কনফিগার করার সময় আপনাকে পরে এইসব প্যারামিটার ব্যবহার করতে হবে।

    Android

    iOS

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

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

    i-mobile-এর জন্য app-ads.txt প্রয়োগ করতে, তাদের প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন।

    ধাপ ২: Ad Manager UI-তে i-mobile ডিমান্ড সেট-আপ করা

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

    Android

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

    iOS

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

    ধাপ ৩: i-mobile SDK ও অ্যাডাপ্টার ইমপোর্ট করা

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

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

      repositories {
          google()
          mavenCentral()
          maven {
              url = uri("https://imobile.github.io/adnw-sdk-android")
          }
      }
    

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

    dependencies:
      gma_mediation_imobile: ^1.0.6
    

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

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

    dependencies:
      gma_mediation_imobile:
        path: path/to/local/package
    

    ধাপ ৪: অতিরিক্ত কোড প্রয়োজন

    Android

    i-mobile ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।

    iOS

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

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

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

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

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না। i-mobile টেস্টিংয়ের জন্য টেস্ট Spot ID, মিডিয়া আইডি এবং প্রকাশক আইডি প্রদান করে, আপনি সেগুলি এখানে খুঁজে পাবেন।

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

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

    ত্রুটি কোড

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

    Android

    ফর্ম্যাট ক্লাসের নাম
    ব্যানার com.google.ads.mediation.imobile.IMobileAdapter
    স্থান com.google.ads.mediation.imobile.IMobileAdapter
    নেটিভ com.google.ads.mediation.imobile.IMobileMediationAdapter

    iOS

    ফর্ম্যাট ক্লাসের নাম
    ব্যানার IMobileAdapter
    স্থান IMobileAdapter
    নেটিভ GADMediationAdapterIMobile

    কোনও বিজ্ঞাপন লোড না হলে i-mobile অ্যাডাপ্টারের মাধ্যমে দেখানো কোড ও মেসেজ এখানে দেওয়া হল:

    Android

    সমস্যার কোড কারণ
    0-99 i-mobile SDK-তে সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন।
    ১০১ i-mobile-এ বিজ্ঞাপন লোড করার জন্য Activity কনটেক্সট প্রয়োজন।
    102 Ad Manager UI-তে কনফিগার করা i-mobile সার্ভার প্যারামিটার নেই বা ভুল।
    103 অনুরোধ করা বিজ্ঞাপনের সাইজ i-mobile-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
    104 i-mobile-এর নেটিভ বিজ্ঞাপন লোড হওয়ার সাকসেস কলব্যাক একটি খালি নেটিভ বিজ্ঞাপনের তালিকা ফিরিয়ে দিয়েছে।

    iOS

    সমস্যার কোড কারণ
    0-10 i-mobile SDK-তে সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন।
    ১০১ Ad Manager UI-তে কনফিগার করা i-mobile সার্ভার প্যারামিটার নেই বা ভুল।
    102 অনুরোধ করা বিজ্ঞাপনের সাইজ i-mobile-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
    103 i-mobile বিজ্ঞাপন দেখাতে পারেনি।
    104 i-mobile একটি খালি নেটিভ বিজ্ঞাপন অ্যারে রিটার্ন করেছে।
    ১০৫ i-mobile নেটিভ বিজ্ঞাপন অ্যাসেট ডাউনলোড করতে পারেনি।
    106 একই স্পট আইডি ব্যবহার করে একাধিক ইন্টারস্টিশিয়াল বিজ্ঞাপনের জন্য অনুরোধ করার সুবিধা i-mobile-এ নেই।

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

    ভার্সন ১.০.৬

    ভার্সন ১.০.৫

    ভার্সন 1.0.4

    ভার্সন 1.0.3

    ভার্সন 1.0.2

    ভার্সন ১.০.১

    ভার্সন 1.0.0