ডিটি এক্সচেঞ্জকে মধ্যস্থতার সাথে একীভূত করুন

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে মিডিয়েশন ব্যবহার করে ডিটি এক্সচেঞ্জ থেকে বিজ্ঞাপন লোড ও প্রদর্শন করার জন্য Google Mobile Ads Flutter Plugin ব্যবহার করতে হয়, যেখানে ওয়াটারফল ইন্টিগ্রেশনও অন্তর্ভুক্ত রয়েছে। এতে আলোচনা করা হয়েছে কিভাবে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে ডিটি এক্সচেঞ্জ যুক্ত করতে হয় এবং কিভাবে একটি ফ্লাটার অ্যাপে ডিটি এসডিকে ও অ্যাডাপ্টার ইন্টিগ্রেট করতে হয়।

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

ডিটি এক্সচেঞ্জের জন্য ফ্লাটার মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত
স্থানীয়

১. বিডিং ইন্টিগ্রেশন বর্তমানে ক্লোজড বিটা পর্যায়ে রয়েছে, অ্যাক্সেসের জন্য আপনার অ্যাকাউন্ট ম্যানেজারের সাথে যোগাযোগ করুন।

প্রয়োজনীয়তা

  • সর্বশেষ Google Mobile Ads Flutter Plugin
  • ফ্লাটার ৩.৭.০ বা উচ্চতর
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
  • Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Flutter Plugin সেট আপ করুন’ দেখুন।
  • AdMob মিডিয়েশন সেট আপ করুন

ধাপ ১: DT Exchange UI-তে কনফিগারেশন সেট আপ করুন।

নতুন অ্যাপ এবং বিজ্ঞাপন স্থান যোগ করুন

ডিটি এক্সচেঞ্জ কনসোলে সাইন আপ করুন অথবা লগ ইন করুন

অ্যাপ যোগ করুন -এ ক্লিক করুন।

অ্যাপ পরিচালনা করুন

আপনার প্ল্যাটফর্ম ও স্থান নির্বাচন করুন, ফর্মের বাকি অংশ পূরণ করুন এবং তারপরে 'অ্যাপ তৈরি করুন' বোতামে ক্লিক করুন।

অ্যান্ড্রয়েড

আইওএস

আপনার প্লেসমেন্টের জন্য নামগুলো লিখুন এবং ধরন নির্বাচন করুন। তারপর, 'সেভ প্লেসমেন্ট'-এ ক্লিক করুন।

সেটআপ

অ্যাপ আইডি এবং প্লেসমেন্ট আইডি

বাম দিকের নেভিগেশন বারের উপর মাউস রাখলে সেটি খুলবে, তারপর অ্যাপ ম্যানেজমেন্ট-এ ক্লিক করুন।

অ্যাপ ম্যানেজমেন্ট পেজে, আপনার অ্যাপের পাশে থাকা অ্যাপ আইডিটি লিখে রাখুন।

আপনার অ্যাপটি নির্বাচন করুন এবং প্লেসমেন্টস ট্যাবে যান। প্লেসমেন্ট আইডিটি লিখে রাখুন।

প্লেসমেন্ট আইডি

প্রকাশক আইডি, গ্রাহক কী এবং গ্রাহক গোপনীয়তা

বাম দিকের মেনু থেকে আপনার ইউজারনেমে ক্লিক করুন এবং ইউজার প্রোফাইল নির্বাচন করুন।

পাবলিশার আইডি , কনজিউমার কী এবং কনজিউমার সিক্রেট লিখে রাখুন, কারণ পরবর্তী ধাপে এগুলোর প্রয়োজন হবে।

ব্যবহারকারীর প্রোফাইল

আপনার app-ads.txt আপডেট করুন।

Apps-এর জন্য অনুমোদিত বিক্রেতা app-ads.txt হলো IAB টেক ল্যাবের একটি উদ্যোগ, যা নিশ্চিত করতে সাহায্য করে যে আপনার অ্যাপের বিজ্ঞাপনগুলো শুধুমাত্র আপনার চিহ্নিত অনুমোদিত চ্যানেলগুলোর মাধ্যমেই বিক্রি হবে। বিজ্ঞাপনের আয়ে বড় ধরনের ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। যদি আপনি এখনও তা না করে থাকেন, তাহলে আপনার অ্যাপের জন্য একটি app-ads.txt ফাইল তৈরি করুন

DT Exchange-এর জন্য app-ads.txt প্রয়োগ করতে, আপনার app-ads.txt ফাইলে DT যোগ করুন

ধাপ ২: AdMob UI-তে DT Exchange ডিমান্ড সেট আপ করুন।

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন।

অ্যান্ড্রয়েড

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

নির্দেশাবলীর জন্য, iOS- এর গাইডের ধাপ ২ দেখুন।

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা অনুযায়ী বিজ্ঞাপন অংশীদারদের তালিকায় DT Exchange-কে যুক্ত করুন

AdMob UI-তে ইউরোপীয় এবং মার্কিন রাজ্য বিধিমালা বিজ্ঞাপন অংশীদারদের তালিকায় DT Exchange (Fyber Monetization)-কে যুক্ত করতে, ইউরোপীয় বিধিমালা সেটিংস এবং মার্কিন রাজ্য বিধিমালা সেটিংস-এর ধাপগুলো অনুসরণ করুন।

