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

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

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

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

Mintegral-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টরের নিম্নলিখিত ক্ষমতা আছে:

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

পূর্বশর্ত

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

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

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

বিডিং

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

জলপ্রপাত

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

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

Android

iOS

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

Android

iOS

আপনার Mintegral Reporting API Key খুঁজে বের করা

বিডিং

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

জলপ্রপাত

আপনার AdMob বিজ্ঞাপন ইউনিট আইডি সেট-আপ করার জন্য Mintegral Reporting API কী প্রয়োজন হবে। অ্যাকাউন্ট > API টুল বিকল্পে নেভিগেট করুন। আপনার Skey ও Secret মনে রাখুন।

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

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

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

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

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

Android

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

iOS

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

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

AdMob 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.4

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

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

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

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

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

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

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

Android

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

iOS

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

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

ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

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

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা তা ভালোভাবে দেখে নিন।

ব্যানার, ইন্টারস্টিশিয়াল, পুরস্কার প্রদানকারী ও নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য 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.5 (কাজ চলছে)

ভার্সন ২.১.৪

ভার্সন 2.1.3

ভার্সন 2.1.2

ভার্সন 2.1.1

ভার্সন 2.1.0

ভার্সন 2.0.3

ভার্সন 2.0.2

ভার্সন 2.0.1

ভার্সন 2.0.0

ভার্সন 1.2.6

ভার্সন 1.2.5

ভার্সন 1.2.4

ভার্সন 1.2.3

ভার্সন 1.2.2

ভার্সন 1.2.1

ভার্সন 1.2.0

ভার্সন 1.1.0

ভার্সন 1.0.0