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