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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

নিলাম

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

জলপ্রপাত

আপনার অ্যাড ম্যানেজার অ্যাড ইউনিট আইডি সেট আপ করার জন্য আপনার মিন্টেগ্রাল রিপোর্টিং এপিআই কী (Mintegral Reporting API Key) প্রয়োজন হবে। অ্যাকাউন্ট > এপিআই টুলস (Account > API Tools) -এ যান। আপনার Skey এবং Secret লিখে রাখুন।

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

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

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

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

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

কোম্পানিগুলিতে মিন্টেগ্রাল যোগ করুন

নিলাম

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

জলপ্রপাত

অ্যাডমিন > কোম্পানিজ- এ যান, তারপর অল কোম্পানিজ ট্যাবে থাকা নিউ কোম্পানি বাটনে ক্লিক করুন। অ্যাড নেটওয়ার্ক নির্বাচন করুন।

অ্যাড নেটওয়ার্ক হিসেবে মিন্টেগ্রাল নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন সক্রিয় করুন।

আপনাকে কোনো ইউজারনেম বা পাসওয়ার্ড দিতে হবে না। কাজ শেষ হলে সেভ-এ ক্লিক করুন।

নিরাপদ সংকেত আদান-প্রদান সক্ষম করুন

নিলাম

অ্যাডমিন > গ্লোবাল সেটিংস- এ যান। অ্যাড এক্সচেঞ্জ অ্যাকাউন্ট সেটিংস ট্যাবে যান এবং ‘সিকিওর সিগন্যাল শেয়ারিং’ পর্যালোচনা করে সেটি চালু করুন। ‘সেভ’- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

দরপত্রের অনুরোধে সুরক্ষিত সংকেত শেয়ার করুন

নিলাম

Inventory > Secure Signals- এ যান। Secure signals- এর অধীনে, Mobvista/Mintegral অনুসন্ধান করুন এবং Enable app integration টগলটি অন করুন।

সংরক্ষণ করুন- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

SDK বিডিং-এর জন্য নিরাপদ সিগন্যাল শেয়ারিং-এর অনুমতি দিন

নিলাম

ডেলিভারি > ডিমান্ড চ্যানেল সেটিংস- এ যান। ডিফল্ট সেটিংস ট্যাবে, SDK বিডিং-এর জন্য ‘Allow secure signal sharing’ অপশনটি চালু করুন।

সংরক্ষণ করুন- এ ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

মিন্টেগ্রাল বিডিং কনফিগার করুন

নিলাম

ডেলিভারি > বিডার্স- এ যান এবং গো টু এসডিকে বিডিং-এ ক্লিক করুন।

নতুন দরদাতা-তে ক্লিক করুন।

দরদাতা হিসেবে মিন্টেগ্রালকে নির্বাচন করুন।

এই বিডারের জন্য SDK বিডিং সক্রিয় করতে ' চালিয়ে যান'-এ ক্লিক করুন।

সম্পন্ন ক্লিক করুন।

জলপ্রপাত

ওয়াটারফল ইন্টিগ্রেশনের জন্য এই ধাপটির প্রয়োজন নেই।

বিজ্ঞাপন ইউনিট ম্যাপিং কনফিগার করুন

নিলাম

ডেলিভারি > বিডার্স- এ যান এবং গো টু এসডিকে বিডিং-এ ক্লিক করুন।

মিন্টেগ্রালের জন্য কোম্পানি নির্বাচন করুন।

অ্যাড ইউনিট ম্যাপিং ট্যাবে যান এবং নতুন অ্যাড ইউনিট ম্যাপিং-এ ক্লিক করুন।

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

অবশেষে, সেভ-এ ক্লিক করুন।

জলপ্রপাত

ডেলিভারি > ইল্ড গ্রুপস -এ যান এবং নিউ ইল্ড গ্রুপ বোতামে ক্লিক করুন। আপনার মোবাইল অ্যাপ্লিকেশনটি নির্বাচন করুন।

নিচে স্ক্রোল করুন এবং ‘Add yield partner’-এ ক্লিক করুন।

পূর্ববর্তী বিভাগে Mintegral-এর জন্য আপনার তৈরি করা কোম্পানিটি নির্বাচন করুন। ইন্টিগ্রেশন টাইপ হিসেবে মোবাইল এসডিকে মিডিয়েশন , প্ল্যাটফর্ম হিসেবে অ্যান্ড্রয়েড এবং স্ট্যাটাস হিসেবে অ্যাক্টিভ বেছে নিন।

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

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

অ্যাড ম্যানেজার 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 ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।

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

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

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারের জন্য রেজিস্টার করা নিশ্চিত করুন।

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

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

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

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

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

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

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

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

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

মাঠ মিন্টেগ্রাল অ্যাডাপ্টার দ্বারা অ্যাসেটগুলি সর্বদা অন্তর্ভুক্ত থাকে।
শিরোনাম
ছবি ১
শরীর
আইকন
পদক্ষেপ গ্রহণের আহ্বান
তারকা রেটিং
দোকান
মূল্য
বিজ্ঞাপনদাতা

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

ত্রুটি কোড

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

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

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

ত্রুটি কোড ডোমেইন কারণ
১০১ com.google.ads.mediation.mintegral অবৈধ সার্ভার প্যারামিটার (যেমন অ্যাপ আইডি বা প্লেসমেন্ট আইডি অনুপস্থিত)।
১০২ com.google.ads.mediation.mintegral অনুরোধ করা বিজ্ঞাপনের আকারটি মিন্টেগ্র্যাল সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৩ com.google.ads.mediation.mintegral বিড প্রতিক্রিয়া অনুপস্থিত বা অবৈধ।
১০৪ com.google.ads.mediation.mintegral Mintegral SDK একটি 'no fill' ত্রুটি দেখিয়েছে।