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

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

এই গাইড আপনাকে দেখায় যে কীভাবে 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 লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • 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 টেক ল্যাব ইনিশিয়েটিভ যা কনফার্ম করতে সাহায্য করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেনটরি আপনি যাদের অনুমোদিত হিসেবে শনাক্ত করেছেন, শুধুমাত্র সেইসব চ্যানেলের মাধ্যমেই বিক্রি করা কনফার্ম করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি 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.3

    ভার্সন 1.0.2

    ভার্সন ১.০.১

    ভার্সন 1.0.0