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

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

এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে 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 লেভেল 24 বা এর পরের যেকোনও ভার্সন।
  • 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 Reporting API Key খুঁজে বের করা

    বিডিং

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

    জলপ্রপাত

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

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

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

    ভার্সন 2.1.0

    ভার্সন ২.০.৩

    ভার্সন ২.০.২

    ভার্সন 2.0.1

    ভার্সন 2.0.0

    ভার্সন 1.2.6

    ভার্সন 1.2.5

    ভার্সন ১.২.৪

    ভার্সন ১.২.৩

    ভার্সন 1.2.2

    ভার্সন ১.২.১

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0