মধ্যস্থতার সাথে Chartboost ইন্টিগ্রেট করা

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

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

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

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

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

পূর্বশর্ত

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

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

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

Chartboost অ্যাকাউন্টের জন্য সাইন-আপ করুন এবং আপনার অ্যাকাউন্ট যাচাই করা হয়ে গেলে লগ-ইন করুন। তারপরে, অ্যাপ ম্যানেজমেন্ট ট্যাবে নেভিগেট করুন।

Chartboost অ্যাপ ড্যাশবোর্ড

আপনার অ্যাপ তৈরি করতে, নতুন অ্যাপ যোগ করুন বোতামে ক্লিক করুন।

অ্যাপ ম্যানেজমেন্ট

বাকি ফর্ম পূরণ করুন এবং আপনার অ্যাপ চূড়ান্ত করতে অ্যাপ যোগ করুন বোতামে ক্লিক করুন ।

নতুন অ্যাপ ফর্ম

আপনার অ্যাপ তৈরি হয়ে গেলে, আপনাকে ড্যাশবোর্ডে নিয়ে যাওয়া হবে। আপনার অ্যাপের অ্যাপ আইডি ও অ্যাপ সিগনেচার নোট করে রাখুন।

Android

অ্যাপ সেটিংস

iOS

অ্যাপ সেটিংস

AdMob-এ আপনার বিজ্ঞাপন ইউনিট আইডি সেট-আপ করার জন্য Chartboost-এর ব্যবহারকারী আইডি এবং ব্যবহারকারীর স্বাক্ষর প্রয়োজন। Chartboost UI-তে Chartboost মধ্যস্থতা বিকল্পে ক্লিক করে আপনি এইসব প্যারামিটার খুঁজে পেতে পারেন।

Chartboost মধ্যস্থতা ড্যাশবোর্ড

রিসোর্স > API এক্সপ্লোরার ট্যাবে নেভিগেট করুন এবং যাচাইকরণ বিভাগের অধীনে থাকা আপনার ব্যবহারকারীর আইডি ও ব্যবহারকারীর স্বাক্ষর নোট করে নিন।

Chartboost API Explorer

আপনার app-ads.txt আপডেট করা

অ্যাপের জন্য অনুমোদিত বিক্রেতা app-ads.txt হল একটি IAB টেক ল্যাব ইনিশিয়েটিভ যা কনফার্ম করতে সাহায্য করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেনটরি আপনি যাদের অনুমোদিত হিসেবে শনাক্ত করেছেন, শুধুমাত্র সেইসব চ্যানেলের মাধ্যমেই বিক্রি করা কনফার্ম করতে সাহায্য করে। বিজ্ঞাপন থেকে হওয়া উপার্জনে উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। আপনি আগে থেকে এটি না করে থাকলে, আপনার অ্যাপের জন্য একটি app-ads.txt ফাইল সেট-আপ করুন।

Chartboost-এর জন্য app-ads.txt প্রয়োগ করতে, app-ads.txt দেখুন।

টেস্ট মোড চালু করা

Chartboost UI থেকে অ্যাপ ম্যানেজমেন্ট ট্যাবে গিয়ে, তালিকা থেকে আপনার অ্যাপ বেছে নিয়ে অ্যাপ সেটিংস এডিট করুন বিকল্পে ক্লিক করে আপনার অ্যাপে টেস্ট মোড চালু করতে পারবেন।

Android

অ্যাপ সেটিংস এডিট করা

iOS

অ্যাপ সেটিংস এডিট করা

আপনার অ্যাপের সেটিংস থেকে, অ্যাপে টেস্ট মোড টগল করতে পারবেন।

Chartboost টেস্ট মোড

টেস্ট মোড চালু হয়ে গেলে, আপনি আগে তৈরি করা বিজ্ঞাপন ইউনিট আইডি ব্যবহার করে বিজ্ঞাপনের অনুরোধ করতে এবং Chartboost টেস্ট বিজ্ঞাপন পেতে পারবেন।

Chartboost-এর টেস্ট বিজ্ঞাপন পাওয়ার পরে, আপনার অ্যাপ Chartboost-এর প্রকাশকের অ্যাপ পর্যালোচনা প্রক্রিয়ায় রাখা হবে। Chartboost-এ মনিটাইজেশন কাজ করার জন্য, প্রকাশকের অ্যাপ পর্যালোচনা Chartboost-এর দ্বারা অনুমোদিত হতে হবে।

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

OpenUPM-এর বিবরণ

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

Unity রেজিস্ট্রি

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

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

Unity প্যাকেজ

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

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

Unity থেকে ইমপোর্ট করা

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

জোর করে সমাধান করা

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

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

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

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

নিচে দেওয়া স্যাম্পেল কোড ডেটা ব্যবহার সম্মতিকে OptInSale-এ সেট করে। আপনি এই পদ্ধতি কল করার বিকল্প বেছে নিলে, Google Mobile Ads Unity Plugin ব্যবহার করে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার জন্য সাজেস্ট করা হয়।

using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

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

Android

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

iOS

SKAdNetwork ইন্টিগ্রেশন

আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, Chartboost-এর ডকুমেন্টেশন অনুসরণ করুন।

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

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

AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন এবং Chartboost UI-তে টেস্ট মোড চালু করেছেন কিনা তা নিশ্চিত করুন।

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

