মধ্যস্থতার সাথে Chartboost সংহত করুন

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)নতুন অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

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

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

Chartboost-এর জন্য AdMob মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

একীকরণ
নিলাম
জলপ্রপাত
ফর্ম্যাট
ব্যানার
ইন্টারস্টিশিয়াল
পুরস্কৃত

প্রয়োজনীয়তা

  • সর্বশেষ Google Mobile Ads Unity Plugin
  • ইউনিটি ৪ বা উচ্চতর
  • অ্যান্ড্রয়েডে স্থাপন করতে
    • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
  • iOS-এ স্থাপন করতে
    • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
  • Google Mobile Ads Unity Plugin দিয়ে কনফিগার করা একটি কার্যকরী ইউনিটি প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Unity Plugin সেট আপ করুন’ দেখুন।
  • AdMob মিডিয়েশন সেট আপ করুন

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

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

চার্টবুস্ট অ্যাপস ড্যাশবোর্ড

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

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

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

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

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

অ্যান্ড্রয়েড

অ্যাপ সেটিংস

আইওএস

অ্যাপ সেটিংস

আপনার AdMob অ্যাড ইউনিট আইডি সেট আপ করার জন্য AdMob-এর Chartboost ইউজার আইডি এবং ইউজার সিগনেচার প্রয়োজন হয়। আপনি Chartboost UI-তে Chartboost মিডিয়েশন-এ ক্লিক করে এই প্যারামিটারগুলো খুঁজে পেতে পারেন।

চার্টবুস্ট মেডিয়েশন ড্যাশবোর্ড

Resources > API Explorer ট্যাবে যান এবং Authentication সেকশনের অধীনে থাকা আপনার User ID ও User Signature লিখে নিন।

চার্টবুস্ট এপিআই এক্সপ্লোরার

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

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

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

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

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

অ্যান্ড্রয়েড

অ্যাপ সেটিংস সম্পাদনা করুন

আইওএস

অ্যাপ সেটিংস সম্পাদনা করুন

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

চার্টবুস্ট টেস্ট মোড

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

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

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

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

অ্যান্ড্রয়েড

নির্দেশাবলীর জন্য, অ্যান্ড্রয়েড গাইডের ধাপ ২ দেখুন।

আইওএস

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

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা সংক্রান্ত বিজ্ঞাপন অংশীদারদের তালিকায় Charboost-কে যুক্ত করুন

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

ধাপ ৩: চার্টবুস্ট এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

ওপেনইউপিএম-সিএলআই

আপনার যদি OpenUPM-CLI ইনস্টল করা থাকে, তাহলে আপনার প্রোজেক্টের রুট ডিরেক্টরি থেকে নিম্নলিখিত কমান্ডটি চালিয়ে আপনার প্রোজেক্টে ইউনিটির জন্য গুগল মোবাইল অ্যাডস চার্টবুস্ট মিডিয়েশন প্লাগইনটি ইনস্টল করতে পারেন:

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

ওপেনইউপিএম

আপনার ইউনিটি প্রজেক্ট এডিটরে, ইউনিটি প্যাকেজ ম্যানেজার সেটিংস খুলতে এডিট > প্রজেক্ট সেটিংস > প্যাকেজ ম্যানেজার নির্বাচন করুন।

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

  • নাম: OpenUPM
  • URL: https://package.openupm.com
  • স্কোপ(গুলি): com.google

ওপেনইউপিএম বিবরণ

এরপর, ইউনিটি প্যাকেজ ম্যানেজার খুলতে Window > Package Manager- এ যান এবং ড্রপ-ডাউন মেনু থেকে My Registries নির্বাচন করুন।

ইউনিটি রেজিস্ট্রি

Google Mobile Ads Chartboost Mediation প্যাকেজটি নির্বাচন করুন এবং Install-এ ক্লিক করুন।

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

ইউনিটি প্যাকেজ

চেঞ্জলগে দেওয়া ডাউনলোড লিঙ্ক থেকে চার্টবুস্টের জন্য গুগল মোবাইল অ্যাডস মিডিয়েশন প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন এবং জিপ ফাইলটি থেকে GoogleMobileAdsChartboostMediation.unitypackage ফাইলটি এক্সট্র্যাক্ট করুন।

