এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করে DT Exchange থেকে বিজ্ঞাপন লোড এবং প্রদর্শন করতে হয়, যা মধ্যস্থতা ব্যবহার করে, জলপ্রপাত ইন্টিগ্রেশনগুলিকে অন্তর্ভুক্ত করে। এটি একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে DT Exchange কীভাবে যুক্ত করতে হয় এবং DT SDK এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপে কীভাবে একীভূত করতে হয় তা কভার করে।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
ডিটি এক্সচেঞ্জের জন্য ফ্লটার মেডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
ইন্টিগ্রেশন | |
---|---|
বিডিং | ১ |
জলপ্রপাত | |
ফর্ম্যাট | |
ব্যানার | |
ইন্টারস্টিশিয়াল | |
পুরস্কৃত | ২ |
১. বিডিং ইন্টিগ্রেশন বন্ধ বিটাতে আছে, অ্যাক্সেসের অনুরোধ করতে আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।
২ iOS বিডিংয়ের জন্য পুরস্কৃত বিজ্ঞাপনের ফর্ম্যাটটি আলফাতে।
আবশ্যকতা
- সর্বশেষ গুগল মোবাইল বিজ্ঞাপন SDK
- ফ্লাটার ৩.৭.০ বা তার বেশি
- অ্যান্ড্রয়েডে স্থাপন করতে
- অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
- iOS-এ স্থাপন করতে
- iOS স্থাপনার লক্ষ্য ১২.০ বা তার বেশি
- Google মোবাইল বিজ্ঞাপন SDK দিয়ে কনফিগার করা একটি কার্যকরী Flutter প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন
ধাপ ১: DT এক্সচেঞ্জ UI-তে কনফিগারেশন সেট আপ করুন
নতুন অ্যাপ এবং বিজ্ঞাপনের স্থান নির্ধারণ যোগ করুন
ডিটি এক্সচেঞ্জ কনসোলে সাইন আপ করুন অথবা লগ ইন করুন ।
অ্যাপ যোগ করুন ক্লিক করুন।
আপনার প্ল্যাটফর্ম এবং স্থান নির্বাচন করুন, বাকি ফর্মটি পূরণ করুন এবং তারপর Create App এ ক্লিক করুন।
অ্যান্ড্রয়েড
আইওএস
আপনার প্লেসমেন্টের জন্য নাম লিখুন এবং প্রকারগুলি নির্বাচন করুন। তারপর, প্লেসমেন্ট সংরক্ষণ করুন এ ক্লিক করুন।
অ্যাপ আইডি এবং প্লেসমেন্ট আইডি
এটি খুলতে বাম নেভিগেশন বারের উপর কার্সার রাখুন, তারপর অ্যাপ ম্যানেজমেন্ট এ ক্লিক করুন।
অ্যাপ ম্যানেজমেন্ট পৃষ্ঠায়, আপনার অ্যাপের পাশে থাকা অ্যাপ আইডিটি লক্ষ্য করুন।
আপনার অ্যাপটি নির্বাচন করুন এবং প্লেসমেন্ট ট্যাবে যান। প্লেসমেন্ট আইডিটি লক্ষ্য করুন..
প্রকাশক আইডি, গ্রাহক কী এবং গ্রাহক গোপনীয়তা
বাম মেনু থেকে আপনার ব্যবহারকারীর নাম ক্লিক করুন এবং ব্যবহারকারীর প্রোফাইল নির্বাচন করুন।
পরবর্তী ধাপে প্রয়োজন হলে প্রকাশক আইডি , কনজিউমার কী এবং কনজিউমার সিক্রেটের দিকে লক্ষ্য রাখুন।
আপনার app-ads.txt আপডেট করুন
অ্যাপসের জন্য অনুমোদিত বিক্রেতারা app-ads.txt হল একটি IAB টেক ল্যাব উদ্যোগ যা নিশ্চিত করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেন্টরি কেবলমাত্র সেই চ্যানেলগুলির মাধ্যমে বিক্রি করা হচ্ছে যেগুলি আপনি অনুমোদিত হিসাবে চিহ্নিত করেছেন। বিজ্ঞাপনের আয়ের উল্লেখযোগ্য ক্ষতি রোধ করতে, আপনাকে একটি app-ads.txt
ফাইল প্রয়োগ করতে হবে। যদি আপনি ইতিমধ্যে এটি না করে থাকেন, তাহলে বিজ্ঞাপন পরিচালকের জন্য একটি app-ads.txt ফাইল তৈরি করুন ।
DT Exchange-এর জন্য app-ads.txt
বাস্তবায়ন করতে, আপনার app-ads.txt ফাইলে DT যোগ করুন ।
ধাপ ২: অ্যাড ম্যানেজার UI-তে DT এক্সচেঞ্জ চাহিদা সেট আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, Android এর জন্য নির্দেশিকায় ধাপ ২ দেখুন।
আইওএস
নির্দেশাবলীর জন্য, iOS এর জন্য নির্দেশিকায় ধাপ ২ দেখুন।
জিডিপিআর এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালার বিজ্ঞাপন অংশীদারদের তালিকায় ডিটি এক্সচেঞ্জ যোগ করুন
বিজ্ঞাপন পরিচালক UI-তে ইউরোপীয় এবং মার্কিন যুক্তরাষ্ট্রের রাজ্যের নিয়মাবলীর বিজ্ঞাপন অংশীদারদের তালিকায় DT এক্সচেঞ্জ (ফাইবার মনিটাইজেশন) যোগ করতে ইউরোপীয় নিয়মাবলী সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের রাজ্যের নিয়মাবলী সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ ৩: DT SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml
ফাইলে DT Exchange SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যোগ করুন:
dependencies:
gma_mediation_dtexchange: ^
ম্যানুয়াল ইন্টিগ্রেশন
DT Exchange-এর জন্য Google Mobile Ads mediation plugin-এর সর্বশেষ সংস্করণ ডাউনলোড করুন, ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার Flutter প্রজেক্টে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml
ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
ধাপ ৪: DT SDK-তে গোপনীয়তা সেটিংস বাস্তবায়ন করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডের ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং আইনত প্রয়োজনে কুকিজ বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপন ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, ভাগ করে নেওয়া এবং ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণ (GDPR) এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে। আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পাঠানো হয়েছে কিনা তা যাচাই করার জন্য আপনার দায়িত্ব। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতি পছন্দ প্রেরণ করতে অক্ষম।
DT Exchange-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগইন DT SDK-তে সম্মতি তথ্য পাঠানো সমর্থন করে না।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন অনুসারে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" (যেমন আইন এই শর্তাবলী সংজ্ঞায়িত করে) "বিক্রয়" থেকে বেরিয়ে আসার অধিকার দেওয়া হয়, যেখানে "বিক্রয়কারী" পক্ষের হোমপেজে "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউট করার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন সম্মতি নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে অক্ষম। অতএব, আপনার মধ্যস্থতা শৃঙ্খলের প্রতিটি বিজ্ঞাপন নেটওয়ার্ক চিহ্নিত করতে হবে যারা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই প্রতিটি নেটওয়ার্কের নির্দেশিকা অনুসরণ করতে হবে।
DT Exchange-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগইন DT SDK-তে সম্মতি তথ্য পাঠানো সমর্থন করে না।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
ডিটি এক্সচেঞ্জ ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।
আইওএস
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist
ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে DT Exchange-এর ডকুমেন্টেশন অনুসরণ করুন।
ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষামূলক বিজ্ঞাপন সক্ষম করুন
আপনার পরীক্ষামূলক ডিভাইসটি বিজ্ঞাপন পরিচালকের জন্য নিবন্ধন করুন।
পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন
আপনি DT Exchange থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, DT Exchange (বিডিং) এবং DT Exchange (ওয়াটারফল) বিজ্ঞাপন উৎস(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক বিভাগে একক বিজ্ঞাপন উৎস পরীক্ষা সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টারটি DT এক্সচেঞ্জ থেকে কোনও বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত শ্রেণীর অধীনে ResponseInfo
ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.fyber.FyberMediationAdapter
আইওএস
GADMediationAdapterFyber
কোনও বিজ্ঞাপন লোড না হলে DT Exchange অ্যাডাপ্টার দ্বারা প্রেরিত কোড এবং তার সাথে থাকা বার্তাগুলি এখানে দেওয়া হল:
অ্যান্ড্রয়েড
ত্রুটি কোড | কারণ |
---|---|
১০১ | বিজ্ঞাপন ম্যানেজার UI-তে কনফিগার করা DT এক্সচেঞ্জ সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ। |
১০৩ | অনুরোধ করা বিজ্ঞাপনের আকারটি DT এক্সচেঞ্জ সমর্থিত ব্যানার আকারের সাথে মেলে না। |
১০৫ | DT SDK একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার ফিরিয়ে দিয়েছে। |
১০৬ | বিজ্ঞাপনটি প্রদর্শনের জন্য প্রস্তুত নয়। |
১০৭ | প্রসঙ্গ কোনও কার্যকলাপের উদাহরণ নয়। |
২০০-৩৯৯ | DT SDK একটি ত্রুটি ফেরত দিয়েছে। আরও বিস্তারিত জানার জন্য কোড দেখুন। |
আইওএস
ত্রুটি কোড | কারণ |
---|---|
০-১০ | DT SDK একটি ত্রুটি ফেরত দিয়েছে। আরও বিস্তারিত জানার জন্য ডকুমেন্টেশন দেখুন। |
১০১ | বিজ্ঞাপন ম্যানেজার UI-তে কনফিগার করা DT এক্সচেঞ্জ সার্ভার প্যারামিটারগুলি অনুপস্থিত/অবৈধ। |
১০২ | অনুরোধ করা বিজ্ঞাপনের আকারটি DT এক্সচেঞ্জ সমর্থিত ব্যানার আকারের সাথে মেলে না। |
১০৩ | বিজ্ঞাপনের বস্তুটি ইতিমধ্যেই ব্যবহার করা হয়েছে বলে বিজ্ঞাপন দেখানো যায়নি। |
১০৪ | বিজ্ঞাপন প্রস্তুত না থাকার কারণে DT Exchange বিজ্ঞাপনগুলি দেখানো যায়নি। |
১০৫ | DT SDK একটি আরম্ভিক ত্রুটি ফেরত দিয়েছে। |
ডিটি এক্সচেঞ্জ ফ্লাটার মেডিয়েশন অ্যাডাপ্টার চেঞ্জলগ
সংস্করণ 1.1.5
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.3.8.0 সমর্থন করে।
- DT Exchange iOS অ্যাডাপ্টার সংস্করণ 8.3.8.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.1.4
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.3.7.0 সমর্থন করে।
- DT Exchange iOS অ্যাডাপ্টার সংস্করণ 8.3.7.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.1.3
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.3.7.0 সমর্থন করে।
- DT Exchange iOS অ্যাডাপ্টার সংস্করণ 8.3.6.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.1.2
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.3.6.1 সমর্থন করে।
- DT Exchange iOS অ্যাডাপ্টার সংস্করণ 8.3.6.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.1.1
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.3.6.0 সমর্থন করে।
- DT Exchange iOS অ্যাডাপ্টার সংস্করণ 8.3.5.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.1.0
- iOS প্লাগইন এখন একটি স্ট্যাটিক ফ্রেমওয়ার্ক।
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.3.5.0 সমর্থন করে।
- DT Exchange iOS অ্যাডাপ্টার সংস্করণ 8.3.4.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.0.0
- প্রাথমিক প্রকাশ।
- ডিটি এক্সচেঞ্জ অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 8.2.7.0 সমর্থন করে।
- DT Exchange iOS অ্যাডাপ্টার সংস্করণ 8.2.8.0 সমর্থন করে।
- গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.1.0 দিয়ে তৈরি এবং পরীক্ষিত।