মধ্যস্থতার সাথে মিন্টেগ্রালকে একীভূত করুন

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে GMA Next-Gen SDK ব্যবহার করে AdMob মিডিয়েশনের মাধ্যমে Mintegral থেকে বিজ্ঞাপন লোড ও প্রদর্শন করা যায়, যেখানে ওয়াটারফল এবং বিডিং উভয় ইন্টিগ্রেশনই অন্তর্ভুক্ত। এতে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে কিভাবে Mintegral যোগ করতে হয় এবং একটি অ্যান্ড্রয়েড অ্যাপে কিভাবে Mintegral SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করতে হয়, তা আলোচনা করা হয়েছে।

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

মিন্টেগ্রালের মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

প্রয়োজনীয়তা

• অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি

• [বিডিং-এর জন্য]: বিডিং-এ সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, Mintegral অ্যাডাপ্টার 16.5.91.1 বা উচ্চতর সংস্করণ ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহার করার পরামর্শ দেওয়া হচ্ছে )।

• সর্বশেষ GMA Next-Gen SDK ।

• মধ্যস্থতা শুরুর নির্দেশিকাটি সম্পূর্ণ করুন।

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

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

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

অ্যাপ সেটিং ট্যাবে যান এবং অ্যাপ কী-টি লিখে নিন।

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

অ্যাপ সেটিং ট্যাব থেকে, অ্যাড অ্যাপ বাটনে ক্লিক করুন।

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

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

একটি বিজ্ঞাপন স্থান তৈরি করুন

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

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

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

1 AD Units ড্রপডাউনে ক্লিক করুন এবং AD Unit ID-টি নোট করে নিন।

আপনার মিন্টেগ্রাল রিপোর্টিং এপিআই কী খুঁজুন

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

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

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

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

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

আপনার অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে মিনইন্টিগ্রাল যোগ করতে হবে।

প্রথমে, আপনার AdMob অ্যাকাউন্টে সাইন ইন করুন। এরপর, মিডিয়েশন ট্যাবে যান। আপনার যদি আগে থেকে থাকা কোনো মিডিয়েশন গ্রুপ থাকে যা আপনি পরিবর্তন করতে চান, তবে সেটি সম্পাদনা করার জন্য সেই মিডিয়েশন গ্রুপের নামের উপর ক্লিক করুন এবং সরাসরি 'অ্যাড মিন্টেগ্রাল অ্যাজ অ্যান অ্যাড সোর্স' অংশে চলে যান।

নতুন মধ্যস্থতা গোষ্ঠী তৈরি করতে, ‘মধ্যস্থতা গোষ্ঠী তৈরি করুন’ নির্বাচন করুন।

আপনার বিজ্ঞাপনের ধরণ ও প্ল্যাটফর্ম লিখুন, তারপর 'চালিয়ে যান'-এ ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের একটি নাম দিন এবং টার্গেট করার জন্য লোকেশন নির্বাচন করুন। এরপর, মিডিয়েশন গ্রুপের স্ট্যাটাস ‘এনাবলড’- এ সেট করুন এবং তারপর ‘অ্যাড অ্যাড ইউনিটস’-এ ক্লিক করুন।

এই মিডিয়েশন গ্রুপটিকে আপনার বিদ্যমান এক বা একাধিক AdMob অ্যাড ইউনিটের সাথে যুক্ত করুন। তারপর 'Done'-এ ক্লিক করুন।

এখন আপনি অ্যাড ইউনিট কার্ডটিতে আপনার নির্বাচিত অ্যাড ইউনিটগুলো দেখতে পাবেন:

বিজ্ঞাপনের উৎস হিসেবে মিন্টেগ্রাল যোগ করুন

নিলাম

বিডিং কার্ডের অধীনে অ্যাড সোর্সেস সেকশনে, অ্যাড অ্যাড সোর্স নির্বাচন করুন। তারপর মিনইন্টিগ্রাল নির্বাচন করুন।

মিন্টেগ্রালের সাথে কীভাবে একটি অংশীদারিত্ব চুক্তি স্বাক্ষর করবেন এবং একটি বিডিং অংশীদারিত্ব স্থাপন করবেন , তা জানতে ক্লিক করুন।



স্বীকৃতি ও সম্মতিতে ক্লিক করুন, তারপর চালিয়ে যান-এ ক্লিক করুন।



আপনার যদি আগে থেকেই মিনইন্টিগ্রালের জন্য কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, ‘অ্যাড ম্যাপিং’-এ ক্লিক করুন।



এরপর, পূর্ববর্তী অংশে প্রাপ্ত অ্যাপ কী , অ্যাপ আইডি , প্লেসমেন্ট আইডি এবং অ্যাড ইউনিট আইডি লিখুন। তারপর 'সম্পন্ন' (Done ) বোতামে ক্লিক করুন।

জলপ্রপাত

Ad Sources সেকশনের Waterfall কার্ডের অধীনে, Add Ad Source নির্বাচন করুন।

Mintegral নির্বাচন করুন। তারপর Mintegral-এর জন্য একটি eCPM মান লিখুন এবং Continue-তে ক্লিক করুন।



আপনার যদি আগে থেকেই মিনইন্টিগ্রালের জন্য কোনো ম্যাপিং থাকে, তাহলে সেটি নির্বাচন করতে পারেন। অন্যথায়, ‘অ্যাড ম্যাপিং’-এ ক্লিক করুন।

