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

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

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

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

Moloco Ads SDK-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টরে নিম্নলিখিত ক্ষমতা আছে:

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

পূর্বশর্ত

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

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

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

Moloco প্রকাশক পোর্টালে লগ-ইন করুন।

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

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

Android

iOS

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

Android

iOS

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

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

আপনার নতুন তৈরি করা বিজ্ঞাপন ইউনিটের বিস্তারিত তথ্য দেখতে বিজ্ঞাপন ইউনিট ট্যাবে নেভিগেট করুন। বিজ্ঞাপন ইউনিট আইডি মনে রাখবেন।

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_moloco: ^3.7.1

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

এর জন্য Google Mobile Ads মেডিটেশন প্লাগ-ইনের লেটেস্ট ভার্সন ডাউনলোড করুন: Moloco Ads SDK, ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগ-ইন ফোল্ডারটি (এবং এর কন্টেন্ট) আপনার 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-তে জিডিপিআর সম্মতি সিগন্যাল পাস করার সুবিধা দেয়। আরও তথ্যের জন্য, Android-এর জন্য MolocoPrivacy ডকুমেন্টেশন এবং iOS-এর জন্য TCF সম্মতি স্ট্রিং দেখুন।

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

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

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

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

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

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

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

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

সমস্যার কোড

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.7.1

ভার্সন 3.7.0

ভার্সন 3.6.1

ভার্সন 3.6.0

ভার্সন 3.5.1

ভার্সন 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.6.0

ভার্সন 1.5.0

ভার্সন 1.4.0

ভার্সন 1.3.1

ভার্সন 1.3.0

ভার্সন 1.2.0

ভার্সন 1.1.0

ভার্সন 1.0.0