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

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

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

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

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

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

পূর্বশর্ত

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

  • লেটেস্ট Google Mobile Ads Flutter Plugin ভার্সন।
  • Flutter ফ্রেমওয়ার্ক ভার্সন 3.7.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Android-এ ডিপ্লয় করতে
    • Android API লেভেল ২৪ বা তার পরবর্তী যেকোনও ভার্সন।
  • iOS-এ ডিপ্লয় করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরবর্তী যেকোনও ভার্সন।
  • Google Mobile Ads Flutter Plugin-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ করুন Google Mobile Ads Flutter 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 এবং অ্যাডাপ্টার ইম্পোর্ট করুন

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

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

    dependencies:
  gma_mediation_moloco: ^3.7.1

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

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

    dependencies:
  gma_mediation_moloco:
    path: path/to/local/package

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

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

    Moloco Ads SDK Flutter অ্যাডাপ্টার ভার্সন 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 Flutter Plugin-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে সেগুলি সেট করার জন্য সাজেস্ট করা হয়।

    import 'package:gma_mediation_moloco/gma_mediation_moloco.dart';
// ...

GmaMediationMoloco.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 Flutter মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

    ভার্সন 3.8.0 (প্রসেস চলছে)

    ভার্সন ৩.৭.১

    ভার্সন 3.7.0

    ভার্সন 3.6.1

    ভার্সন 3.6.0

    ভার্সন ৩.৫.১

    ভার্সন 3.5.0

    ভার্সন 3.4.0

    ভার্সন 3.3.0

    ভার্সন 3.2.0

    ভার্সন 3.1.0

    ভার্সন 3.0.0

    ভার্সন 2.1.0

    ভার্সন 2.0.0

    ভার্সন ১.৬.০

    ভার্সন ১.৫.০

    ভার্সন 1.4.0

    ভার্সন ১.৩.১

    ভার্সন ১.৩.০

    ভার্সন ১.২.০

    ভার্সন 1.1.0

    ভার্সন 1.0.0