ধাপ ৩: ডিটি এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

pub.dev এর মাধ্যমে একীকরণ

আপনার প্যাকেজের pubspec.yaml ফাইলে DT Exchange SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণ সহ নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন:

dependencies:
  gma_mediation_dtexchange: ^1.3.3

ম্যানুয়াল ইন্টিগ্রেশন

DT Exchange- এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগইন ফোল্ডারটি (এবং এর ভেতরের সবকিছু) আপনার ফ্লাটার প্রজেক্টে যুক্ত করুন। এরপর, আপনার pubspec.yaml ফাইলে নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করে প্লাগইনটিকে রেফারেন্স করুন:

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

ধাপ ৪: DT SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করুন।

Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে থাকা আপনার ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং যেখানে আইনত প্রয়োজন সেখানে কুকি বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপনের ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ePrivacy Directive এবং General Data Protection Regulation (GDPR)-এর প্রয়োজনীয়তাগুলো প্রতিফলিত করে। আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পৌঁছেছে কিনা তা যাচাই করার দায়িত্ব আপনার। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ প্রেরণ করতে অক্ষম।

DT Exchange-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটি DT SDK-তে সম্মতির তথ্য প্রেরণ সমর্থন করে না।

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন অনুযায়ী, ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" (আইনে এই পদগুলির যে সংজ্ঞা দেওয়া হয়েছে) "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দেওয়া আবশ্যক। এই অপ্ট-আউটের সুযোগটি "বিক্রেতা" পক্ষের হোমপেজে একটি সুস্পষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন পরিপালন নির্দেশিকা গুগল বিজ্ঞাপন পরিবেশনের জন্য সীমিত ডেটা প্রক্রিয়াকরণ সক্ষম করার সুযোগ দেয়, কিন্তু গুগল আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে পারে না। অতএব, আপনাকে আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্ক শনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রয়ে অংশ নিতে পারে এবং পরিপালন নিশ্চিত করার জন্য সেই নেটওয়ার্কগুলির প্রত্যেকটির নির্দেশিকা অনুসরণ করতে হবে।

DT Exchange-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনটি DT SDK-তে সম্মতির তথ্য প্রেরণ সমর্থন করে না।

ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন

অ্যান্ড্রয়েড

ডিটি এক্সচেঞ্জ ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork আইডেন্টিফায়ারগুলো যোগ করতে DT Exchange-এর ডকুমেন্টেশন অনুসরণ করুন।

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি AdMob-এর জন্য রেজিস্টার করে নিন

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি DT Exchange থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে DT Exchange (Bidding) এবং DT Exchange (Waterfall) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি ডিটি এক্সচেঞ্জ থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসের অধীনে থাকা ResponseInfo ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

অ্যান্ড্রয়েড

com.google.ads.mediation.fyber.FyberMediationAdapter

আইওএস

GADMediationAdapterFyber

কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হলে ডিটি এক্সচেঞ্জ অ্যাডাপ্টার যে কোড ও বার্তাগুলো প্রদর্শন করে, তা নিচে দেওয়া হলো:

অ্যান্ড্রয়েড

ত্রুটি কোড কারণ
১০১ AdMob UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটারগুলো অনুপস্থিত বা অবৈধ।
১০৩ অনুরোধ করা বিজ্ঞাপনের আকারটি ডিটি এক্সচেঞ্জ সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৫ ডিটি এসডিকে একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার ফেরত দিয়েছে।
১০৬ বিজ্ঞাপনটি প্রদর্শনের জন্য প্রস্তুত নয়।
১০৭ Context একটি অ্যাক্টিভিটি ইনস্ট্যান্স নয়।
২০০-৩৯৯ DT SDK একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে কোড দেখুন।

আইওএস

ত্রুটি কোড কারণ
০-১০ ডিটি এসডিকে একটি ত্রুটি দেখিয়েছে। আরও বিস্তারিত জানতে ডকুমেন্টেশন দেখুন।
১০১ AdMob UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটারগুলো অনুপস্থিত বা অবৈধ।
১০২ অনুরোধ করা বিজ্ঞাপনের আকারটি ডিটি এক্সচেঞ্জ সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৩ বিজ্ঞাপনটি দেখানো সম্ভব হয়নি কারণ বিজ্ঞাপন অবজেক্টটি ইতিমধ্যেই ব্যবহৃত হয়েছে।
১০৪ বিজ্ঞাপন প্রস্তুত না থাকায় ডিটি এক্সচেঞ্জ বিজ্ঞাপন দেখানো সম্ভব হয়নি।
১০৫ ডিটি এসডিকে একটি প্রারম্ভিক ত্রুটি দেখিয়েছে।

ডিটি এক্সচেঞ্জ ফ্লাটার মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

সংস্করণ ১.৩.৩

সংস্করণ ১.৩.২

সংস্করণ ১.৩.১

সংস্করণ ১.২.০

সংস্করণ ১.১.৫

সংস্করণ ১.১.৪

সংস্করণ ১.১.৩

সংস্করণ ১.১.২

সংস্করণ ১.১.১

সংস্করণ ১.১.০

সংস্করণ ১.০.০