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

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

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

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

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

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

পূর্বশর্ত

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

  • Google Mobile Ads Unity Plugin-এর লেটেস্ট ভার্সন।
  • Unity Editor ভার্সন 5.6 বা তার পরবর্তী যেকোনও ভার্সন।
  • [বিডিংয়ের জন্য]: বিডিংয়ে সবকটি কাজ করে এমন বিজ্ঞাপন ফর্ম্যাট ইন্টিগ্রেট করতে, Mintegral 1.4.0 বা এর পরের যেকোনও ভার্সনের জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইন ব্যবহার করুন (লেটেস্ট ভার্সন ব্যবহার করার সাজেশন দেওয়া হয়)।
  • Android-এ ডেপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Unity Plugin-এর সাথে কনফিগার করা একটি চালু Unity প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ Google Mobile Ads Unity Plugin দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

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

    Android

    iOS

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

    Android

    iOS

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

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

    Android

    iOS

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

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

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

    Android

    iOS

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

    Android

    iOS

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

    বিডিং

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

    জলপ্রপাত

    আপনার Ad Manager বিজ্ঞাপন ইউনিট আইডি সেট-আপ করার জন্য Mintegral Reporting API কী প্রয়োজন হবে। অ্যাকাউন্ট > 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 ও অ্যাডাপ্টার ইমপোর্ট করা

    OpenUPM-CLI

    আপনার OpenUPM-CLI ইনস্টল করা থাকলে, আপনার প্রোজেক্টের রুট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ড রান করিয়ে, আপনার প্রোজেক্টে Unity-এর জন্য Google Mobile Ads Mintegral Mediation Plugin ইনস্টল করতে পারবেন:

    openupm add com.google.ads.mobile.mediation.mintegral

    OpenUPM

    আপনার Unity প্রোজেক্ট এডিটরে, এডিট করুন > প্রোজেক্ট সেটিংস > প্যাকেজ ম্যানেজার বিকল্প বেছে নিয়ে Unity প্যাকেজ ম্যানেজার সেটিংস খুলুন।

    স্কোপড রেজিস্ট্রি ট্যাবের অধীনে, OpenUPM-কে স্কোপড রেজিস্ট্রি হিসেবে যোগ করুন নিম্নলিখিত বিবরণ সহ:

    • নাম: OpenUPM
    • URL: https://package.openupm.com
    • স্কোপ: com.google

    OpenUPM-এর বিবরণ

    তারপর, Unity Package Manager খুলতে উইন্ডো > প্যাকেজ ম্যানেজার বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

    Unity রেজিস্ট্রি

    Google Mobile Ads Mintegral Mediation প্যাকেজ বেছে নিয়ে ইনস্টল করুন বিকল্পে ক্লিক করুন।

    OpenUPM থেকে ইনস্টল করুন

    Unity প্যাকেজ

    Mintegral-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন। এটি পরিবর্তনের লগ থেকে ডাউনলোড লিঙ্কে পাবেন এবং zip ফাইল থেকে GoogleMobileAdsMintegralMediation.unitypackage এক্সট্র্যাক্ট করুন।

    আপনার Unity প্রোজেক্ট এডিটরে, অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ বেছে নিন এবং আপনার ডাউনলোড করা GoogleMobileAdsMintegralMediation.unitypackage ফাইলটি খুঁজুন। সব ফাইল বেছে নেওয়া হয়েছে কিনা তা দেখে নিয়ে ইমপোর্ট করুন বিকল্পে ক্লিক করুন।

    Unity থেকে ইমপোর্ট করুন

    তারপর, অ্যাসেট > এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার > Android Resolver > Force Resolve বিকল্প বেছে নিন। এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার লাইব্রেরি শুরু থেকে ডিপেন্ডেন্সি রেজোলিউশন পারফর্ম করবে এবং ঘোষিত ডিপেন্ডেন্সি আপনার Unity অ্যাপের Assets/Plugins/Android ডিরেক্টরিতে কপি করবে।

    জোর করে সমাধান করা

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

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

    Mintegral Unity অ্যাডাপ্টার ভার্সন 2.2.3 এবং পরবর্তী ভার্সন, 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 Unity Mediation Plugin Changelog

    ভার্সন ২.২.৬

    ভার্সন ২.২.৫

    ভার্সন ২.২.৪

    ভার্সন ২.২.৩

    ভার্সন ২.২.২

    ভার্সন ২.২.১

    ভার্সন ২.২.০

    ভার্সন ২.১.০

    ভার্সন ২.০.৬

    ভার্সন ২.০.৫

    ভার্সন 2.0.4

    ভার্সন 2.0.3

    ভার্সন ২.০.২

    ভার্সন ২.০.১

    ভার্সন 2.0.0

    ভার্সন ১.৯.৮

    ভার্সন 1.9.7

    ভার্সন 1.9.6

    ভার্সন ১.৯.৫

    ভার্সন ১.৯.৪

    ভার্সন ১.৯.৩

    ভার্সন 1.9.2

    ভার্সন 1.9.1

    ভার্সন 1.9.0

    ভার্সন 1.8.4

    ভার্সন 1.8.3

    ভার্সন ১.৮.২

    ভার্সন 1.8.1

    ভার্সন 1.8.0

    ভার্সন 1.7.0

    ভার্সন ১.৬.৫

    ভার্সন 1.6.4

    ভার্সন ১.৬.৩

    ভার্সন ১.৬.২

    ভার্সন ১.৬.১

    ভার্সন 1.6.0

    ভার্সন 1.5.0

    ভার্সন 1.4.0

    ভার্সন 1.3.0

    ভার্সন ১.২.১

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0