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

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

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

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

Mintegral-এর জন্য 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 সেট-আপ করুন দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

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

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

    অ্যাপ কী খুঁজে বের করা

    অ্যাপ সেটিং ট্যাবে নেভিগেট করুন এবং অ্যাপ কী নোট করুন।

    নতুন অ্যাপ্লিকেশন যোগ করুন

    অ্যাপ সেটিং ট্যাব থেকে, অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

    প্ল্যাটফর্ম বেছে নিয়ে ফর্মের বাকি অংশ পূরণ করুন। তারপর, সেভ করুন বিকল্পে ক্লিক করুন।

    Android

    iOS

    আপনার অ্যাপ্লিকেশনের অ্যাপ আইডি নোট করে রাখুন।

    Android

    iOS

    বিজ্ঞাপনের প্লেসমেন্ট তৈরি করা

    আপনার অ্যাপ্লিকেশন তৈরি হয়ে গেলে, প্লেসমেন্ট ও ইউনিট ট্যাবে যান এবং নিচে দেখানো প্লেসমেন্ট যোগ করুন বোতামে ক্লিক করে আপনার বিজ্ঞাপন প্লেসমেন্ট তৈরি করুন।

    Android

    iOS

    প্লেসমেন্টের নাম এবং বিজ্ঞাপনের ফর্ম্যাট লিখুন।

    বিডিংয়ের ধরন হিসেবে হেডার বিডিং বেছে নিন। ফর্মের বাকি অংশ পূরণ করে সেভ করুন বিকল্পে ক্লিক করুন।

    আপনার বিজ্ঞাপনের প্লেসমেন্ট তৈরি হয়ে গেলে, প্লেসমেন্ট আইডি নোট করে নিন।

    Android

    iOS

    ১টি বিজ্ঞাপন ইউনিট ড্রপ-ডাউনে ক্লিক করে বিজ্ঞাপন ইউনিট আইডি নোট করে নিন।

    Android

    iOS

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

    বিডিং

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

    জলপ্রপাত

    আপনার Ad Manager বিজ্ঞাপন ইউনিট আইডি সেট-আপ করার জন্য Mintegral রিপোর্টিং API Key প্রয়োজন হবে। অ্যাকাউন্ট > API টুল বিকল্পে নেভিগেট করুন। আপনার Skey এবং Secret নোট করে রাখুন।

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

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

    Mintegral-এর জন্য app-ads.txt প্রয়োগ করতে, বিজ্ঞাপন সংক্রান্ত জালিয়াতি রুখতে app-Ads.txt কীভাবে সাহায্য করতে পারে দেখুন।

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

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

    Android

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

    iOS

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

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

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

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

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

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

      repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
      }
  }

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

    dependencies:
  gma_mediation_mintegral: ^2.1.5

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

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

    dependencies:
  gma_mediation_mintegral:
    path: path/to/local/package

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

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

    Mintegral Flutter অ্যাডাপ্টার ভার্সন 2.1.1 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে Mintegral SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, Mintegral-এর Android এবং iOS SDK গোপনীয়তা মেনে চলা সংক্রান্ত বিবৃতি ডকুমেন্টেশন দেখুন।

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

    Android

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

    iOS

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

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

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

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

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

    ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কার প্রদানকারী ও নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য Mintegral টেস্ট বিজ্ঞাপন পেতে, Mintegral-এর সাজেশন হল, Mintegral টেস্ট আইডি পৃষ্ঠায় দেওয়া অ্যাপ কী, অ্যাপ আইডি, প্লেসমেন্ট আইডি ও বিজ্ঞাপন ইউনিট আইডি ব্যবহার করা।

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

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

    ত্রুটি কোড

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

    Android

    com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

    iOS

    GADMediationAdapterMintegral

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

    Android

    সমস্যার কোড ডোমেন কারণ
    100 com.mbridge.msdk Mintegral SDK একটি ব্যর্থ কলব্যাক রিটার্ন করেছে।
    ১০১ com.google.ads.mediation.mintegral সার্ভার প্যারামিটার ভুল (যেমন, অ্যাপ আইডি বা প্লেসমেন্ট আইডি নেই)।
    102 com.google.ads.mediation.mintegral অনুরোধ করা বিজ্ঞাপনের সাইজ Mintegral-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।
    103 com.google.ads.mediation.mintegral বিড রেসপন্স নেই বা ভুল আছে।
    104 com.google.ads.mediation.mintegral Mintegral SDK থেকে নো ফিল সংক্রান্ত সমস্যা পাওয়া গেছে।
    ১০৫ com.mbridge.msdk Mintegral SDK শুরু করা যায়নি।
    106 com.google.ads.mediation.mintegral Mintegral স্লটের জন্য একটি বিজ্ঞাপন আগে থেকেই লোড করা আছে এবং এখনও দেখানো হয়নি।

    iOS

    সমস্যার কোড ডোমেন কারণ
    ১০১ com.google.mediation.mintegral সার্ভার প্যারামিটার ভুল (যেমন, অ্যাপ আইডি বা প্লেসমেন্ট আইডি নেই)।
    102 com.google.mediation.mintegral Mintegral SDK থেকে নো ফিল সংক্রান্ত সমস্যা পাওয়া গেছে।
    103 com.google.mediation.mintegral Mintegral SDK বিজ্ঞাপন দেখাতে পারেনি।
    104 com.google.mediation.mintegral অনুরোধ করা বিজ্ঞাপনের সাইজ Mintegral-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।

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

    ভার্সন ২.১.৫

    ভার্সন ২.১.৪

    ভার্সন ২.১.৩

    ভার্সন ২.১.২

    ভার্সন ২.১.১

    ভার্সন 2.1.0

    ভার্সন 2.0.3

    ভার্সন ২.০.২

    ভার্সন ২.০.১

    ভার্সন 2.0.0

    ভার্সন ১.২.৬

    ভার্সন ১.২.৫

    ভার্সন ১.২.৪

    ভার্সন ১.২.৩

    ভার্সন ১.২.২

    ভার্সন ১.২.১

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0