গুগল মোবাইল অ্যাডস এসডিকে রক্ষণাবেক্ষণ মোডে আছে। সর্বশেষ আপডেট এবং ফিচার পেতে, জিএমএ নেক্সট-জেন এসডিকে মাইগ্রেট ও সেট আপ করুন ।

আপনার পছন্দের ভাষায় কন্টেন্ট অনুবাদ করতে Google তার AI প্রযুক্তি ব্যবহার করে। AI-এর মাধ্যমে করা অনুবাদে ভুল থাকতে পারে।

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

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

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

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

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

পূর্বশর্ত

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

Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।

লেটেস্ট Google Mobile Ads SDK (Legacy) ভার্সন।
AdMob মেডিয়েশন সেট-আপ করুন।

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

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

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

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

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

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

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

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

অ্যাপ সেটিংস

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

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

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

Chartboost API Explorer

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

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

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

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

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

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

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

Chartboost টেস্ট মোড

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

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

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

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

আপনার বিজ্ঞাপন ইউনিটের জন্য মিডিয়েশন কনফিগারেশনে Chartboost যোগ করতে হবে।

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

নতুন মধ্যস্থতা গ্রুপ তৈরি করতে, মধ্যস্থতা গ্রুপ তৈরি করুন বিকল্প বেছে নিন।

আপনার বিজ্ঞাপনের ফর্ম্যাট ও প্ল্যাটফর্ম লিখে চালিয়ে যান বিকল্পে ক্লিক করুন।

আপনার মিডিয়েশন গ্রুপের নাম দিন এবং টার্গেট করার জন্য লোকেশন বেছে নিন। এরপর, মধ্যস্থতা গ্রুপের স্ট্যাটাস চালু করা আছে হিসেবে সেট করুন এবং তারপর বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।

আপনার এক বা একাধিক AdMob বিজ্ঞাপন ইউনিটের সাথে এই মধ্যস্থতা গ্রুপ অ্যাসোসিয়েট করুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

আপনি এখন বিজ্ঞাপন ইউনিটের কার্ডে আপনার বেছে নেওয়া বিজ্ঞাপন ইউনিট দেখতে পাবেন:

বিজ্ঞাপনের সোর্স হিসেবে Chartboost যোগ করুন

বিজ্ঞাপনের সোর্স বিভাগের ওয়াটারফল কার্ডের মধ্যে, বিজ্ঞাপনের সোর্স যোগ করুন বিকল্প বেছে নিন।

Chartboost বেছে নিন এবং অপ্টিমাইজ করুন সুইচ চালু করুন। Chartboost-এর জন্য বিজ্ঞাপন সোর্স অপ্টিমাইজেশন সেট-আপ করতে, আগের বিভাগে পাওয়া ব্যবহারকারীর আইডি এবং ব্যবহারকারীর স্বাক্ষর লিখুন। তারপর Chartboost-এর জন্য eCPM ভ্যালু লিখুন এবং চালিয়ে যান বিকল্পে ক্লিক করুন।

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

এরপর, আগের বিভাগে পাওয়া অ্যাপ আইডি, অ্যাপ সিগনেচার এবং বিজ্ঞাপন দেখানোর লোকেশন লিখুন। তারপর হয়ে গেছে বিকল্পে ক্লিক করুন।

Chartboost বিজ্ঞাপনের লোকেশন (নাম দেওয়া লোকেশন) হল আপনার অ্যাপের কোনও জায়গার সহজ নাম যেখানে আপনি বিজ্ঞাপন দেখাতে চান। AdMob সেটিংসে উল্লেখ করা লোকেশনে অনুরোধ পাঠায়। অনুরোধ পাঠানো হয়ে গেলে, Chartboost রিপোর্টিংয়ের উদ্দেশ্যে তার প্ল্যাটফর্মে লোকেশন যোগ করে। এছাড়াও, ব্যবহারকারীরা তাদের গেমে কল করার আগে সরাসরি Chartboost প্ল্যাটফর্মে নতুন বিজ্ঞাপন দেখানোর লোকেশন তৈরি করতে পারবেন।

