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

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

এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে বিডিং ইন্টিগ্রেশন কভার করে মধ্যস্থতা ব্যবহার করে 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 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 প্যাকেজ ম্যানেজার খুলতে উইন্ডো > প্যাকেজ ম্যানেজার বিকল্পে নেভিগেট করুন এবং ড্রপ-ডাউন মেনু থেকে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

    Unity Registries

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

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

    Unity প্যাকেজ

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

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

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

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

    ফোর্স রিজলভ

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

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

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

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

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

    Moloco Ads SDK-এর জন্য Google Mobile Ads Unity মিডিয়েশন প্লাগ-ইনে Moloco.SetDoNotSell(bool) পদ্ধতি অন্তর্ভুক্ত আছে, যার মাধ্যমে Moloco Ads SDK SDK-তে সম্মতি সংক্রান্ত তথ্য পাস করা হয়। নিচের স্যাম্পেল কোড থেকে 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.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