এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)

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

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

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

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

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

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

অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
[বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, DT Exchange অ্যাডাপ্টার 8.4.2.0 বা তার উচ্চতর সংস্করণ ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহারের পরামর্শ দেওয়া হচ্ছে )।

সর্বশেষ Google Mobile Ads SDK ।
মধ্যস্থতা শুরুর নির্দেশিকাটি সম্পূর্ণ করুন।

ধাপ ১: 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 ডিমান্ড সেট আপ করুন।

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

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

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

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

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

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

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

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

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

নিলাম

অ্যাড সোর্সেস সেকশনের বিডিং কার্ডের অধীনে, অ্যাড অ্যাড সোর্স নির্বাচন করুন। তারপর ডিটি এক্সচেঞ্জ নির্বাচন করুন।

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

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

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

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

জলপ্রপাত

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

DT Exchange নির্বাচন করুন এবং Optimize সুইচটি সক্রিয় করুন। DT Exchange-এর জন্য বিজ্ঞাপন উৎস অপ্টিমাইজেশন সেট আপ করতে পূর্ববর্তী বিভাগে প্রাপ্ত Publisher ID , Consumer Secret এবং Consumer Key প্রবেশ করান। তারপর DT Exchange-এর জন্য একটি eCPM মান প্রবেশ করান এবং Continue-তে ক্লিক করুন।

দ্রষ্টব্য : একটি মিডিয়েশন নেটওয়ার্কের জন্য eCPM সঠিকভাবে গণনা করার মতো পর্যাপ্ত ডেটা সংগ্রহ করতে অ্যাড সোর্স অপটিমাইজেশনের কয়েক দিন সময় লাগে। এই সময়ের মধ্যে, অ্যাড সোর্স অপটিমাইজেশনের স্ট্যাটাস PENDING থাকে, তাই আপনাকে নেটওয়ার্কটির জন্য ম্যানুয়ালি একটি eCPM ভ্যালু সেট করতে হবে। একবার eCPM গণনা করা সম্ভব হলে, অ্যাড সোর্সটি আপনার পক্ষ থেকে স্বয়ংক্রিয়ভাবে eCPM আপডেট করা শুরু করে।

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

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

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

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

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

কোটলিন

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.1.0")
    implementation("com.google.ads.mediation:fyber:8.4.3.0")
}

গ্রুভি

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.1.0'
    implementation 'com.google.ads.mediation:fyber:8.4.3.0'
}

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

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

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

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

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

DT Exchange SDK সংস্করণ 8.3.0 থেকে শুরু করে, DT Exchange স্বয়ংক্রিয়ভাবে সেইসব কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম দ্বারা নির্ধারিত GDPR সম্মতি পড়ে নেয়, যেগুলো Google-এর Additional Consent স্পেসিফিকেশন সমর্থন করে। আরও তথ্যের জন্য, DT Exchange GDPR ইমপ্লিমেন্টেশন গাইড দেখুন।

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

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

ডিটি এক্সচেঞ্জ-এ একটি এপিআই (API) রয়েছে যা আপনাকে তাদের এসডিকে (SDK)-তে ব্যবহারকারীর সম্মতি পাঠাতে দেয়। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে ডিটি এসডিকে-তে ম্যানুয়ালি সম্মতির তথ্য পাঠাতে হয়। আপনি যদি ডিটি এসডিকে-তে ম্যানুয়ালি সম্মতির তথ্য পাঠাতে চান, তবে Google Mobile Ads SDK এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এই কোডটি কল করার পরামর্শ দেওয়া হয়।

জাভা

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

কোটলিন

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

US_PRIVACY_STRING জায়গায় আপনার মার্কিন গোপনীয়তা স্ট্রিংটি বসান।

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

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

অ্যাক্টিভিটি কনটেক্সট সহ বিজ্ঞাপন লোড করুন

ইন্টারস্টিশিয়াল বিজ্ঞাপন ফরম্যাট লোড করার সময় Activity কনটেক্সট পাস করুন। অ্যাক্টিভিটি কনটেক্সট ছাড়া বিজ্ঞাপন লোড হবে না।

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

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

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

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

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

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

নেটওয়ার্ক-নির্দিষ্ট পরামিতি

DT Exchange অ্যাডাপ্টারটি অতিরিক্ত রিকোয়েস্ট প্যারামিটার সমর্থন করে, যেগুলো একটি অ্যান্ড্রয়েড বান্ডেল হিসেবে অ্যাডাপ্টারে পাঠানো যায়। অ্যাডাপ্টারটি বান্ডেলের মধ্যে নিম্নলিখিত কী-গুলো খুঁজে থাকে:

অনুরোধের প্যারামিটার এবং মান
`InneractiveMediationDefs.KEY_AGE`	পূর্ণসংখ্যা । ব্যবহারকারীর বয়স।
`FyberMediationAdapter.KEY_MUTE_VIDEO`	বুলিয়ান . ভিডিও মিউট বা আনমিউট করুন

এই বিজ্ঞাপন অনুরোধের প্যারামিটারগুলো কীভাবে সেট করতে হয় তার একটি কোড উদাহরণ নিচে দেওয়া হলো:

জাভা

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter.class, extras).build();DTExchangeMediationSnippets.java

কোটলিন

val extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request =
  AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras).build()DTExchangeMediationSnippets.kt

ত্রুটি কোড

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

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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

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