আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

মেডিয়েশনের সাথে DT Exchange ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

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

কাজ করে এমন ইন্টিগ্রেশন ও বিজ্ঞাপন ফর্ম্যাট

DT Exchange-এর জন্য মধ্যস্থতা অ্যাডাপ্টরের নিম্নলিখিত ক্ষমতা আছে:

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

পূর্বশর্ত

এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করিয়ে নিন:

Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।

GMA Next-Gen SDK-এর লেটেস্ট ভার্সন।
মধ্যস্থতা সেট-আপ করুন।

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

নতুন অ্যাপ ও বিজ্ঞাপন প্লেসমেন্ট যোগ করা

DT Exchange কনসোলে সাইন-আপ করুন অথবা লগ-ইন করুন।

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

অ্যাপ ম্যানেজ করা

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

আপনার প্লেসমেন্টের নাম লিখুন এবং ধরন বেছে নিন। তারপর, প্লেসমেন্ট সেভ করুন বিকল্পে ক্লিক করুন।

সেট-আপ করুন

অ্যাপ আইডি ও প্লেসমেন্ট আইডি

বাঁদিকের নেভিগেশন বার খুলে অ্যাপ ম্যানেজমেন্ট বিকল্পে ক্লিক করুন।

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

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

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

প্রকাশক আইডি, কনজিউমার কী ও কনজিউমার সিক্রেট

বাঁদিকের মেনু থেকে আপনার ইউজারনেমে ক্লিক করে ব্যবহারকারীর প্রোফাইল বিকল্প বেছে নিন।

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

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

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

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

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

আপনার Ad Manager অ্যাকাউন্টে সাইন-ইন করুন।

কোম্পানিতে DT Exchange যোগ করা

বিডিং

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

জলপ্রপাত

অ্যাডমিন > কোম্পানি বিকল্পে নেভিগেট করুন, তারপর সব কোম্পানি ট্যাবে গিয়ে নতুন কোম্পানি বোতামে ক্লিক করুন। বিজ্ঞাপন নেটওয়ার্ক বেছে নিন।

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

আপনাকে ইউজারনেম বা পাসওয়ার্ড লিখতে হবে না। সম্পূর্ণ হয়ে গেলে সেভ করুন বিকল্পে ক্লিক করুন।

সুরক্ষিত সিগন্যাল শেয়ারিং চালু করা

বিডিং

অ্যাডমিন > গ্লোবাল সেটিংস বিকল্পে যান। Ad Exchange অ্যাকাউন্ট সেটিংস ট্যাবে যান এবং নিরাপদ সিগন্যাল শেয়ারিং পর্যালোচনা করে চালু করুন। সেভ করুন বিকল্পে ক্লিক করুন।

জলপ্রপাত

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

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

বিডিং

ইনভেনটরি > সুরক্ষিত সিগন্যাল বিকল্পে নেভিগেট করুন। নিরাপদ সিগন্যাল বিকল্পের মধ্যে, DT Exchange (Fyber Monetization) খুঁজে অ্যাপ ইন্টিগ্রেশন চালু করুন বিকল্প চালু করুন।

সেভ করুন বিকল্পে ক্লিক করুন।

জলপ্রপাত

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

SDK বিডিংয়ের জন্য নিরাপদ সিগন্যাল শেয়ার করার অনুমতি দেওয়া

বিডিং

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

সেভ করুন বিকল্পে ক্লিক করুন।

জলপ্রপাত

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

DT Exchange বিডিং কনফিগার করা

বিডিং

ডেলিভারি > বিডার বিকল্পে নেভিগেট করে SDK বিডিংয়ে যান বিকল্পে ক্লিক করুন।

নতুন বিডার বিকল্পে ক্লিক করুন।

বিডার হিসেবে DT Exchange বেছে নিন।

এই বিডারের জন্য SDK বিডিং চালু করতে চালিয়ে যান বিকল্পে ক্লিক করুন।

হয়ে গেছে বিকল্পে ক্লিক করুন।

জলপ্রপাত

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

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

বিডিং

ডেলিভারি > বিডার বিকল্পে নেভিগেট করে SDK বিডিংয়ে যান বিকল্পে ক্লিক করুন।

DT Exchange-এর জন্য কোম্পানি বেছে নিন।

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

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

সবশেষে, সেভ করুন বিকল্পে ক্লিক করুন।

জলপ্রপাত

ডেলিভারি > ইয়েল্ড গ্রুপ বিকল্পে নেভিগেট করে নতুন ইয়েল্ড গ্রুপ বোতামে ক্লিক করুন। আপনার ইনভেনটরি ও অ্যাপ বেছে নিন।

