ডিটি এক্সচেঞ্জকে মধ্যস্থতার সাথে একীভূত করুন

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

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

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

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত

১. বিডিং ইন্টিগ্রেশন বর্তমানে ক্লোজড বিটা পর্যায়ে রয়েছে, অ্যাক্সেসের জন্য আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

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

  • সর্বশেষ Google Mobile Ads Unity Plugin
  • ইউনিটি ৪ বা উচ্চতর
  • [বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, DT Exchange 3.3.12 বা তার উচ্চতর সংস্করণের জন্য Google Mobile Ads মিডিয়েশন প্লাগইন ব্যবহার করুন ( সর্বশেষ সংস্করণ সুপারিশকৃত )।
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
  • Google Mobile Ads Unity Plugin দিয়ে কনফিগার করা একটি কার্যকরী ইউনিটি প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Unity Plugin সেট আপ করুন’ দেখুন।
  • AdMob মিডিয়েশন সেট আপ করুন

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

নতুন অ্যাপ এবং বিজ্ঞাপন স্থান যোগ করুন

ডিটি এক্সচেঞ্জ কনসোলে সাইন আপ করুন অথবা লগ ইন করুন

অ্যাপ যোগ করুন -এ ক্লিক করুন।

অ্যাপ পরিচালনা করুন

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

অ্যান্ড্রয়েড

আইওএস

আপনার প্লেসমেন্টের জন্য নামগুলো লিখুন এবং ধরন নির্বাচন করুন। তারপর, 'সেভ প্লেসমেন্ট'-এ ক্লিক করুন।

সেটআপ

অ্যাপ আইডি এবং প্লেসমেন্ট আইডি

বাম দিকের নেভিগেশন বারের উপর মাউস রাখলে সেটি খুলবে, তারপর অ্যাপ ম্যানেজমেন্ট-এ ক্লিক করুন।

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

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

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

প্রকাশক আইডি, গ্রাহক কী এবং গ্রাহক গোপনীয়তা

বাম দিকের মেনু থেকে আপনার ইউজারনেমে ক্লিক করুন এবং ইউজার প্রোফাইল নির্বাচন করুন।

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

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

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

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

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

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

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

অ্যান্ড্রয়েড

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

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

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

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

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

ওপেনইউপিএম-সিএলআই

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

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

ওপেনইউপিএম

আপনার ইউনিটি প্রজেক্ট এডিটরে, ইউনিটি প্যাকেজ ম্যানেজার সেটিংস খুলতে এডিট > প্রজেক্ট সেটিংস > প্যাকেজ ম্যানেজার নির্বাচন করুন।

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

  • নাম: OpenUPM
  • URL: https://package.openupm.com
  • স্কোপ(গুলি): com.google

ওপেনইউপিএম বিবরণ

এরপর, ইউনিটি প্যাকেজ ম্যানেজার খুলতে Window > Package Manager- এ যান এবং ড্রপ-ডাউন মেনু থেকে My Registries নির্বাচন করুন।

ইউনিটি রেজিস্ট্রি

Google Mobile Ads DTExchange Mediation প্যাকেজটি নির্বাচন করুন এবং Install-এ ক্লিক করুন।

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

ইউনিটি প্যাকেজ

চেঞ্জলগে দেওয়া ডাউনলোড লিঙ্ক থেকে DT Exchange-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং জিপ ফাইলটি থেকে GoogleMobileAdsDTExchangeMediation.unitypackage টি এক্সট্র্যাক্ট করুন।

আপনার ইউনিটি প্রজেক্ট এডিটরে, Assets > Import Package > Custom Package নির্বাচন করুন এবং আপনার ডাউনলোড করা GoogleMobileAdsDTExchangeMediation.unitypackage ফাইলটি খুঁজুন। নিশ্চিত করুন যে সমস্ত ফাইল নির্বাচিত আছে এবং Import-এ ক্লিক করুন।

ইউনিটি থেকে আমদানি করুন

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

ফোর্স রিজলভ

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

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

এই বিভাগে দেখানো হয়েছে কীভাবে ডিটি এক্সচেঞ্জের জন্য ব্যক্তিগতকৃত বিজ্ঞাপন চালু বা বন্ধ করতে হয়।

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

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

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

আরও তথ্যের জন্য এবং এই পদ্ধতিতে যে মানগুলি প্রদান করা যেতে পারে, সে সম্পর্কে জানতে ডিটি এক্সচেঞ্জ-এর জিডিপিআর নিবন্ধটি দেখুন।

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

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

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();

আরও তথ্যের জন্য এবং এই পদ্ধতিতে যে মানগুলি প্রদান করা যেতে পারে, তা জানতে ডিটি এক্সচেঞ্জ-এর সিসিপিএ ওপেন সোর্স নিবন্ধটি দেখুন।

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

অ্যান্ড্রয়েড

ডিটি এক্সচেঞ্জ ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

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

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

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

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

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

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

ত্রুটি কোড

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

অ্যান্ড্রয়েড

com.google.ads.mediation.fyber.FyberMediationAdapter

আইওএস

GADMediationAdapterFyber

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

অ্যান্ড্রয়েড

ত্রুটি কোড কারণ
১০১ AdMob UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটারগুলো অনুপস্থিত বা অবৈধ।
১০৩ অনুরোধ করা বিজ্ঞাপনের আকারটি ডিটি এক্সচেঞ্জ সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৫ ডিটি এসডিকে একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার ফেরত দিয়েছে।
১০৬ বিজ্ঞাপনটি প্রদর্শনের জন্য প্রস্তুত নয়।
১০৭ Context একটি অ্যাক্টিভিটি ইনস্ট্যান্স নয়।
২০০-৩৯৯ DT SDK একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে কোড দেখুন।

আইওএস

ত্রুটি কোড কারণ
০-১০ ডিটি এসডিকে একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে ডকুমেন্টেশন দেখুন।
১০১ AdMob UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটারগুলো অনুপস্থিত বা অবৈধ।
১০২ অনুরোধ করা বিজ্ঞাপনের আকারটি ডিটি এক্সচেঞ্জ সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৩ বিজ্ঞাপনটি দেখানো সম্ভব হয়নি কারণ বিজ্ঞাপন অবজেক্টটি ইতিমধ্যেই ব্যবহৃত হয়েছে।
১০৪ বিজ্ঞাপন প্রস্তুত না থাকায় ডিটি এক্সচেঞ্জ বিজ্ঞাপন দেখানো সম্ভব হয়নি।
১০৫ ডিটি এসডিকে একটি প্রারম্ভিক ত্রুটি দেখিয়েছে।

ডিটি এক্সচেঞ্জ ইউনিটি মিডিয়েশন প্লাগইন পরিবর্তন তালিকা

সংস্করণ ৩.৫.৬

সংস্করণ ৩.৫.৫

সংস্করণ ৩.৫.৪

সংস্করণ ৩.৫.৩

সংস্করণ ৩.৫.২

সংস্করণ ৩.৫.১

সংস্করণ ৩.৫.০

সংস্করণ ৩.৪.০

সংস্করণ ৩.৩.১২

সংস্করণ ৩.৩.১১

সংস্করণ ৩.৩.১০

সংস্করণ ৩.৩.৯

সংস্করণ ৩.৩.৮

সংস্করণ ৩.৩.৭

সংস্করণ ৩.৩.৬

সংস্করণ ৩.৩.৫

সংস্করণ ৩.৩.৪

সংস্করণ ৩.৩.৩

সংস্করণ ৩.৩.২

সংস্করণ ৩.৩.১

সংস্করণ ৩.৩.০

সংস্করণ ৩.২.১

সংস্করণ ৩.২.০

সংস্করণ ৩.১.১২

সংস্করণ ৩.১.১১

সংস্করণ ৩.১.১০

সংস্করণ ৩.১.৮

সংস্করণ ৩.১.৭

সংস্করণ ৩.১.৬

সংস্করণ ৩.১.৫

সংস্করণ ৩.১.৪

সংস্করণ ৩.১.৩

সংস্করণ ৩.১.২

সংস্করণ ৩.১.১

সংস্করণ ৩.১.০

সংস্করণ ৩.০.২

সংস্করণ ৩.০.১

সংস্করণ ৩.০.০

সংস্করণ ২.০.০

সংস্করণ ১.৬.১

সংস্করণ ১.৬.০

সংস্করণ ১.৫.২

সংস্করণ ১.৫.১

সংস্করণ ১.৫.০

সংস্করণ ১.৪.০

সংস্করণ ১.৩.০

সংস্করণ ১.২.৩

সংস্করণ ১.২.২

সংস্করণ ১.২.১

সংস্করণ ১.২.০

সংস্করণ ১.১.০

সংস্করণ ১.০.০