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

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

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

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

DT Exchange-এর জন্য Unity মধ্যস্থতা অ্যাডাপ্টরের নিম্নলিখিত ক্ষমতা আছে:

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

পূর্বশর্ত

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

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

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

নতুন অ্যাপ ও বিজ্ঞাপন প্লেসমেন্ট যোগ করা

DT Exchange কনসোলে সাইন-আপ করুন অথবা লগ-ইন করুন।

অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।

অ্যাপ ম্যানেজ করা

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

Android

iOS

আপনার প্লেসমেন্টের নাম লিখুন এবং ধরন বেছে নিন। তারপর, প্লেসমেন্ট সেভ করুন বিকল্পে ক্লিক করুন।

সেট-আপ করুন

অ্যাপ আইডি ও প্লেসমেন্ট আইডি

বাঁদিকের নেভিগেশন বার খুলে অ্যাপ ম্যানেজমেন্ট বিকল্পে ক্লিক করুন।

অ্যাপ ম্যানেজমেন্ট পৃষ্ঠায়, আপনার অ্যাপের পাশে থাকা অ্যাপ আইডি নোট করে রাখুন।

আপনার অ্যাপ বেছে নিন এবং প্লেসমেন্ট ট্যাবে নেভিগেট করুন। প্লেসমেন্ট আইডি মনে রাখবেন।

প্লেসমেন্ট আইডি

প্রকাশক আইডি, কনজিউমার কী ও কনজিউমার সিক্রেট

বাঁদিকের মেনু থেকে আপনার ইউজারনেমে ক্লিক করে ব্যবহারকারীর প্রোফাইল বিকল্প বেছে নিন।

প্রকাশক আইডি, কনজিউমার কী এবং কনজিউমার সিক্রেট মনে রাখবেন, কারণ পরবর্তী ধাপে এগুলি প্রয়োজন হবে।

ব্যবহারকারীর প্রোফাইল

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

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

DT Exchange-এর জন্য app-ads.txt প্রয়োগ করতে, আপনার app-ads.txt ফাইলে DT যোগ করুন।

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

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

Android

নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

iOS

নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

জিডিপিআর (GDPR) ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনার তালিকায় DT Exchange যোগ করা

AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনার তালিকায় DT Exchange (Fyber Monetization) যোগ করতে ইউরোপিয়ান রেগুলেশন সেটিংস ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস লিঙ্কে গিয়ে ধাপগুলি অনুসরণ করুন।

ধাপ ৩: DT Exchange SDK ও অ্যাডাপ্টার ইমপোর্ট করা

OpenUPM-CLI

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

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

OpenUPM

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

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

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

OpenUPM-এর বিবরণ

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

Unity রেজিস্ট্রি

Google Mobile Ads DTExchange মধ্যস্থতা প্যাকেজ বেছে নিন এবং ইনস্টল করুন বিকল্পে ক্লিক করুন।

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

Unity প্যাকেজ

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

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

Unity থেকে ইমপোর্ট করা

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

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

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

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

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

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

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

DT Exchange ভার্সন 3.1.1-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইন SetCCPAString() মেথড সহ Fyber ক্লাস যোগ করেছে, যা আপনাকে DT Exchange-এ ম্যানুয়ালি সম্মতি সংক্রান্ত তথ্য পাস করতে দেয়। নিচে দেওয়া নমুনা কোড থেকে কীভাবে এই প্যারামিটারগুলি DT Exchange অ্যাডাপ্টরে পাঠাতে হয় তা জানতে পারবেন:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

আরও তথ্য এবং পদ্ধতিতে প্রদান করা যেতে পারে এমন ভ্যালু সম্পর্কে জানতে DT Exchange-এর CCPA ওপেন সোর্স নিবন্ধ দেখুন।

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

Android

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

iOS

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

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, DT Exchange-এর ডকুমেন্টেশন দেখুন।

ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

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

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

টেস্ট বিজ্ঞাপন যাচাই করা

