AdMob মেডিয়েশনের সাথে Mintegral ইন্টিগ্রেট করা

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

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

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

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

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

পূর্বশর্ত

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

• লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
• React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
• Android-এ ডিপ্লয় করতে
  • Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
• iOS-এ ডিপ্লয় করতে
  • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
• একটি কার্যকরী React Native প্রোজেক্ট যা Google Mobile Ads SDK for React Native-এর সাথে কনফিগার করা হয়েছে। আরও বিবরণের জন্য Google Mobile Ads SDK for React Native সেট-আপ করুন দেখুন।
  • gma-sdk-react-native ফোল্ডার থেকে adapters ফোল্ডার ডাউনলোড ও এক্সট্র্যাক্ট করেছেন কিনা তা নিশ্চিত করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, Google Mobile Ads SDK for React Native ইনস্টল করুন বিকল্পে গিয়ে এক, দুই ও তিন নম্বর ধাপ অনুসরণ করুন।
• AdMob মেডিয়েশন সেট-আপ করুন।

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

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

অ্যাপ কী খুঁজে নিন

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

গুরুত্বপূর্ণ: নেটিভ বিজ্ঞাপন ফর্ম্যাটের জন্য, বিজ্ঞাপন ফর্ম্যাট হিসেবে নেটিভ (কাস্টম রেন্ডারিং) বিকল্প বেছে নিন।

বিডিং

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

জলপ্রপাত

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

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

Android

iOS

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

Android

iOS

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

বিডিং

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

জলপ্রপাত

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

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

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

মনে রাখবেন: মানানসই Mintegral এবং Google Mobile Ads SDK for React Native ভার্সন ইন্টিগ্রেট করতে না পারলে, বিল্ড সংক্রান্ত সমস্যা হতে পারে।

আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, Mintegral-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি gma-sdk-react-native/adapters/mintegral/ ডিরেক্টরি থেকে আপনার প্রোজেক্টের local_packages/ ডিরেক্টরিতে কপি করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/mintegral/gma-mediation-mintegral-0.1.0.tgz local_packages/
   

   EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।

2. আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:

   npm

   npm install ./local_packages/gma-mediation-mintegral-0.1.0.tgz
   

   তন্তু

   yarn add ./local_packages/gma-mediation-mintegral-0.1.0.tgz
   

3. আপনি Android-এর জন্য তৈরি করলে, আপনার প্রোজেক্টের android ডিরেক্টরিতে build.gradle ফাইলে নিম্নলিখিত রিপোজিটরি যোগ করুন:

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

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

EU কনসেন্ট ও জিডিপিআর (GDPR)

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

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

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

Android

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

iOS

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

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

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

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

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

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

গুরুত্বপূর্ণ: আপনার অ্যাপ রিলিজ করার আগে AdMob এবং 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-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না।

ভার্সন 0.1.0

• প্রাথমিক রিলিজ।

• Mintegral Android অ্যাডাপ্টার ভার্সন 17.1.61.1 কাজ করে।
• Mintegral iOS অ্যাডাপ্টার ভার্সন 8.1.7.0 কাজ করে।
• Google Mobile Ads React Native প্লাগ-ইন ভার্সন 0.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।