আপনার ইউনিটি প্রজেক্ট এডিটরে, Assets > Import Package > Custom Package নির্বাচন করুন এবং আপনার ডাউনলোড করা GoogleMobileAdsChartboostMediation.unitypackage ফাইলটি খুঁজুন। নিশ্চিত করুন যে সমস্ত ফাইল নির্বাচিত আছে এবং Import-এ ক্লিক করুন।

ইউনিটি থেকে আমদানি করুন

এরপর, Assets > External Dependency Manager > Android Resolver > Force Resolve নির্বাচন করুন। External Dependency Manager লাইব্রেরিটি প্রথম থেকে ডিপেন্ডেন্সি রেজোলিউশন করবে এবং ঘোষিত ডিপেন্ডেন্সিগুলোকে আপনার Unity অ্যাপের Assets/Plugins/Android ডিরেক্টরিতে কপি করে দেবে।

ফোর্স রিজলভ

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

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

চার্টবুস্ট সংস্করণ ৩.১.০-এর জন্য গুগল মোবাইল অ্যাডস মিডিয়েশন প্লাগইনটিতে Chartboost.AddDataUseConsent() মেথডটি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি ডেটা ব্যবহারের সম্মতিকে NonBehavioral এ সেট করে। আপনি যদি এই মেথডটি কল করার সিদ্ধান্ত নেন, Google Mobile Ads Unity Plugin ব্যবহার করে বিজ্ঞাপনের অনুরোধ করার আগে তা করার পরামর্শ দেওয়া হচ্ছে।

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

Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);

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

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

চার্টবুস্ট সংস্করণ ৩.১.০-এর জন্য গুগল মোবাইল অ্যাডস মিডিয়েশন প্লাগইনটিতে Chartboost.AddDataUseConsent() মেথডটি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি OptInSale জন্য ডেটা ব্যবহারের সম্মতি সেট করে। আপনি যদি এই মেথডটি কল করতে চান, Google Mobile Ads Unity Plugin ব্যবহার করে বিজ্ঞাপনের অনুরোধ করার আগে তা করার পরামর্শ দেওয়া হচ্ছে।

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

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

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

অ্যান্ড্রয়েড

চার্টবুস্ট ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত কোডের প্রয়োজন নেই।

আইওএস

SKAdনেটওয়ার্ক ইন্টিগ্রেশন

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

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

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

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি চার্টবুস্ট থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে চার্টবুস্ট (ওয়াটারফল) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ঐচ্ছিক পদক্ষেপ

অ্যান্ড্রয়েড

অনুমতি

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

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

আইওএস

iOS ইন্টিগ্রেশনের জন্য কোনো অতিরিক্ত পদক্ষেপের প্রয়োজন নেই।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি চার্টবুস্ট থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে থাকা ResponseInfo ব্যবহার করে বিজ্ঞাপনের রেসপন্স থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

অ্যান্ড্রয়েড 

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

আইওএস 

GADMAdapterChartboost
GADMediationAdapterChartboost

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন চার্টবুস্ট অ্যাডাপ্টার যে কোড এবং তার সাথে বার্তাগুলো প্রদর্শন করে, তা নিচে দেওয়া হলো:

অ্যান্ড্রয়েড

ত্রুটি কোড কারণ
০-৯৯ Chartboost SDK একটি ত্রুটি দেখিয়েছে।
১০১ অনুরোধ করা বিজ্ঞাপনের আকারটি চার্টবুস্ট সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০২ চার্টবুস্ট একবারে প্রতিটি অবস্থানে কেবল ১টি বিজ্ঞাপন লোড করতে পারে।
১০৩ AdMob UI-তে কনফিগার করা Chartboost সার্ভার প্যারামিটারগুলো অনুপস্থিত/অবৈধ।
১০৪ চার্টবুস্ট ইন্টারস্টিশিয়াল বা রিওয়ার্ডেড বিজ্ঞাপনটি প্রদর্শনের জন্য প্রস্তুত নয়।

আইওএস

