মেডিয়েশনের সাথে DT Exchange ইন্টিগ্রেট করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (পুরনো)

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

যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়

DT Exchange-এর জন্য Flutter মিডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
ব্যানার
স্থান
পুরস্কার জিতেছেন
নেটিভ

পূর্বশর্ত

এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করিয়ে নিন:

  • লেটেস্ট Google Mobile Ads Flutter Plugin ভার্সন।
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 15.0 বা তার পরের যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ Google Mobile Ads Flutter Plugin দেখুন।
  • মধ্যস্থতা সেট-আপ করুন।

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

    নতুন অ্যাপ ও বিজ্ঞাপন প্লেসমেন্ট যোগ করা

    DT Exchange কনসোলে সাইন-আপ করুন অথবা লগ-ইন করুন।

    অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।

    অ্যাপ ম্যানেজ করুন

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

    Android

    iOS

    আপনার প্লেসমেন্টের নাম লিখুন এবং ধরন বেছে নিন। তারপর, প্লেসমেন্ট সেভ করুন বিকল্পে ক্লিক করুন।

    সেট-আপ করুন

    অ্যাপ আইডি ও প্লেসমেন্ট আইডি

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

    অ্যাপ ম্যানেজমেন্ট পৃষ্ঠায়, আপনার অ্যাপের পাশে থাকা অ্যাপ আইডি নোট করুন।

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

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

    প্রকাশক আইডি, কনজিউমার কী ও কনজিউমার সিক্রেট

    বাঁদিকের মেনু থেকে আপনার ইউজারনেমে ক্লিক করে ব্যবহারকারীর প্রোফাইল বিকল্প বেছে নিন।

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

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

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

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

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

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

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

    Android

    নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

    iOS

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

    জিডিপিআর (GDPR) ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনার তালিকায় DT Exchange যোগ করা

    Ad Manager UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনার তালিকায় DT Exchange (Fyber Monetization) যোগ করতে ইউরোপিয়ান রেগুলেশন সেটিংস ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস লিঙ্কে গিয়ে ধাপগুলি অনুসরণ করুন।

    ধাপ ৩: DT Exchange SDK ও অ্যাডাপ্টার ইমপোর্ট করা

    pub.dev-এর মাধ্যমে ইন্টিগ্রেশন

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

    dependencies:
  gma_mediation_dtexchange: ^1.3.7

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

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

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

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

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

    DT Exchange Flutter অ্যাডাপ্টার ভার্সন 1.1.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে DT Exchange SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, Android এবং iOS জিডিপিআর (GDPR) ডকুমেন্টেশন দেখুন।

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

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

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

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

    Android

    DT Exchange ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোড প্রয়োজন নেই।

    iOS

    SKAdNetwork ইন্টিগ্রেশন

    আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, DT Exchange-এর ডকুমেন্টেশন দেখুন।

    ধাপ ৬: আপনার প্রয়োগ করা পদ্ধতি পরীক্ষা করুন

    টেস্ট বিজ্ঞাপন চালু করা

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা ভালোভাবে দেখে নিন।

    টেস্ট বিজ্ঞাপন যাচাই করা

    আপনি DT Exchange থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে বিজ্ঞাপনের একটি সোর্স টেস্টিং চালু করুন। এর জন্য DT Exchange (বিডিং) ও DT Exchange (ওয়াটারফল) বিজ্ঞাপনের সোর্স ব্যবহার করুন।

    সমস্যার কোড

    অ্যাডাপ্টার DT Exchange থেকে বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে নিম্নলিখিত ক্লাসের অধীনে অন্তর্নিহিত ত্রুটি চেক করতে পারেন:

    Android

    com.google.ads.mediation.fyber.FyberMediationAdapter

    iOS

    GADMediationAdapterFyber

    কোনও বিজ্ঞাপন লোড না হলে DT Exchange অ্যাডাপ্টারের মাধ্যমে দেখানো কোড এবং মেসেজ এখানে দেওয়া হল:

    Android

    সমস্যার কোড কারণ
    ১০১ Ad Manager UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার অনুপস্থিত/ভুল।
    103 অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন কোনও ব্যানার সাইজের সাথে মিলছে না।
    ১০৫ DT SDK একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার রিটার্ন করেছে।
    106 বিজ্ঞাপন দেখানোর জন্য রেডি নয়।
    107 প্রসঙ্গটি কোনও অ্যাক্টিভিটি ইনস্ট্যান্স নয়।
    108 বিজ্ঞাপন দেখানো যায়নি।
    200-399 DT SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন।

    iOS

    সমস্যার কোড কারণ
    0-10 DT SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য ডকুমেন্টেশন দেখুন।
    ১০১ Ad Manager UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার অনুপস্থিত/ভুল।
    102 অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন কোনও ব্যানার সাইজের সাথে মিলছে না।
    103 বিজ্ঞাপন দেখানো যায়নি কারণ বিজ্ঞাপনের অবজেক্ট আগেই ব্যবহার করা হয়েছে।
    104 বিজ্ঞাপন রেডি না থাকার কারণে DT Exchange বিজ্ঞাপন দেখানো যায়নি।
    ১০৫ DT SDK শুরু করার সময় সমস্যা হয়েছে।

    DT Exchange Flutter মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

    ভার্সন ১.৩.৭

    ভার্সন ১.৩.৬

    ভার্সন 1.3.5

    ভার্সন ১.৩.৪

    • সর্বনিম্ন Flutter ভার্সন 3.38.1-এ আপডেট করা হয়েছে
    • Google Mobile Ads Flutter Plugin ভার্সন 8.0.0-এর সাথে কাজ করার জন্য আপডেট করা হয়েছে

    ভার্সন 1.3.3

    ভার্সন ১.৩.২

    ভার্সন ১.৩.১

    ভার্সন 1.2.0

    ভার্সন 1.1.5

    ভার্সন 1.1.4

    ভার্সন 1.1.3

    ভার্সন ১.১.২

    ভার্সন ১.১.১

    ভার্সন 1.1.0

    ভার্সন 1.0.0