এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে DT Exchange থেকে মধ্যস্থতা ব্যবহার করে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, জলপ্রপাত একীকরণগুলিকে কভার করে৷ এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে ডিটি এক্সচেঞ্জ যোগ করতে হয় এবং কীভাবে একটি Flutter অ্যাপে DT Exchange SDK এবং অ্যাডাপ্টারকে একীভূত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
ডিটি এক্সচেঞ্জের জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| মিশ্রণ | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| বিন্যাস | |
| ব্যানার | |
| কৌশলে | |
| পুরস্কৃত | |
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: DT Exchange UI এ কনফিগারেশন সেট আপ করুন
নতুন অ্যাপ এবং বিজ্ঞাপন বসানো যোগ করুন
সাইন আপ করুন বা ডিটি এক্সচেঞ্জ কনসোলে লগ ইন করুন ৷
আপনার অ্যাপ যোগ করতে অ্যাপ অ্যাড বোতামে ক্লিক করুন।
আপনার প্ল্যাটফর্ম নির্বাচন করুন, বাকি ফর্মটি পূরণ করুন এবং যোগ করুন প্লেসমেন্টে ক্লিক করুন।
অ্যান্ড্রয়েড
iOS
আপনার প্লেসমেন্টের নাম লেবেলযুক্ত ফিল্ডে নতুন প্লেসমেন্টের জন্য একটি নাম লিখুন এবং ড্রপডাউন তালিকা থেকে আপনার পছন্দসই প্লেসমেন্টের ধরন নির্বাচন করুন। অবশেষে, সেভ প্লেসমেন্ট ক্লিক করুন।
অ্যাপ আইডি এবং প্লেসমেন্ট আইডি
এটির উপর আপনার মাউস ঘোরার দ্বারা বাম নেভিগেশন বার খুলুন। তারপর বাম মেনু থেকে Apps এ ক্লিক করুন।
অ্যাপ ম্যানেজমেন্ট পৃষ্ঠায়, আপনার অ্যাপের পাশে থাকা অ্যাপ আইডিটি নোট করুন।
আপনার অ্যাপ নির্বাচন করুন, প্লেসমেন্ট ট্যাবে নেভিগেট করুন এবং প্লেসমেন্ট নামের পাশের কপি আইকনে ক্লিক করুন। প্লেসমেন্ট আইডি নোট করুন।
প্রকাশক আইডি, কনজিউমার কী এবং কনজিউমার সিক্রেট
বাম মেনু থেকে আপনার ব্যবহারকারীর নামের উপর ক্লিক করুন এবং ব্যবহারকারীর প্রোফাইল নির্বাচন করুন।
প্রকাশক আইডি , কনজিউমার কী এবং কনজিউমার সিক্রেট নোট করুন কারণ পরবর্তী ধাপে এগুলোর প্রয়োজন।
ধাপ 2: AdMob UI এ DT এক্সচেঞ্জ চাহিদা সেট আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য,Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য,iOS- এর জন্য গাইডের ধাপ 2 দেখুন।
Fyber যোগ করুন GDPR এবং ইউএস স্টেট রেগুলেশন বিজ্ঞাপন অংশীদারদের তালিকায়
GDPR সেটিংসএবংইউএস স্টেট রেগুলেশন সেটিংসএ ধাপগুলি অনুসরণ করুন AdMob UI এ।
ধাপ 3: DT Exchange SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml ফাইলেDT Exchange SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন:
dependencies:
gma_mediation_dtexchange: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
DT Exchange এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি বের করুন এবং এক্সট্রাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রকল্পে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার 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 | AdMob UI এ কনফিগার করা DT Exchange সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
| 103 | অনুরোধ করা বিজ্ঞাপনের আকার একটি DT Exchange সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| 105 | DT Exchange SDK একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার ফিরিয়ে দিয়েছে৷ |
| 106 | বিজ্ঞাপন প্রদর্শনের জন্য প্রস্তুত নয়। |
| 200-399 | DT Exchange SDK একটি ত্রুটি ফিরিয়ে দিয়েছে৷ আরো বিস্তারিত জানার জন্য কোড দেখুন. |
iOS
| ভুল সংকেত | কারণ |
|---|---|
| 0-10 | DT Exchange SDK একটি ত্রুটি ফিরিয়ে দিয়েছে৷ আরো বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন. |
| 101 | AdMob UI-তে কনফিগার করা DT Exchange সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
| 102 | অনুরোধ করা বিজ্ঞাপনের আকার একটি DT Exchange সমর্থিত ব্যানার আকারের সাথে মেলে না। |
| 103 | বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে কারণ বিজ্ঞাপন বস্তু ইতিমধ্যেই ব্যবহার করা হয়েছে৷ |
| 104 | বিজ্ঞাপন প্রস্তুত না হওয়ার কারণে DT Exchange বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে৷ |
| 105 | DT Exchange SDK একটি প্রাথমিক ত্রুটি ফিরিয়ে দিয়েছে। |
DT Exchange Flutter Mediation Adapter Changelog
1.0.0
- প্রাথমিক মুক্তি।
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.2.7.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা।
- DT Exchange iOS অ্যাডাপ্টারের সংস্করণ 8.2.8.0 এর সাথে যাচাইকৃত সামঞ্জস্য।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।