ত্রুটি কোড কারণ
১০১ AdMob UI-তে কনফিগার করা Chartboost সার্ভার প্যারামিটারগুলো অনুপস্থিত/অবৈধ।
১০২ চার্টবুস্ট এসডিকে একটি প্রারম্ভিক ত্রুটি দেখিয়েছে।
১০৩ প্রদর্শনের সময় চার্টবুস্ট বিজ্ঞাপনটি ক্যাশ করা থাকে না।
১০৪ অনুরোধ করা বিজ্ঞাপনের আকারটি চার্টবুস্ট সমর্থিত ব্যানার আকারের সাথে মেলে না।
১০৫ ডিভাইসটির ওএস ভার্সন চার্টবুস্ট এসডিকে-এর সর্বনিম্ন সমর্থিত ওএস ভার্সনের চেয়ে কম।
২০০-২৯৯ Chartboost SDK ক্যাশে ত্রুটি। আরও বিস্তারিত জানতে কোড দেখুন।
৩০০-৩৯৯ Chartboost SDK-তে ত্রুটি দেখাচ্ছে। আরও বিস্তারিত জানতে কোড দেখুন।
৪০০-৪৯৯ Charboost SDK-তে ক্লিকজনিত ত্রুটি। আরও বিস্তারিত জানতে কোড দেখুন।

চার্টবুস্ট ইউনিটি মেডিয়েশন প্লাগইন পরিবর্তন তালিকা

সংস্করণ ৪.১১.২

সংস্করণ ৪.১১.১

সংস্করণ ৪.১১.০

সংস্করণ ৪.১০.৩

সংস্করণ ৪.১০.২

সংস্করণ ৪.১০.১

সংস্করণ ৪.১০.০

সংস্করণ ৪.৯.৩

সংস্করণ ৪.৯.২

সংস্করণ ৪.৯.১

সংস্করণ ৪.৯.০

সংস্করণ ৪.৮.০

সংস্করণ ৪.৭.৩

সংস্করণ ৪.৭.২

সংস্করণ ৪.৭.১

সংস্করণ ৪.৭.০

সংস্করণ ৪.৬.১

সংস্করণ ৪.৬.০

সংস্করণ ৪.৫.০

সংস্করণ ৪.৪.০

সংস্করণ ৪.৩.০

সংস্করণ ৪.২.০

সংস্করণ ৪.১.১

সংস্করণ ৪.১.০

সংস্করণ ৪.০.০

সংস্করণ ৩.৫.১

সংস্করণ ৩.৫.০

সংস্করণ ৩.৪.১

সংস্করণ ৩.৪.০

সংস্করণ ৩.৩.১

সংস্করণ ৩.৩.০

সংস্করণ ৩.২.০

সংস্করণ ৩.১.০

সংস্করণ ৩.০.১

সংস্করণ ৩.০.০

সংস্করণ ২.০.১

সংস্করণ ২.০.০

  • চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.5.0.0 সমর্থন করে।
  • Chartboost iOS অ্যাডাপ্টার সংস্করণ 8.0.1.1 সমর্থন করে।

সংস্করণ ১.৩.০

  • নতুন রিওয়ার্ডেড এপিআই সমর্থন করার জন্য প্লাগইনটি আপডেট করা হয়েছে।
  • চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ ৭.৩.১.১ সমর্থন করে।
  • Chartboost iOS অ্যাডাপ্টার সংস্করণ 7.5.0.0 সমর্থন করে।

সংস্করণ ১.২.০

  • চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 7.3.0.0 সমর্থন করে।
  • Chartboost iOS অ্যাডাপ্টার সংস্করণ 7.3.0.0 সমর্থন করে।

সংস্করণ ১.১.১

  • চার্টবুস্ট অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ ৭.২.০.১ সমর্থন করে।
  • Chartboost iOS অ্যাডাপ্টার সংস্করণ 7.2.0.1 সমর্থন করে।

সংস্করণ ১.১.০

  • চার্টবুস্ট অ্যান্ড্রয়েড এসডিকে সংস্করণ 7.2.0 সমর্থন করে।
  • Chartboost iOS SDK সংস্করণ 7.2.0 সমর্থন করে।
  • Chartboost SDK-এর জন্য GDPR ডেটা সংগ্রহের সীমাবদ্ধতা সক্রিয় করতে Chartboost.RestrictDataCollection() মেথডটি যোগ করা হয়েছে।

সংস্করণ ১.০.০

  • প্রথম প্রকাশ!
  • চার্টবুস্ট অ্যান্ড্রয়েড এসডিকে সংস্করণ 7.0.1 সমর্থন করে।
  • Chartboost iOS SDK সংস্করণ 7.1.2 সমর্থন করে।