এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে DT Exchange থেকে মধ্যস্থতা ব্যবহার করে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, জলপ্রপাত একীকরণগুলিকে কভার করে৷ এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে ডিটি এক্সচেঞ্জ যোগ করতে হয় এবং কীভাবে ডিটি এক্সচেঞ্জ এসডিকে এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপ
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
দ Ad Manager ডিটি এক্সচেঞ্জের জন্য মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| বিন্যাস | |
| ব্যানার | |
| ইন্টারস্টিশিয়াল | |
| পুরস্কৃত | |
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- একটি কাজ Flutter প্রোজেক্টটি Google Mobile Ads SDK-এর সাথে কনফিগার করা হয়েছে। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: DT Exchange UI এ কনফিগারেশন সেট আপ করুন
নতুন অ্যাপ এবং বিজ্ঞাপন বসানো যোগ করুন
সাইন আপ করুন বা ডিটি এক্সচেঞ্জ কনসোলে লগ ইন করুন ৷
আপনার অ্যাপ যোগ করতে অ্যাপ অ্যাড বোতামে ক্লিক করুন।
আপনার প্ল্যাটফর্ম নির্বাচন করুন, বাকি ফর্মটি পূরণ করুন এবং যোগ করুন প্লেসমেন্টে ক্লিক করুন।
অ্যান্ড্রয়েড
iOS
আপনার প্লেসমেন্টের নাম লেবেলযুক্ত ফিল্ডে নতুন প্লেসমেন্টের জন্য একটি নাম লিখুন এবং ড্রপডাউন তালিকা থেকে আপনার পছন্দসই প্লেসমেন্টের ধরন নির্বাচন করুন। অবশেষে, সেভ প্লেসমেন্ট ক্লিক করুন।
অ্যাপ আইডি এবং প্লেসমেন্ট আইডি
এটির উপর আপনার মাউস ঘোরার দ্বারা বাম নেভিগেশন বার খুলুন। তারপর বাম মেনু থেকে Apps এ ক্লিক করুন।
অ্যাপ ম্যানেজমেন্ট পৃষ্ঠায়, আপনার অ্যাপের পাশে থাকা অ্যাপ আইডিটি নোট করুন।
আপনার অ্যাপ নির্বাচন করুন, প্লেসমেন্ট ট্যাবে নেভিগেট করুন এবং প্লেসমেন্ট নামের পাশের কপি আইকনে ক্লিক করুন। প্লেসমেন্ট আইডি নোট করুন।
প্রকাশক আইডি, কনজিউমার কী এবং কনজিউমার সিক্রেট
বাম মেনু থেকে আপনার ব্যবহারকারীর নামের উপর ক্লিক করুন এবং ব্যবহারকারীর প্রোফাইল নির্বাচন করুন।
প্রকাশক আইডি , কনজিউমার কী এবং কনজিউমার সিক্রেট নোট করুন কারণ পরবর্তী ধাপে এগুলোর প্রয়োজন।
ধাপ 2: ডিটি এক্সচেঞ্জের চাহিদা সেট আপ করুন Ad Manager UI
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS এর জন্য নির্দেশিকাতে ধাপ 2 দেখুন।
যোগ করুন Fyber জিডিপিআর এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায়
AdMob UI-তে GDPR এবং US রাজ্যের প্রবিধানের বিজ্ঞাপন অংশীদারদের তালিকায় DT Exchange (Fyber Monetization) যোগ করতে GDPR সেটিংস এবং US রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ 3: DT Exchange SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
এর সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন৷DT Exchange আপনার প্যাকেজের pubspec.yaml ফাইলে SDK এবং অ্যাডাপ্টার:
dependencies:
gma_mediation_dtexchange: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণ ডাউনলোড করুনDT Exchange , ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্রাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রোজেক্টে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
ধাপ 4: DT Exchange SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতির অধীনে, আপনাকে নিশ্চিত করতে হবে যে ডিভাইস শনাক্তকারী এবং ব্যক্তিগত ডেটার ব্যবহার সম্পর্কিত ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ব্যবহারকারীদের নির্দিষ্ট কিছু প্রকাশ দেওয়া হয়েছে এবং তাদের কাছ থেকে সম্মতি নেওয়া হয়েছে। এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ সম্মতি চাওয়ার সময়, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত ডেটা সংগ্রহ, গ্রহণ বা ব্যবহার করতে পারে এবং প্রতিটি নেটওয়ার্কের ব্যবহার সম্পর্কে তথ্য প্রদান করতে পারে। Google বর্তমানে স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
DT Exchange-এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন DT Exchange SDK-এর কাছে সম্মতির তথ্য পাস করা সমর্থন করে না।
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার প্রদান করতে হবে (যেমন আইন সেই শর্তগুলিকে সংজ্ঞায়িত করে), "বিক্রয়" এ একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউটের প্রস্তাব দেওয়া হয়েছে "পার্টির হোমপেজ। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
DT Exchange-এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন DT Exchange SDK-এর কাছে সম্মতির তথ্য পাস করা সমর্থন করে না।
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
DT Exchange ইন্টিগ্রেশনের জন্য কোন অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে DT Exchange এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ 6: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করা নিশ্চিত করুন।
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি DT Exchange থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, DT Exchange (Waterfall) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টারটি ডিটি এক্সচেঞ্জ থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত শ্রেণির অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয় তখন ডিটি এক্সচেঞ্জ অ্যাডাপ্টারের দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
অ্যান্ড্রয়েড
| ত্রুটি কোড | কারণ |
|---|---|
| 101 | ডিটি এক্সচেঞ্জ সার্ভারের পরামিতি কনফিগার করা হয়েছে Ad Manager UI অনুপস্থিত/অবৈধ। |
| 103 | অনুরোধ করা বিজ্ঞাপনের আকার একটি DT Exchange সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| 105 | DT Exchange SDK একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার ফিরিয়ে দিয়েছে৷ |
| 106 | বিজ্ঞাপন প্রদর্শনের জন্য প্রস্তুত নয়। |
| 200-399 | DT Exchange SDK একটি ত্রুটি ফিরিয়ে দিয়েছে৷ আরো বিস্তারিত জানার জন্য কোড দেখুন. |
iOS
| ত্রুটি কোড | কারণ |
|---|---|
| 0-10 | DT Exchange SDK একটি ত্রুটি ফিরিয়ে দিয়েছে৷ আরো বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন. |
| 101 | ডিটি এক্সচেঞ্জ সার্ভারের পরামিতি কনফিগার করা হয়েছে Ad Manager UI অনুপস্থিত/অবৈধ। |
| 102 | অনুরোধ করা বিজ্ঞাপনের আকার একটি DT Exchange সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| 103 | বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে কারণ বিজ্ঞাপন বস্তু ইতিমধ্যেই ব্যবহার করা হয়েছে৷ |
| 104 | বিজ্ঞাপন প্রস্তুত না হওয়ার কারণে DT Exchange বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে৷ |
| 105 | DT Exchange SDK একটি প্রাথমিক ত্রুটি ফিরিয়ে দিয়েছে। |
DT Exchange Flutter Mediation Adapter Changelog
পরবর্তী সংস্করণ
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.2.0 দিয়ে তৈরি এবং পরীক্ষিত।
1.1.0
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.3.0.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
- DT Exchange iOS অ্যাডাপ্টারের সংস্করণ 8.3.1.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।
1.0.0
- প্রাথমিক মুক্তি।
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.2.7.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
- DT Exchange iOS অ্যাডাপ্টারের সংস্করণ 8.2.8.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।