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

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

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

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

DT Exchange-এর জন্য Unity মধ্যস্থতা অ্যাডাপ্টরের নিম্নলিখিত ক্ষমতা আছে:

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

পূর্বশর্ত

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

  • লেটেস্ট Google Mobile Ads Unity Plugin ভার্সন।
  • Unity Editor ভার্সন 4 বা তার পরবর্তী যেকোনও ভার্সন।
  • [বিডিংয়ের জন্য]: বিডিংয়ে কাজ করে এমন সব বিজ্ঞাপন ফর্ম্যাট ইন্টিগ্রেট করতে, DT Exchange 3.3.12 বা এর পরের যেকোনও ভার্সনের জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইন ব্যবহার করুন (লেটেস্ট ভার্সন ব্যবহার করার সাজেশন দেওয়া হয়)।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
  • iOS-এ ডেপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 15.0 বা তার পরের যেকোনও ভার্সন।
  • Google Mobile Ads Unity Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Unity প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads Unity 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 ও অ্যাডাপ্টার ইমপোর্ট করা

    OpenUPM-CLI

    আপনার OpenUPM-CLI ইনস্টল করা থাকলে, আপনার প্রোজেক্টের রুট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ড রান করে Unity-র জন্য Google Mobile Ads DT Exchange Mediation প্লাগ-ইন ইনস্টল করতে পারবেন:

    openupm add com.google.ads.mobile.mediation.dtexchange

    OpenUPM

    আপনার Unity প্রোজেক্ট এডিটরে, এডিট করুন > প্রোজেক্ট সেটিংস > প্যাকেজ ম্যানেজার বিকল্প বেছে নিয়ে Unity প্যাকেজ ম্যানেজার সেটিংস খুলুন।

    স্কোপড রেজিস্ট্রি ট্যাবের মধ্যে, নিম্নলিখিত বিবরণ সহ স্কোপড রেজিস্ট্রি হিসেবে OpenUPM যোগ করুন:

    • নাম: OpenUPM
    • URL: https://package.openupm.com
    • স্কোপ: com.google

    OpenUPM-এর বিবরণ

    তারপর, Unity Package Manager খুলতে উইন্ডো > প্যাকেজ ম্যানেজার বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

    Unity রেজিস্ট্রি

    Google Mobile Ads DTExchange Mediation প্যাকেজ বেছে নিয়ে ইনস্টল করুন বিকল্পে ক্লিক করুন।

    OpenUPM থেকে ইনস্টল করুন

    Unity প্যাকেজ

    DT Exchange-এর জন্য Google Mobile Ads মিডিয়েশন প্লাগ-ইনের লেটেস্ট ভার্সন চেঞ্জলগ-এ দেওয়া ডাউনলোড লিঙ্ক থেকে ডাউনলোড করুন এবং জিপ ফাইল থেকে GoogleMobileAdsDTExchangeMediation.unitypackage এক্সট্র্যাক্ট করুন।

    আপনার Unity প্রোজেক্ট এডিটরে, অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ বেছে নিন এবং আপনার ডাউনলোড করা GoogleMobileAdsDTExchangeMediation.unitypackage ফাইলটি খুঁজুন। সব ফাইল বেছে নেওয়া হয়েছে কিনা তা নিশ্চিত করুন এবং ইমপোর্ট করুন বিকল্পে ক্লিক করুন।

    Unity থেকে ইমপোর্ট করা

    তারপর, অ্যাসেট > এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার > Android Resolver > Force Resolve বিকল্প বেছে নিন। এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার লাইব্রেরি শুরু থেকে ডিপেন্ডেন্সি রেজোলিউশন পারফর্ম করবে এবং ঘোষিত ডিপেন্ডেন্সি আপনার Unity অ্যাপের Assets/Plugins/Android ডিরেক্টরিতে কপি করবে।

    জোর করে সমাধান করা

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

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

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

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

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

    DT Exchange ভার্সন 3.1.1-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগ-ইন SetCCPAString() মেথড সহ Fyber ক্লাস যোগ করেছে, যা আপনাকে DT Exchange-এ ম্যানুয়ালি সম্মতি সংক্রান্ত তথ্য পাস করতে দেয়। নিম্নলিখিত স্যাম্পেল কোড থেকে জানা যায় যে কীভাবে এইসব প্যারামিটার DT Exchange অ্যাডাপ্টারে পাস করতে হয়:

    using GoogleMobileAds.Api.Mediation.Fyber;
    // ...
    
    Fyber.SetCCPAString("myCCPAConsentString");
    
    // You can also clear CCPA consent information using the following method:
    Fyber.ClearCCPAString();
    

    আরও তথ্য এবং পদ্ধতিতে প্রদান করা যেতে পারে এমন ভ্যালুর জন্য DT Exchange-এর CCPA ওপেন সোর্স নিবন্ধটি দেখুন।

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

    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 Unity মধ্যস্থতা প্লাগ-ইন পরিবর্তনের লগ

    ভার্সন ৩.৬.০ (কাজ চলছে)

    ভার্সন ৩.৫.১৩

    ভার্সন 3.5.12

    ভার্সন ৩.৫.১১

    ভার্সন ৩.৫.১০

    ভার্সন ৩.৫.৯

    ভার্সন 3.5.8

    ভার্সন ৩.৫.৭

    ভার্সন ৩.৫.৬

    ভার্সন 3.5.5

    ভার্সন ৩.৫.৪

    ভার্সন ৩.৫.৩

    ভার্সন ৩.৫.২

    ভার্সন ৩.৫.১

    ভার্সন 3.5.0

    ভার্সন ৩.৪.০

    ভার্সন ৩.৩.১২

    ভার্সন ৩.৩.১১

    ভার্সন ৩.৩.১০

    ভার্সন ৩.৩.৯

    ভার্সন ৩.৩.৮

    ভার্সন ৩.৩.৭

    ভার্সন ৩.৩.৬

    ভার্সন ৩.৩.৫

    ভার্সন 3.3.4

    ভার্সন 3.3.3

    ভার্সন ৩.৩.২

    ভার্সন ৩.৩.১

    ভার্সন 3.3.0

    ভার্সন ৩.২.১

    ভার্সন ৩.২.০

    ভার্সন ৩.১.১২

    ভার্সন ৩.১১

    ভার্সন ৩.১.১০

    ভার্সন ৩.১.৮

    ভার্সন ৩.১.৭

    ভার্সন ৩.১.৬

    ভার্সন ৩.১.৫

    ভার্সন ৩.১.৪

    ভার্সন ৩.১.৩

    ভার্সন ৩.১.২

    ভার্সন ৩.১.১

    ভার্সন ৩.১.০

    ভার্সন ৩.০.২

    ভার্সন ৩.০.১

    ভার্সন 3.0.0

    ভার্সন 2.0.0

    ভার্সন ১.৬.১

    ভার্সন 1.6.0

    ভার্সন ১.৫.২

    ভার্সন ১.৫.১

    ভার্সন 1.5.0

    ভার্সন 1.4.0

    ভার্সন 1.3.0

    ভার্সন ১.২.৩

    ভার্সন ১.২.২

    ভার্সন ১.২.১

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0