আপনি Chartboost থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, বিজ্ঞাপন পরিদর্শকে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন। এর জন্য Chartboost (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করুন।

ঐচ্ছিক ধাপ

Android

অনুমতি

অপ্টিমাল পারফর্ম্যান্সের জন্য, Chartboost আপনার অ্যাপের AndroidManifest.xml ফাইলে নিম্নলিখিত ঐচ্ছিক অনুমতি যোগ করার সাজেশন দেয়:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

iOS

iOS ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত ধাপের প্রয়োজন নেই।

সমস্যার কোড

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

Android

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

iOS

GADMAdapterChartboost
GADMediationAdapterChartboost

বিজ্ঞাপন লোড করা না গেলে Chartboost অ্যাডাপ্টার এই কোড ও মেসেজ দেখায়:

Android

সমস্যার কোড কারণ
0-99 Chartboost SDK-তে সমস্যা হয়েছে।
১০১ অনুরোধ করা বিজ্ঞাপনের সাইজ Chartboost-এ কাজ করে এমন ব্যানার সাইজের সাথে মিলছে না।
102 Chartboost কোনও লোকেশনে একবারে শুধুমাত্র ১টি বিজ্ঞাপন লোড করতে পারে।
103 AdMob UI-তে কনফিগার করা Chartboost সার্ভার প্যারামিটার নেই/ভুল।
104 Chartboost ইন্টারস্টিশিয়াল বা পুরস্কার প্রদানকারী বিজ্ঞাপন দেখানোর জন্য রেডি নেই।

iOS

সমস্যার কোড কারণ
১০১ AdMob UI-তে কনফিগার করা Chartboost সার্ভার প্যারামিটার নেই/ভুল।
102 Chartboost SDK-তে ইনিশিয়ালাইজেশন সংক্রান্ত সমস্যা হয়েছে।
103 দেখানোর সময় Chartboost বিজ্ঞাপন ক্যাশে করা হয় না।
104 অনুরোধ করা বিজ্ঞাপনের সাইজ Chartboost-এ কাজ করে এমন ব্যানার সাইজের সাথে মিলছে না।
১০৫ ডিভাইসের OS ভার্সন Chartboost SDK-এর ন্যূনতম কাজ করে এমন OS ভার্সনের থেকে কম।
200-299 Chartboost SDK ক্যাশে সংক্রান্ত সমস্যা। আরও বিবরণের জন্য কোড দেখুন।
300-399 Chartboost SDK-তে সমস্যা দেখা দেয়। আরও বিবরণের জন্য কোড দেখুন।
400-499 Chartboost SDK-তে ক্লিক সংক্রান্ত সমস্যা। আরও বিবরণের জন্য কোড দেখুন।

Chartboost Unity Mediation Plugin-এর পরিবর্তনের লগ

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

ভার্সন 4.15.0

ভার্সন 4.14.0

ভার্সন 4.13.0

ভার্সন 4.12.1

ভার্সন 4.12.0

ভার্সন 4.11.3

ভার্সন ৪.১১.২

ভার্সন 4.11.1

ভার্সন 4.11.0

ভার্সন 4.10.3

ভার্সন ৪.১০.২

ভার্সন 4.10.1

ভার্সন 4.10.0

ভার্সন 4.9.3

ভার্সন ৪.৯.২

ভার্সন 4.9.1

ভার্সন 4.9.0

ভার্সন 4.8.0

ভার্সন 4.7.3

ভার্সন ৪.৭.২

ভার্সন 4.7.1

ভার্সন 4.7.0

ভার্সন 4.6.1

ভার্সন 4.6.0

ভার্সন 4.5.0

ভার্সন 4.4.0

ভার্সন 4.3.0

ভার্সন 4.2.0

ভার্সন ৪.১.১

ভার্সন 4.1.0

ভার্সন 4.0.0

ভার্সন ৩.৫.১

ভার্সন 3.5.0

ভার্সন ৩.৪.১

ভার্সন 3.4.0

ভার্সন ৩.৩.১

ভার্সন 3.3.0

ভার্সন ৩.২.০

ভার্সন 3.1.0

ভার্সন 3.0.1

ভার্সন 3.0.0

ভার্সন 2.0.1

ভার্সন 2.0.0

  • Chartboost Android অ্যাডাপ্টার ভার্সন 7.5.0.0-এ কাজ করে।
  • Chartboost iOS অ্যাডাপ্টার ভার্সন 8.0.1.1-এ কাজ করে।

ভার্সন 1.3.0

  • নতুন 'পুরস্কার প্রদানকারী' API-এর সাথে কাজ করার জন্য প্লাগ-ইন আপডেট করা হয়েছে।
  • Chartboost Android অ্যাডাপ্টার ভার্সন 7.3.1.1-এ কাজ করে।
  • Chartboost iOS অ্যাডাপ্টার ভার্সন 7.5.0.0-এ কাজ করে।

ভার্সন 1.2.0

  • Chartboost Android অ্যাডাপ্টার ভার্সন 7.3.0.0-এ কাজ করে।
  • Chartboost iOS অ্যাডাপ্টার ভার্সন 7.3.0.0 কাজ করে।

ভার্সন 1.1.1

  • Chartboost Android অ্যাডাপ্টার ভার্সন 7.2.0.1-এ কাজ করে।
  • Chartboost iOS অ্যাডাপ্টার ভার্সন 7.2.0.1-এ কাজ করে।

ভার্সন 1.1.0

  • Chartboost Android SDK ভার্সন 7.2.0-এ কাজ করে।
  • Chartboost iOS SDK ভার্সন 7.2.0-এ কাজ করে।
  • Chartboost SDK-এর জন্য GDPR ডেটা সংগ্রহ সংক্রান্ত বিধিনিষেধ চালু করতে Chartboost.RestrictDataCollection() পদ্ধতি যোগ করা হয়েছে।

ভার্সন 1.0.0

  • প্রথম রিলিজ!
  • Chartboost Android SDK ভার্সন 7.0.1-এ কাজ করে।
  • Chartboost iOS SDK ভার্সন 7.1.2-এর সাথে কাজ করে।