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

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

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

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

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

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

পূর্বশর্ত

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

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

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

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

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

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

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

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

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

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

    Android

    অ্যাপ সেটিংস

    iOS

    অ্যাপ সেটিংস

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

    Chartboost মিডিয়েশন ড্যাশবোর্ড

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

    Chartboost API Explorer

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

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

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

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

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

    Android

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

    iOS

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

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

    Chartboost টেস্ট মোড

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

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

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

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

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

    OpenUPM

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

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

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

    OpenUPM-এর বিবরণ

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

    Unity Registries

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

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

    Unity প্যাকেজ

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

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

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

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

    ফোর্স রিজলভ

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

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

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

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

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

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

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

    Android

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

    iOS

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

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

    ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন

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

    Ad Manager-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা এবং 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 Ad Manager UI-তে কনফিগার করা Chartboost সার্ভার প্যারামিটার নেই/ভুল।
    104 Chartboost ইন্টারস্টিশিয়াল বা পুরস্কার প্রদানকারী বিজ্ঞাপন দেখানোর জন্য প্রস্তুত নয়।

    iOS

    সমস্যার কোড কারণ
    ১০১ Ad Manager 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 প্লাগ-ইন চেঞ্জলগ

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

    ভার্সন 4.15.1

    ভার্সন 4.15.0

    ভার্সন 4.14.0

    ভার্সন 4.13.0

    ভার্সন 4.12.1

    ভার্সন 4.12.0

    ভার্সন 4.11.3

    ভার্সন 4.11.2

    ভার্সন 4.11.1

    ভার্সন 4.11.0

    ভার্সন 4.10.3

    ভার্সন 4.10.2

    ভার্সন 4.10.1

    ভার্সন 4.10.0

    ভার্সন 4.9.3

    ভার্সন 4.9.2

    ভার্সন 4.9.1

    ভার্সন 4.9.0

    ভার্সন 4.8.0

    ভার্সন ৪.৭.৩

    ভার্সন 4.7.2

    ভার্সন ৪.৭.১

    ভার্সন 4.7.0

    ভার্সন 4.6.1

    ভার্সন 4.6.0

    ভার্সন 4.5.0

    ভার্সন 4.4.0

    ভার্সন 4.3.0

    ভার্সন ৪.২.০

    ভার্সন ৪.১.১

    ভার্সন 4.1.0

    ভার্সন 4.0.0

    ভার্সন ৩.৫.১

    ভার্সন 3.5.0

    ভার্সন ৩.৪.১

    ভার্সন 3.4.0

    ভার্সন ৩.৩.১

    ভার্সন 3.3.0

    ভার্সন ৩.২.০

    ভার্সন ৩.১.০

    ভার্সন ৩.০.১

    ভার্সন 3.0.0

    ভার্সন ২.০.১

    ভার্সন 2.0.0

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

    ভার্সন ১.৩.০

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

    ভার্সন ১.২.০

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

    ভার্সন ১.১.১

    • 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-এ কাজ করে।