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

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

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

ডিটি এক্সচেঞ্জের জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:

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

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

আবশ্যকতা

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

ধাপ ১: DT এক্সচেঞ্জ UI-তে কনফিগারেশন সেট আপ করুন

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

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

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

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

আপনার প্ল্যাটফর্ম এবং স্থান নির্বাচন করুন, বাকি ফর্মটি পূরণ করুন এবং তারপর Create App এ ক্লিক করুন।

আপনার প্লেসমেন্টের জন্য নাম লিখুন এবং প্রকারগুলি নির্বাচন করুন। তারপর, প্লেসমেন্ট সংরক্ষণ করুন এ ক্লিক করুন।

সেটআপ

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

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

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

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

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

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

বাম মেনু থেকে আপনার ব্যবহারকারীর নাম ক্লিক করুন এবং ব্যবহারকারীর প্রোফাইল নির্বাচন করুন।

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

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

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

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

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

ধাপ ২: অ্যাড ম্যানেজার UI-তে DT এক্সচেঞ্জ চাহিদা সেট আপ করুন

আপনার বিজ্ঞাপন পরিচালক অ্যাকাউন্টে সাইন ইন করুন।

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

বিডিং

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

জলপ্রপাত

অ্যাডমিন > কোম্পানিতে যান, তারপর All companies ট্যাবে New company বোতামে ক্লিক করুন। Ad network নির্বাচন করুন।

বিজ্ঞাপন নেটওয়ার্ক হিসেবে DT Exchange নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মধ্যস্থতা সক্ষম করুন। স্বয়ংক্রিয় ডেটা সংগ্রহ চালু করুন, এবং পূর্ববর্তী বিভাগে প্রাপ্ত প্রকাশক আইডি , গ্রাহক গোপনীয়তা এবং গ্রাহক কী লিখুন।

আপনার ব্যবহারকারীর নাম বা পাসওয়ার্ড প্রবেশ করার দরকার নেই। হয়ে গেলে সংরক্ষণ করুন এ ক্লিক করুন।

নিরাপদ সিগন্যাল শেয়ারিং সক্ষম করুন

বিডিং

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

জলপ্রপাত

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

বিড অনুরোধে নিরাপদ সিগন্যাল শেয়ার করুন

বিডিং

ইনভেন্টরি > সিকিউর সিগন্যাল এ নেভিগেট করুন। সিকিউর সিগন্যালের অধীনে, DT এক্সচেঞ্জ (ফাইবার মনিটাইজেশন) অনুসন্ধান করুন এবং অ্যাপ ইন্টিগ্রেশন সক্ষম করুন এ টগল করুন।

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

জলপ্রপাত

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

SDK বিডিংয়ের জন্য নিরাপদ সিগন্যাল শেয়ারিং মঞ্জুর করুন

বিডিং

ডেলিভারি > ডিমান্ড চ্যানেল সেটিংসে নেভিগেট করুন। ডিফল্ট সেটিংস ট্যাবে, SDK বিডিংয়ের জন্য নিরাপদ সিগন্যাল শেয়ারিং-এর অনুমতি দিন -এ টগল করুন।

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

জলপ্রপাত

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

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

বিডিং

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

নতুন দরদাতার নাম ক্লিক করুন।

দরদাতা হিসেবে DT Exchange নির্বাচন করুন।

এই দরদাতার জন্য SDK বিডিং সক্ষম করতে " চালিয়ে যান" এ ক্লিক করুন।

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

জলপ্রপাত

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

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

বিডিং

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

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

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

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

জলপ্রপাত

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

নিচে স্ক্রোল করুন এবং "Yield partner যোগ করুন" এ ক্লিক করুন।

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

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

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

জিডিপিআর এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালার বিজ্ঞাপন অংশীদারদের তালিকায় ডিটি এক্সচেঞ্জ (ফাইবার মনিটাইজেশন) যোগ করুন

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

ধাপ ৩: DT SDK এবং অ্যাডাপ্টার আমদানি করুন

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

কোটলিন

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03")
    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.24.0-beta03'
    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 ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণ (GDPR) এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে। আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পাঠানো হয়েছে কিনা তা যাচাই করার জন্য আপনার দায়িত্ব। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতি পছন্দ প্রেরণ করতে অক্ষম।

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

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

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

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

জাভা

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);

কোটলিন

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)

US_PRIVACY_STRING আপনার US গোপনীয়তা স্ট্রিং দিয়ে প্রতিস্থাপন করুন।

আরও বিস্তারিত জানার জন্য এবং পদ্ধতিতে প্রদত্ত মানগুলির জন্য DT এক্সচেঞ্জের CCPA বাস্তবায়ন নির্দেশিকা দেখুন।

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

কার্যকলাপ প্রসঙ্গ সহ বিজ্ঞাপন লোড করুন

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

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

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

আপনার পরীক্ষামূলক ডিভাইসটি বিজ্ঞাপন পরিচালকের জন্য নিবন্ধন করুন

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

আপনি DT Exchange থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, DT Exchange (বিডিং) এবং 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();

কোটলিন

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

ত্রুটি কোড

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

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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