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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Choose your platform and placements, fill out the rest of the form, and then click Create App .

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

সেটআপ

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

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

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

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

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

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

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

Take note of the Publisher ID , Consumer Key , and Consumer Secret as these are needed in the next step.

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

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

To implement app-ads.txt for DT Exchange, Add DT to your app-ads.txt file .

ধাপ ২: 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)-কে যুক্ত করতে, ইউরোপীয় বিধিমালা সেটিংস এবং মার্কিন রাজ্য বিধিমালা সেটিংস-এর ধাপগুলো অনুসরণ করুন।

Step 3: Import the DT SDK and adapter

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

In your app-level gradle file, add the following implementation dependencies:

কোটলিন

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

গ্রুভি

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

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

অ্যান্ড্রয়েডের জন্য ডিটি এসডিকে -র সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং আপনার প্রজেক্টে 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 (Legacy) এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এই কোডটি কল করার পরামর্শ দেওয়া হয়।

জাভা

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

কোটলিন

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

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

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

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

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

Pass Activity context when loading Interstitial ad formats. Without activity context, ad load will fail.

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

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

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

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

To verify that you are receiving test ads from DT Exchange, enable single ad source testing in ad inspector using the DT Exchange (Bidding) and DT Exchange (Waterfall) ad source(s).

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

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

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

ত্রুটি কোড

If the adapter fails to receive an ad from DT Exchange, you can check the underlying error from the ad response using ResponseInfo.getAdapterResponses() under the following class:

com.google.ads.mediation.fyber.FyberMediationAdapter

Here are the codes and accompanying messages thrown by the DT Exchange adapter when an ad fails to load:

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