Chartboost UI-তে, উন্নত সেটিংস বিকল্পে ক্লিক করে প্রাথমিক সেটিংস পৃষ্ঠায় আপনার বিজ্ঞাপন দেখানোর লোকেশন প্রকাশ করা যেতে পারে। আরও তথ্যের জন্য Chartboost-এর [Named Locations](//docs.chartboost.com/en/monetization/publishing/ad-locations/) গাইড দেখুন।
সবশেষে, বিজ্ঞাপন সোর্স হিসেবে Chartboost যোগ করতে হয়ে গেছে বিকল্পে ক্লিক করুন এবং তারপরে সেভ করুন বিকল্পে ক্লিক করুন।

মনে রাখবেন: কোনও মধ্যস্থতা নেটওয়ার্কের জন্য eCPM সঠিকভাবে গণনা করতে, বিজ্ঞাপন সোর্স অপ্টিমাইজেশনের পর্যাপ্ত ডেটা সংগ্রহ করতে কয়েক দিন সময় লাগে। ইতিমধ্যে, বিজ্ঞাপন সোর্স অপ্টিমাইজেশনের স্ট্যাটাস হল PENDING, তাই আপনাকে নেটওয়ার্কের জন্য ম্যানুয়ালি eCPM ভ্যালু সেট করতে হবে। eCPM গণনা করা হয়ে গেলে, বিজ্ঞাপন সোর্স অটোমেটিক আপনার হয়ে eCPM আপডেট করা শুরু করে দেয়।

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

গুরুত্বপূর্ণ: ইউরোপীয় ইউনিয়নের সম্মতি ও জিডিপিআর, মার্কিন যুক্তরাষ্ট্রের রাজ্য রেগুলেশন এবং ব্যবহারকারীর মেসেজিং প্ল্যাটফর্মের জন্য কনফিগারেশন সম্পূর্ণ করতে আপনার কাছে অ্যাকাউন্ট ম্যানেজমেন্ট সংক্রান্ত অনুমতি আছে কিনা তা যাচাই করুন। বিস্তারিত জানতে আপনার অ্যাকাউন্টে ব্যবহারকারীর অ্যাক্সেস ম্যানেজ করুন দেখুন।

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

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

Android Studio ইন্টিগ্রেশন (সাজেস্ট করা হয়েছে)

আপনার প্রোজেক্ট-লেভেল settings.gradle.kts ফাইলে, নিম্নলিখিত রিপোজিটরি যোগ করুন:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

আপনার অ্যাপ-লেভেল গ্রেডেল ফাইলে, নিম্নলিখিত ইমপ্লিমেন্টেশন ডিপেন্ডেন্সি যোগ করুন:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:chartboost:9.14.1.0")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:chartboost:9.14.1.0'
}

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

Maven Central থেকে Chartboost SDK-এর লেটেস্ট ভার্সনের .aar ফাইল ডাউনলোড করুন এবং আপনার প্রোজেক্টে যোগ করুন।
Google-এর Maven রিপোজিটরিতে Chartboost অ্যাডাপ্টার আর্টিফ্যাক্ট নেভিগেট করুন। লেটেস্ট ভার্সন বেছে নিন, Chartboost অ্যাডাপ্টারের .aar ফাইল ডাউনলোড করুন এবং আপনার প্রোজেক্টে যোগ করুন।

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

EU কনসেন্ট ও জিডিপিআর (GDPR)

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

Chartboost Android অ্যাডাপ্টার ভার্সন 9.13.0.0 এবং তার পরবর্তী ভার্সন অটোমেটিক Chartboost SDK-তে UMP SDK এবং সম্মতি ম্যানেজমেন্ট প্ল্যাটফর্মের মাধ্যমে সেট করা GDPR সম্মতি ফরওয়ার্ড করে যা Google-এর অতিরিক্ত সম্মতি স্পেসিফিকেশনকে সাপোর্ট করে। আরও তথ্যের জন্য, SDK গোপনীয়তা পদ্ধতি দেখুন।

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

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

SDK ভার্সন 8.1.0-এ, Chartboost addDataUseConsent() পদ্ধতি যোগ করেছে। নিম্নলিখিত স্যাম্পেল কোড ডেটা ব্যবহারের সম্মতি OPT_IN_SALE-এ সেট করে। আপনি এই পদ্ধতি কল করার সিদ্ধান্ত নিলে, Google Mobile Ads SDK (Legacy)-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার জন্য সাজেস্ট করা হয়।

Java

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

আরও বিবরণ এবং প্রতিটি পদ্ধতিতে প্রদান করা যেতে পারে এমন ভ্যালুর জন্য Chartboost-এর CCPA নিবন্ধ এবং তাদের Android গোপনীয়তা পদ্ধতি দেখুন।

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

অ্যাক্টিভিটি কনফিগারেশন পরিবর্তন আপডেট করুন

AndroidManifest.xml ফাইলের প্রতিটি অ্যাক্টিভিটিতে নিম্নলিখিত অ্যাট্রিবিউট যোগ করুন যা Chartboost বিজ্ঞাপন দেখায় এবং বিভিন্ন ওরিয়েন্টেশন সাপোর্ট করে:

android:configChanges="keyboardHidden|orientation|screenSize"

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

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

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

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

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

ঐচ্ছিক ধাপ

অনুমতি

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

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

ত্রুটি কোড

অ্যাডাপ্টার Chartboost থেকে বিজ্ঞাপন পেতে না পারলে, আপনি ResponseInfo.getAdapterResponses() ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন, যা নিম্নলিখিত ক্লাসের অধীনে রয়েছে:

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

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

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

Chartboost Android মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