এরপর, পূর্ববর্তী অংশে প্রাপ্ত অ্যাপ কী , অ্যাপ আইডি , প্লেসমেন্ট আইডি এবং অ্যাড ইউনিট আইডি লিখুন। তারপর 'সম্পন্ন' (Done ) বোতামে ক্লিক করুন।

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা সংক্রান্ত বিজ্ঞাপন অংশীদারদের তালিকায় Mobvista/Mintegral-কে যুক্ত করুন

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

ধাপ ৩: Mintegral SDK এবং অ্যাডাপ্টার ইম্পোর্ট করুন

অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)

আপনার প্রোজেক্ট-স্তরের settings.gradle.kts ফাইলে নিম্নলিখিত রিপোজিটরিগুলো যোগ করুন:

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

আপনার অ্যাপ-লেভেলের গ্রেডল ফাইলে নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি এবং কনফিগারেশনগুলো যোগ করুন:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mintegral:17.0.91.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mintegral:17.0.91.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

1. Mintegral SDK অন্তর্ভুক্ত করতে, Android-এর জন্য Mintegral SDK- তে যান।

2. গুগলের মেভেন রিপোজিটরিতে থাকা মিনইন্টিগ্রাল অ্যাডাপ্টার আর্টিফ্যাক্টস -এ যান। সর্বশেষ সংস্করণটি নির্বাচন করুন, মিনইন্টিগ্রাল অ্যাডাপ্টারের .aar ফাইলটি ডাউনলোড করুন এবং আপনার প্রোজেক্টে যোগ করুন।

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

ইইউ সম্মতি এবং জিডিপিআর

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

Mintegral SDK-তে সম্মতির তথ্য প্রেরণ করার জন্য setConsentStatus মেথডটি অন্তর্ভুক্ত রয়েছে।

নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে Mintegral SDK-তে সম্মতির তথ্য পাঠাতে হয়। এই অপশনগুলো যেন Mintegral SDK-তে সঠিকভাবে পাঠানো হয়, তা নিশ্চিত করার জন্য GMA Next-Gen SDK চালু করার আগেই এগুলো সেট করতে হবে।

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);
MintegralMediationSnippets.java

val sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)
MintegralMediationSnippets.kt

আরও তথ্যের জন্য মিন্টেগ্রালের গোপনীয়তা সংক্রান্ত নথিপত্র দেখুন।

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন

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

Mintegral SDK-তে সম্মতির তথ্য প্রেরণ করার জন্য setDoNotTrackStatus মেথডটি অন্তর্ভুক্ত রয়েছে।

নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে Mintegral SDK-তে সম্মতির তথ্য পাঠাতে হয়। যদি আপনার এই মেথডটি কল করার প্রয়োজন হয়, তবে GMA Next- GMA Next-Gen SDK GMA Next-Gen SDK করার পরে কিন্তু এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি কল করুন।

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);
MintegralMediationSnippets.java

val sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setDoNotTrackStatus(false)
MintegralMediationSnippets.kt

আরও তথ্যের জন্য মিন্টেগ্রালের গোপনীয়তা সংক্রান্ত নথিপত্র দেখুন।

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

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

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

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

ব্যানার, ইন্টারস্টিশিয়াল, রিওয়ার্ডেড এবং নেটিভ অ্যাড ফরম্যাটের জন্য মিন্টেগ্রাল টেস্ট অ্যাড পেতে, মিন্টেগ্রাল তাদের টেস্ট আইডি পেজে দেওয়া অ্যাপ কী, অ্যাপ আইডি, প্লেসমেন্ট আইডি এবং অ্যাড ইউনিট আইডি ব্যবহার করার পরামর্শ দেয়।

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

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

ঐচ্ছিক পদক্ষেপ

CCPA বিজ্ঞাপন অংশীদারদের তালিকায় মিন্টেগ্রালকে যুক্ত করুন

AdMob UI-তে CCPA বিজ্ঞাপন অংশীদারদের তালিকায় Mintegral-কে যুক্ত করতে CCPA সেটিংসে দেওয়া ধাপগুলো অনুসরণ করুন।

স্থানীয় বিজ্ঞাপন

বিজ্ঞাপন রেন্ডারিং

মিন্টেগ্রাল অ্যাডাপ্টার তার নেটিভ অ্যাডগুলোকে NativeAd অবজেক্ট হিসেবে ফেরত দেয়। এটি একটি NativeAd এর জন্য নিম্নলিখিত ফিল্ডগুলো পূরণ করে।

^{মিন্টেগ্রাল} অ্যাডাপ্টার তার নেটিভ বিজ্ঞাপনগুলির জন্য মূল ইমেজ অ্যাসেটে সরাসরি অ্যাক্সেস দেয় না। পরিবর্তে, অ্যাডাপ্টারটি MediaView একটি ভিডিও বা একটি ছবি যুক্ত করে।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি Mintegral থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে আপনি নিম্নলিখিত ক্লাসগুলির অধীনে ResponseInfo.getAdSourceResponses() ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

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

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন মিন্টেগ্রাল অ্যাডাপ্টার কর্তৃক প্রদর্শিত কোড এবং সংশ্লিষ্ট বার্তাগুলো নিচে দেওয়া হলো: