এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads Flutter Plugin ব্যবহার করে মধ্যস্থতা-এর মাধ্যমে DT Exchange থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, যার মধ্যে ওয়াটারফল ইন্টিগ্রেশনও কভার করা হয়। এটি কভার করে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে DT Exchange যোগ করতে হয় এবং কীভাবে DT Exchange SDK এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপে ইন্টিগ্রেট করতে হয়।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
DT Exchange-এর জন্য Flutter মিডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| ব্যানার | |
| স্থান | |
| পুরস্কার জিতেছেন | |
| নেটিভ | |
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:
- লেটেস্ট Google Mobile Ads Flutter Plugin ভার্সন।
- Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Android-এ ডিপ্লয় করতে
- Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
- iOS-এ ডিপ্লয় করতে
- iOS ডেপ্লয়মেন্ট টার্গেট 15.0 বা তার পরের যেকোনও ভার্সন।
- Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads Flutter Plugin সেট-আপ করুন দেখুন।
ধাপ ১: DT Exchange UI-তে কনফিগারেশন সেট-আপ করা
নতুন অ্যাপ ও বিজ্ঞাপনের প্লেসমেন্ট যোগ করুন
DT Exchange Console-এ সাইন-আপ বা লগ-ইন করুন।
অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।
আপনার প্ল্যাটফর্ম ও প্লেসমেন্ট বেছে নিন, ফর্মের বাকি অংশ পূরণ করুন এবং তারপরে অ্যাপ তৈরি করুন বিকল্পে ক্লিক করুন।
Android
iOS
আপনার প্লেসমেন্টের নাম লিখুন এবং ধরন বেছে নিন। তারপর, প্লেসমেন্ট সেভ করুন বিকল্পে ক্লিক করুন।
অ্যাপ আইডি এবং প্লেসমেন্ট আইডি
বাঁদিকের নেভিগেশন বার খুলতে সেটির উপর মাউস নিয়ে যান, তারপর অ্যাপ ম্যানেজমেন্ট বিকল্পে ক্লিক করুন।
অ্যাপ ম্যানেজমেন্ট পৃষ্ঠায়, আপনার অ্যাপের পাশে থাকা অ্যাপ আইডি নোট করুন।
আপনার অ্যাপ বেছে নিন এবং প্লেসমেন্ট ট্যাবে যান। প্লেসমেন্ট আইডি নোট করে নিন।
প্রকাশক আইডি, কনজিউমার কী এবং কনজিউমার সিক্রেট
বাঁদিকের মেনু থেকে আপনার ইউজারনেমে ক্লিক করে ব্যবহারকারীর প্রোফাইল বিকল্প বেছে নিন।
প্রকাশক আইডি, কনজিউমার কী এবং কনজিউমার সিক্রেট নোট করে রাখুন কারণ পরবর্তী ধাপে এগুলি প্রয়োজন হবে।
আপনার app-ads.txt আপডেট করুন
অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
Ad Manager-এর জন্য app-ads.txt ফাইল তৈরি করুন।
DT Exchange-এর জন্য app-ads.txt প্রয়োগ করতে,
আপনার app-ads.txt ফাইলে DT যোগ করুন।
ধাপ ২: Ad Manager UI-তে DT Exchange ডিমান্ড সেট-আপ করা
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য গাইডের ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারদের তালিকায় DT Exchange যোগ করুন
Ad Manager UI-তে ইউরোপীয় ইউনিয়ন ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় DT Exchange (Fyber Monetization) যোগ করতে, ইউরোপীয় রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস -এ উল্লেখ করা ধাপগুলি অনুসরণ করুন।
ধাপ ৩: DT Exchange SDK ও অ্যাডাপ্টার ইমপোর্ট করা
pub.dev-এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml ফাইলে
DT Exchange SDK এবং অ্যাডাপ্টারের লেটেস্ট ভার্সনের সাথে
নিম্নলিখিত ডিপেনডেন্সি যোগ করুন:
dependencies:
gma_mediation_dtexchange: ^1.3.7
ম্যানুয়াল ইন্টিগ্রেশন
DT Exchange-এর জন্য
Google Mobile Ads মিডিয়েশন প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন,
ডাউনলোড করা ফাইল এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগ-ইন ফোল্ডার
(এবং এর কন্টেন্ট) আপনার Flutter প্রোজেক্টে যোগ করুন। তারপর, নিম্নলিখিত ডিপেন্ডেন্সি যোগ করে আপনার
pubspec.yaml ফাইলে প্লাগ-ইন রেফারেন্স করুন:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
ধাপ ৪: DT Exchange SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
DT Exchange Flutter অ্যাডাপ্টার ভার্সন 1.1.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে DT Exchange SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, Android এবং iOS জিডিপিআর (GDPR) ডকুমেন্টেশন দেখুন।
মার্কিন যুক্তরাষ্ট্রের প্রদেশগুলির গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে, ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে আপনাকে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।
DT Exchange-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগ-ইন DT Exchange SDK-তে সম্মতি সংক্রান্ত তথ্য পাস করার সুবিধা প্রদান করে না।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
Android
DT Exchange ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, DT Exchange-এর
ডকুমেন্টেশন
অনুসরণ করুন।
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি DT Exchange থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, DT Exchange (Bidding) এবং DT Exchange (Waterfall) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ত্রুটি কোড
অ্যাডাপ্টার DT Exchange থেকে বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা
ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে
নিম্নলিখিত ক্লাসের অধীনে
অন্তর্নিহিত ত্রুটি চেক করতে পারেন:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
কোনও বিজ্ঞাপন লোড না হলে DT Exchange অ্যাডাপ্টারের মাধ্যমে দেখানো কোড এবং মেসেজ এখানে দেওয়া হল:
Android
| সমস্যার কোড | কারণ |
|---|---|
| ১০১ | Ad Manager UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার নেই/ভুল। |
| 103 | অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না। |
| ১০৫ | DT SDK একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার রিটার্ন করেছে। |
| 106 | বিজ্ঞাপন দেখানোর জন্য রেডি নয়। |
| 107 | প্রসঙ্গটি কোনও অ্যাক্টিভিটি ইনস্ট্যান্স নয়। |
| 108 | বিজ্ঞাপন দেখানো যায়নি। |
| 200-399 | DT SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন। |
iOS
| সমস্যার কোড | কারণ |
|---|---|
| 0-10 | DT SDK-তে কোনও সমস্যা হয়েছে। আরও তথ্যের জন্য ডকুমেন্টেশন দেখুন। |
| ১০১ | Ad Manager UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার নেই/ভুল। |
| 102 | অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না। |
| 103 | বিজ্ঞাপন দেখানো যায়নি কারণ বিজ্ঞাপনের অবজেক্ট আগেই ব্যবহার করা হয়েছে। |
| 104 | বিজ্ঞাপন রেডি না থাকার কারণে DT Exchange বিজ্ঞাপন দেখানো যায়নি। |
| ১০৫ | DT SDK শুরু করার সময় সমস্যা হয়েছে। |
DT Exchange Flutter মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ
ভার্সন ১.৪.০ (প্রসেস চলছে)
ভার্সন ১.৩.৭
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.7.1-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.4.10.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.৩.৬
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এ কাজ করার জন্য আপডেট করা হয়েছে।
- Swift প্যাকেজ ম্যানেজার সংক্রান্ত সুবিধা যোগ করা হয়েছে।
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.7.0 কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.4.10.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.3.5
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.5.1-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.4.8.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 9.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.৩.৪
- Flutter-এর ন্যূনতম ভার্সন আপডেট করে 3.38.1 করা হয়েছে
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৮.০.০-এর সাথে কাজ করার জন্য আপডেট করা হয়েছে
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.4.0-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.4.6.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 8.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.3.3
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.2.1-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.4.3.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 7.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.৩.২
- Flutter-এর ন্যূনতম ভার্সন 3.35.1-এ আপডেট করা হয়েছে
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৭.০.০-এর সাথে কাজ করার জন্য আপডেট করা হয়েছে
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.0.1-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.4.2.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 7.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.৩.১
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.0.1-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.4.2.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.২.০
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.0.0 কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.3.8.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.1.5
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.3.8.0 কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.3.8.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.১.৪
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.3.7.0 কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.3.7.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.1.3
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.3.7.0 কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.3.6.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.১.২
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.3.6.1-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.3.6.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন 6.0.0-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন ১.১.১
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.3.6.0 কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.3.5.0 কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৫.৩.১-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.1.0
- iOS প্লাগ-ইন এখন একটি স্ট্যাটিক ফ্রেমওয়ার্ক।
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.3.5.0-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.3.4.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৫.৩.১-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।
ভার্সন 1.0.0
- প্রাথমিক রিলিজ।
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.2.7.0-এর সাথে কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.2.8.0-এ কাজ করে।
- Google Mobile Ads Flutter প্লাগ-ইন ভার্সন ৫.১.০-এর সাথে তৈরি ও পরীক্ষা করা হয়েছে।