আপনি DT Exchange থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে বিজ্ঞাপনের একটি সোর্স টেস্টিং চালু করুন। এর জন্য DT Exchange (বিডিং) ও DT Exchange (ওয়াটারফল) বিজ্ঞাপনের সোর্স ব্যবহার করুন।

সমস্যার কোড

অ্যাডাপ্টার DT Exchange থেকে বিজ্ঞাপন না পেলে, প্রকাশকরা নিচের ক্লাস থেকে ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে আসল সমস্যা চেক করতে পারেন:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

বিজ্ঞাপন লোড করা না গেলে DT Exchange অ্যাডাপ্টার যেসব কোড ও মেসেজ দেখায় সেগুলি এখানে দেওয়া হল:

Android

সমস্যার কোড কারণ
১০১ AdMob UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার নেই/ভুল।
103 অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন কোনও ব্যানার সাইজের সাথে মিলছে না।
১০৫ DT SDK একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার রিটার্ন করেছে।
106 বিজ্ঞাপন দেখানোর জন্য রেডি নয়।
107 কনটেক্সট অ্যাক্টিভিটি ইনস্ট্যান্স নয়।
108 বিজ্ঞাপন দেখানো যায়নি।
200-399 DT SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন।

iOS

সমস্যার কোড কারণ
0-10 DT SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য ডকুমেন্টেশন দেখুন।
১০১ AdMob UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার নেই/ভুল।
102 অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন কোনও ব্যানার সাইজের সাথে মিলছে না।
103 বিজ্ঞাপন দেখানো যায়নি কারণ বিজ্ঞাপন অবজেক্ট আগেই ব্যবহার করা হয়েছে।
104 বিজ্ঞাপন রেডি না থাকার কারণে DT Exchange বিজ্ঞাপন দেখানো যায়নি।
১০৫ DT SDK-তে ইনিশিয়ালাইজেশন সংক্রান্ত সমস্যা হয়েছে।

DT Exchange Unity মধ্যস্থতা প্লাগ-ইন পরিবর্তনের লগ

ভার্সন 3.5.13

ভার্সন 3.5.12

ভার্সন 3.5.11

ভার্সন ৩.৫.১০

ভার্সন ৩.৫.৯

ভার্সন 3.5.8

ভার্সন ৩.৫.৭

ভার্সন ৩.৫.৬

ভার্সন 3.5.5

ভার্সন ৩.৫.৪

ভার্সন 3.5.3

ভার্সন ৩.৫.২

ভার্সন ৩.৫.১

ভার্সন 3.5.0

ভার্সন 3.4.0

ভার্সন ৩.৩.১২

ভার্সন ৩.৩.১১

ভার্সন ৩.৩.১০

ভার্সন ৩.৩.৯

ভার্সন ৩.৩.৮

ভার্সন ৩.৩.৭

ভার্সন ৩.৩.৬

ভার্সন ৩.৩.৫

ভার্সন 3.3.4

ভার্সন 3.3.3

ভার্সন ৩.৩.২

ভার্সন ৩.৩.১

ভার্সন 3.3.0

ভার্সন ৩.২.১

ভার্সন ৩.২.০

ভার্সন ৩.১.১২

ভার্সন ৩.১১

ভার্সন ৩.১.১০

ভার্সন 3.1.8

ভার্সন ৩.১.৭

ভার্সন ৩.১.৬

ভার্সন ৩.১.৫

ভার্সন ৩.১.৪

ভার্সন ৩.১.৩

ভার্সন ৩.১.২

ভার্সন ৩.১.১

ভার্সন 3.1.0

ভার্সন ৩.০.২

ভার্সন 3.0.1

ভার্সন 3.0.0

ভার্সন 2.0.0

ভার্সন ১.৬.১

ভার্সন 1.6.0

ভার্সন ১.৫.২

ভার্সন ১.৫.১

ভার্সন 1.5.0

ভার্সন 1.4.0

ভার্সন 1.3.0

ভার্সন ১.২.৩

ভার্সন ১.২.২

ভার্সন ১.২.১

ভার্সন 1.2.0

ভার্সন 1.1.0

ভার্সন 1.0.0