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

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

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

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

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

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

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

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

পূর্বশর্ত

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

Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
[বিডিংয়ের জন্য]: বিডিংয়ে কাজ করে এমন সব বিজ্ঞাপন ফর্ম্যাট ইন্টিগ্রেট করতে, DT Exchange অ্যাডাপ্টার 8.4.2.0 বা তার পরের ভার্সন (লেটেস্ট ভার্সন সাজেস্ট করা হয়েছে) ব্যবহার করুন।

লেটেস্ট Google Mobile Ads SDK (Legacy) ভার্সন।
AdMob মেডিয়েশন সেট-আপ করুন।

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

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

DT Exchange Console-এ সাইন-আপ বা লগ-ইন করুন।

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

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

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

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

সেট-আপ করুন

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

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

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

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

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

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

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

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

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

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

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

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

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

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা কনফিগারেশনে DT Exchange যোগ করতে হবে।

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

নতুন মধ্যস্থতা গ্রুপ তৈরি করতে, মধ্যস্থতা গ্রুপ তৈরি করুন বিকল্প বেছে নিন।

আপনার বিজ্ঞাপনের ফর্ম্যাট ও প্ল্যাটফর্ম লিখুন, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।

আপনার মধ্যস্থতা গ্রুপের নাম দিন এবং টার্গেট করার জন্য লোকেশন বেছে নিন। এরপর, মধ্যস্থতা গ্রুপের স্ট্যাটাস চালু করা আছে হিসেবে সেট করুন এবং তারপরে বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।

আপনার আগে থেকে থাকা এক বা একাধিক AdMob বিজ্ঞাপন ইউনিটের সাথে এই মধ্যস্থতা গ্রুপ যুক্ত করুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

আপনি এখন বিজ্ঞাপন ইউনিটের কার্ডে আপনার বেছে নেওয়া বিজ্ঞাপন ইউনিট দেখতে পাবেন:

বিজ্ঞাপন সোর্স হিসেবে DT Exchange যোগ করুন

বিডিং

বিজ্ঞাপনের সোর্স বিভাগে, বিডিং কার্ড খুঁজে নিন এবং বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন। তারপর DT Exchange বেছে নিন .

কীভাবে পার্টনারশিপ চুক্তিতে স্বাক্ষর করতে হয় এবং DT Exchange-এর সাথে বিডিং পার্টনারশিপ সেট-আপ করতে হয় তা জানতে ক্লিক করুন।

স্বীকার করুন ও সম্মতি দিন বিকল্পে ক্লিক করুন, তারপর চালিয়ে যান বিকল্পে ক্লিক করুন।

DT Exchange-এর জন্য আপনার আগে থেকেই ম্যাপিং থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।

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

জলপ্রপাত

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

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

DT Exchange-এর জন্য আপনার কাছে আগে থেকেই ম্যাপিং থাকলে, আপনি সেটি বেছে নিতে পারবেন। অন্যথায়, ম্যাপিং যোগ করুন বিকল্পে ক্লিক করুন।

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

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

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

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

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

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

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

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

Kotlin

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

Groovy

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

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

Android-এর জন্য DT SDK-এর লেটেস্ট ভার্সন ডাউনলোড করুন এবং আপনার প্রোজেক্টে fyber-marketplace-x.y.z.aar যোগ করুন।
Google-এর Maven রিপোজিটরিতে 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 বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।

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

Java

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);DTExchangeMediationSnippets.java

Kotlin

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)DTExchangeMediationSnippets.kt

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

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

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

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

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

ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করা

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

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

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

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

ঐচ্ছিক ধাপ

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

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

অনুরোধের প্যারামিটার ও ভ্যালু
`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.getAdapterResponses() ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন:

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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