Yield পার্টনার বিকল্পে স্ক্রল করে যান এবং মধ্যস্থতাকারী পার্টনার যোগ করুন বিকল্পে ক্লিক করুন।

আগের বিভাগে DT Exchange-এর জন্য আপনার তৈরি করা কোম্পানি বেছে নিন। ইন্টিগ্রেশনের ধরন হিসেবে মোবাইল SDK মধ্যস্থতা, প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে অ্যাক্টিভ বেছে নিন।

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

জিডিপিআর (GDPR) ও মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনার তালিকায় DT Exchange (Fyber Monetization) যোগ করা

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

Ad Manager UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনার তালিকায় DT Exchange (Fyber Monetization) যোগ করতে ইউরোপিয়ান রেগুলেশন সেটিংস ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস লিঙ্কে গিয়ে ধাপগুলি অনুসরণ করুন।

ধাপ ৩: DT SDK ও অ্যাডাপ্টার ইমপোর্ট করা

Android Studio ইন্টিগ্রেশন (সাজেস্ট করা)

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:fyber:8.4.7.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:fyber:8.4.7.1'
}

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

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

Android-এর জন্য DT SDK-এর লেটেস্ট ভার্সন ডাউনলোড করুন এবং আপনার প্রোজেক্টে fyber-marketplace-x.y.z.aar যোগ করুন।
Google-এর Maven Repository-তে DT Exchange অ্যাডাপ্টার আর্টিফ্যাক্ট নেভিগেট করুন। লেটেস্ট ভার্সন বেছে নিন, DT Exchange অ্যাডাপ্টরের .aar ফাইল ডাউনলোড করুন এবং সেটি আপনার প্রোজেক্টে যোগ করুন।

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

EU সম্মতি ও GDPR

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

DT Exchange Android অ্যাডাপ্টার ভার্সন 8.3.0.0 এবং এর পরবর্তী যেকোনও ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্ক (TCF) এর সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে DT Exchange SDK-তে GDPR সম্মতি সিগন্যাল পাস করার সুবিধা দেয়। আরও তথ্যের জন্য, দেখুন জিডিপিআর (GDPR)।

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

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

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

Java

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

Kotlin

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

US_PRIVACY_STRING-এর জায়গায় আপনার মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা স্ট্রিং লিখুন।

আরও বিবরণ ও পদ্ধতিতে প্রদান করা যেতে পারে এমন ভ্যালু পেতে DT Exchange-এর CCPA প্রয়োগ সংক্রান্ত নির্দেশিকা দেখুন।

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

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

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

ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

টেস্ট বিজ্ঞাপন চালু করা

Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা ভালোভাবে দেখে নিন।

টেস্ট বিজ্ঞাপন যাচাই করা

আপনি DT Exchange থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে বিজ্ঞাপনের একটি সোর্স টেস্টিং চালু করুন। এর জন্য DT Exchange (বিডিং) ও DT Exchange (ওয়াটারফল) বিজ্ঞাপনের সোর্স ব্যবহার করুন।

ঐচ্ছিক ধাপ

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

DT Exchange অ্যাডাপ্টার অতিরিক্ত অনুরোধ প্যারামিটার সমর্থন করে যা Android Bundle হিসেবে অ্যাডাপ্টারে পাস করা যেতে পারে। বান্ডেলে অ্যাডাপ্টার নিম্নলিখিত কী খোঁজে:

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

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

Java

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

Kotlin

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

সমস্যার কোড

অ্যাডাপ্টার DT Exchange থেকে বিজ্ঞাপন না পেলে, আপনি বিজ্ঞাপন থেকে পাওয়া উত্তরের অন্তর্নিহিত সমস্যা চেক করতে পারেন। এটি করতে ResponseInfo.getAdSourceResponses() নিচের ক্লাস ব্যবহার করুন:

com.google.ads.mediation.fyber.FyberMediationAdapter

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

সমস্যার কোড	কারণ
১০১	Ad Manager UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার অনুপস্থিত/ভুল।
103	অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন কোনও ব্যানার সাইজের সাথে মিলছে না।
১০৫	DT SDK একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার রিটার্ন করেছে।
106	বিজ্ঞাপন দেখানোর জন্য রেডি নয়।
107	কনটেক্সট অ্যাক্টিভিটি ইনস্ট্যান্স নয়।
108	বিজ্ঞাপন দেখানো যায়নি।
200-399	DT SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন।

DT Exchange Android মধ্যস্থতা অ্যাডাপ্টরের পরিবর্তনের লগ