এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে বিডিং ইন্টিগ্রেশন কভার করে মধ্যস্থতা ব্যবহার করে Moloco Ads SDK থেকে বিজ্ঞাপন লোড ও দেখানোর জন্য কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করতে হয়। এতে বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে Moloco Ads SDK কীভাবে যোগ করতে হয় এবং React Native অ্যাপে Moloco Ads SDK SDK ও অ্যাডাপ্টার কীভাবে ইন্টিগ্রেট করতে হয় সেই সম্পর্কে আলোচনা করা হয়েছে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
Moloco Ads SDK-এর জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| অ্যাপ খোলা | |
| ব্যানার | |
| স্থান | |
| পুরস্কার জিতেছেন | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:
- লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
- React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Android-এ ডিপ্লয় করতে
- Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
- iOS-এ ডিপ্লয় করতে
- iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
- Google Mobile Ads SDK for React Native-এর সাথে কনফিগার করা একটি কার্যকরী React Native প্রোজেক্ট। আরও বিবরণের জন্য সেট-আপ করুন
Google Mobile Ads SDK for React Native দেখুন।
gma-sdk-react-nativeফোল্ডার থেকেadaptersফোল্ডার ডাউনলোড ও এক্সট্র্যাক্ট করেছেন কিনা তা নিশ্চিত করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, Google Mobile Ads SDK for React Native ইনস্টল করুন বিকল্পে গিয়ে এক, দুই ও তিন নম্বর ধাপ অনুসরণ করুন।
- AdMob মেডিয়েশন সেট-আপ করুন।
ধাপ ১: Moloco Ads SDK UI-তে কনফিগারেশন সেট-আপ করুন
Moloco Publisher Portal-এ লগ-ইন করুন।
এক নজরে > অ্যাপ ট্যাবে গিয়ে অ্যাপ যোগ করুন বোতামে ক্লিক করে নতুন অ্যাপ তৈরি করুন।
আপনার অ্যাপের জন্য OS এবং গোপনীয়তা সেটিংস বেছে নিন, ফর্মের বাকি অংশ পূরণ করুন এবং তারপরে তৈরি করুন বিকল্পে ক্লিক করুন।
Android
iOS
আপনার অ্যাপ তৈরি হয়ে গেলে, বিবরণ দেখতে অ্যাপ ট্যাব থেকে সেটি বেছে নিন এবং অ্যাপ কী নোট করুন।
Android
iOS
এক নজরে > বিজ্ঞাপন ইউনিট ট্যাবে যান, ড্রপ-ডাউন মেনু থেকে অ্যাপ বেছে নিন এবং তারপরে নতুন বিজ্ঞাপন ইউনিট বিকল্পে ক্লিক করুন।
নিলামের পদ্ধতি হিসেবে ইন-অ্যাপ বিডিং বেছে নিন এবং ফর্মের বাকি অংশ পূরণ করুন। তারপরে, তৈরি করুন বিকল্পে ক্লিক করুন।
বিজ্ঞাপন ইউনিট ট্যাবের অধীনে আপনার নতুন তৈরি করা বিজ্ঞাপন ইউনিটে নেভিগেট করে সেটির বিবরণ দেখুন। বিজ্ঞাপন ইউনিট আইডি নোট করে রাখুন।
ধাপ ২: AdMob UI-তে Moloco Ads SDK ডিমান্ড সেট-আপ করা
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারের তালিকায় Moloco Ads যোগ করুন
AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় Moloco Ads যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস বিকল্পে দেওয়া ধাপগুলি অনুসরণ করুন।
ধাপ ৩: Moloco Ads SDK SDK ও অ্যাডাপ্টার ইম্পোর্ট করুন
আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, Google Mobile Ads SDK for React Native Moloco Ads SDK-এর জন্য মধ্যস্থতা অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি
gma-sdk-react-native/adapters/moloco/ডিরেক্টরি থেকে আপনার প্রোজেক্টেরlocal_packages/ডিরেক্টরিতে কপি করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/moloco/gma-mediation-moloco-0.1.0.tgz local_packages/EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।
আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:
npm
npm install ./local_packages/gma-mediation-moloco-0.1.0.tgzতন্তু
yarn add ./local_packages/gma-mediation-moloco-0.1.0.tgz
ধাপ ৪: Moloco SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
Moloco Ads SDK React Native অ্যাডাপ্টার ভার্সন
0.1.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 SDK for React Native-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে
সেগুলি সেট করার জন্য সাজেস্ট করা হয়।
import { MolocoMediation } from '@google/gma-mediation-moloco';
// ...
MolocoMediation.setDoNotSell(true);
আরও তথ্যের জন্য Android এবং iOS-এর জন্য Moloco Ads SDK-এর সাজেস্ট করা প্রয়োগ করার নির্দেশাবলী দেখুন।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
Moloco Ads SDK ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি 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 বিজ্ঞাপন অবজেক্ট থেকে কোনও ডেটা পাওয়া যায়নি। |
| 104 | com.google.ads.mediation.moloco | Moloco SDK শুরু করা যায়নি। |
| -১ থেকে ৫০০০ | 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-এর ডকুমেন্টেশন দেখুন। |
ভার্সন 0.1.0
- প্রাথমিক রিলিজ।
- Moloco Android অ্যাডাপ্টার ভার্সন 4.12.0.1-এ কাজ করে।
- Moloco iOS অ্যাডাপ্টার ভার্সন 4.10.0.0 কাজ করে।
- Google Mobile Ads React Native প্লাগ-ইন ভার্সন 0.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।