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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

সেটআপ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

কোম্পানিগুলিতে ডিটি এক্সচেঞ্জ যোগ করুন

নিলাম

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

জলপ্রপাত

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

অ্যাড নেটওয়ার্ক হিসেবে ডিটি এক্সচেঞ্জ (DT Exchange) নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন (Mediation ) সক্ষম করুন। স্বয়ংক্রিয় ডেটা সংগ্রহ (Automatic data collection ) চালু করুন এবং পূর্ববর্তী বিভাগে প্রাপ্ত পাবলিশার আইডি (Publisher ID) , কনজিউমার সিক্রেট (Consumer Secret) ও কনজিউমার কী (Consumer Key) প্রবেশ করান।

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

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

নিলাম

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

জলপ্রপাত

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

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

নিলাম

Inventory > Secure Signals- এ যান। Secure signals- এর অধীনে, DT Exchange (Fyber Monetization) অনুসন্ধান করুন এবং Enable app integration টগলটি অন করুন।

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

জলপ্রপাত

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

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

নিলাম

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

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

জলপ্রপাত

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

ডিটি এক্সচেঞ্জ বিডিং কনফিগার করুন

নিলাম

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

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

বিডার হিসেবে ডিটি এক্সচেঞ্জকে নির্বাচন করুন।

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

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

জলপ্রপাত

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

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

নিলাম

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

ডিটি এক্সচেঞ্জের জন্য কোম্পানি নির্বাচন করুন।

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

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

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

জলপ্রপাত

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

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

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

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

দ্রষ্টব্য: একটি মিডিয়েশন নেটওয়ার্কের জন্য ডাইনামিক সিপিএম (Dynamic CPM) মান সঠিকভাবে গণনা করার আগে, স্বয়ংক্রিয় ডেটা সংগ্রহ প্রক্রিয়ায় কয়েক দিন সময় লাগে। একবার ইসিপিএম (eCPM) গণনা করা হয়ে গেলে, এটি আপনার পক্ষ থেকে স্বয়ংক্রিয়ভাবে আপডেট হয়ে যায়।

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

অ্যাড ম্যানেজার UI-তে ইউরোপীয় এবং মার্কিন রাজ্য বিধিমালা অ্যাড পার্টনার তালিকায় ডিটি এক্সচেঞ্জ (ফাইভার মনিটাইজেশন)-কে যুক্ত করতে, ইউরোপীয় বিধিমালা সেটিংস এবং মার্কিন রাজ্য বিধিমালা সেটিংস-এর ধাপগুলো অনুসরণ করুন।

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

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

কোটলিন 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:fyber:8.4.3.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:fyber:8.4.3.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

ধাপ ৪: 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)-তে ব্যবহারকারীর সম্মতি পাঠাতে দেয়। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে ডিটি এসডিকে-তে ম্যানুয়ালি সম্মতির তথ্য পাঠাতে হয়। আপনি যদি ডিটি এসডিকে-তে ম্যানুয়ালি সম্মতির তথ্য পাঠাতে চান, তবে GMA Next-Gen SDK এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এই কোডটি কল করার পরামর্শ দেওয়া হয়।

জাভা 

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);
DTExchangeMediationSnippets.java

কোটলিন 

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)
DTExchangeMediationSnippets.kt

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

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

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

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

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

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

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

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

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

আপনি 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.getAdSourceResponses() ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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