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

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

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

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

Moloco Ads SDK-এর জন্য Ad Manager মিডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:

ইন্টিগ্রেশন
বিডিং
জলপ্রপাত
ফর্ম্যাট
অ্যাপ খোলার সাথে সাথে দেখা যায়
ব্যানার
স্থান
পুরস্কার জিতেছেন
পুরস্কৃত ইন্টারস্টিশিয়াল

পূর্বশর্ত

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

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

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

    Moloco Publisher Portal-এ লগ-ইন করুন।

    ওভারভিউ > অ্যাপ ট্যাবে নেভিগেট করুন, তারপর নতুন অ্যাপ তৈরি করতে অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

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

    Android

    iOS

    আপনার অ্যাপ তৈরি হয়ে গেলে, বিবরণ দেখতে অ্যাপ ট্যাব থেকে সেটি বেছে নিন এবং অ্যাপ কী নোট করুন।

    Android

    iOS

    ওভারভিউ > বিজ্ঞাপন ইউনিট ট্যাবে নেভিগেট করুন, ড্রপ-ডাউন মেনু থেকে অ্যাপ বেছে নিন এবং তারপরে নতুন বিজ্ঞাপন ইউনিট বিকল্পে ক্লিক করুন।

    নিলামের পদ্ধতি হিসেবে ইন-অ্যাপ বিডিং বেছে নিন এবং ফর্মের বাকি অংশ পূরণ করুন। তারপরে, তৈরি করুন বিকল্পে ক্লিক করুন।

    বিজ্ঞাপন ইউনিট ট্যাবের অধীনে আপনার নতুন তৈরি করা বিজ্ঞাপন ইউনিটে নেভিগেট করে সেটির বিবরণ দেখুন। বিজ্ঞাপন ইউনিট আইডি নোট করে রাখুন।

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

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

    Android

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

    iOS

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

    জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় Moloco Ads যোগ করুন

    Ad Manager UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনার তালিকায় Moloco Ads যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করুন।

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

    OpenUPM-CLI

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

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

    OpenUPM

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

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

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

    OpenUPM-এর বিবরণ

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

    Unity রেজিস্ট্রি

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

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

    Unity প্যাকেজ

    Moloco Ads SDK-এর জন্য Google Mobile Ads মেডিটেশন প্লাগ-ইনের লেটেস্ট ভার্সন পরিবর্তনের লগ থেকে ডাউনলোড লিঙ্কে গিয়ে ডাউনলোড করুন এবং zip ফাইল থেকে GoogleMobileAdsMolocoMediation.unitypackage এক্সট্র্যাক্ট করুন।

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

    Unity থেকে ইমপোর্ট করুন

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

    ফোর্স রিজলভ

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

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

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

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

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

    Moloco Ads SDK-এর জন্য Google Mobile Ads Unity মেডিটেশন প্লাগ-ইনে Moloco Ads SDK SDK-কে সম্মতি সংক্রান্ত তথ্য পাস করার জন্যMoloco.SetDoNotSell(bool) মেথড অন্তর্ভুক্ত থাকে। নিম্নলিখিত নমুনা কোড দেখায় যে কীভাবে এই সম্মতি সংক্রান্ত তথ্য Moloco Ads SDK SDK-তে পাস করতে হয়। আপনি যদি এইসব ফ্ল্যাগ সেট করতে চান, তাহলে Google Mobile Ads Unity Plugin-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে সেগুলি সেট করার জন্য সাজেস্ট করা হয়।

    using GoogleMobileAds.Api.Mediation.Moloco;
// ...

Moloco.SetDoNotSell(true);

    আরও তথ্যের জন্য Android এবং iOS-এর জন্য Moloco Ads SDK-এর সাজেস্ট করা প্রয়োগ নির্দেশাবলী দেখুন।

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

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

    ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করা

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

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।

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

    আপনি Moloco Ads SDK থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Moloco (Bidding) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।

    সমস্যার কোড

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

    Android

    com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

    iOS

    MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

    Android

    সমস্যার কোড ডোমেন কারণ
    ১০১ com.google.ads.mediation.moloco Moloco অ্যাপ 'কী' নেই বা ভুল আছে।
    102 com.google.ads.mediation.moloco Moloco বিজ্ঞাপন ইউনিট আইডি উল্লেখ করা হয়নি বা ভুল হয়েছে।
    103 com.google.ads.mediation.moloco Moloco বিজ্ঞাপন অবজেক্ট থেকে কোনও ভ্যালু পাওয়া যায়নি।
    -১ থেকে ৫০০০০ com.moloco.sdk Moloco SDK-তে সমস্যা হয়েছে। আরও বিবরণের জন্য Moloco-এর ডকুমেন্টেশন দেখুন।

    iOS

    সমস্যার কোড ডোমেন কারণ
    ১০১ com.google.ads.mediation.moloco Moloco SDK, iOS 12 ও তার আগের যেকোনও ভার্সনে বিজ্ঞাপন দেখানোর সুবিধা দেয় না।
    102 com.google.ads.mediation.moloco Moloco অ্যাপ 'কী' নেই বা ভুল আছে।
    103 com.google.ads.mediation.moloco Moloco বিজ্ঞাপন ইউনিট আইডি উল্লেখ করা হয়নি বা ভুল হয়েছে।
    104 com.google.ads.mediation.moloco বিজ্ঞাপন দেখানোর জন্য রেডি নয়।
    ১০৫ com.google.ads.mediation.moloco বিজ্ঞাপন দেখানো যায়নি।
    106 com.google.ads.mediation.moloco বিজ্ঞাপন রেন্ডার করার জন্য রেন্ডারিং ডেটা উপলভ্য নেই।
    -১ থেকে ৫০০০ Moloco SDK-এর মাধ্যমে পাঠানো হয়েছে Moloco SDK-তে সমস্যা হয়েছে। আরও তথ্যের জন্য Moloco-এর ডকুমেন্টেশন দেখুন।

    Moloco Unity Mediation প্লাগ-ইন চেঞ্জলগ

    ভার্সন 3.11.0 (কাজ চলছে)

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

    ভার্সন 3.10.0

    ভার্সন ৩.৯.১

    ভার্সন 3.9.0

    ভার্সন ৩.৮.১

    ভার্সন 3.8.0

    ভার্সন 3.7.0

    ভার্সন ৩.৬.১

    ভার্সন 3.6.0

    ভার্সন ৩.৫.১

    ভার্সন 3.5.0

    ভার্সন ৩.৪.১

    ভার্সন 3.4.0

    ভার্সন ৩.৩.১

    ভার্সন 3.3.0

    ভার্সন ৩.২.০

    ভার্সন ৩.১.০

    ভার্সন 3.0.0

    ভার্সন ২.২.১

    ভার্সন ২.২.০

    ভার্সন ২.১.০

    ভার্সন 2.0.0

    ভার্সন ১.৬.১

    ভার্সন 1.6.0

    ভার্সন 1.5.0

    ভার্সন ১.৪.০

    ভার্সন ১.৩.১

    ভার্সন 1.3.0

    ভার্সন ১.২.১

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0