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

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

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

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

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

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

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

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

পূর্বশর্ত

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

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

লেটেস্ট Google Mobile Ads SDK (Legacy) ভার্সন।
মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

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

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

অ্যাপ সেটিংস

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 থেকে অ্যাপ ম্যানেজমেন্ট ট্যাবে গিয়ে, তালিকা থেকে আপনার অ্যাপ বেছে নিয়ে এবং অ্যাপ সেটিংস এডিট করুন বিকল্পে ক্লিক করে আপনি অ্যাপে টেস্ট মোড চালু করতে পারবেন।

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

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

Chartboost টেস্ট মোড

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

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

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

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

আপনার Ad Manager অ্যাকাউন্টে সাইন-ইন করুন।

ডেলিভারি > ইয়েল্ড গ্রুপ বিকল্পে গিয়ে নতুন ইয়েল্ড গ্রুপ বোতামে ক্লিক করুন।

আপনার ইল্ড গ্রুপের জন্য একটি অনন্য নাম লিখুন, স্ট্যাটাস অ্যাক্টিভ হিসেবে সেট করুন, আপনার বিজ্ঞাপনের ফর্ম্যাট বেছে নিন এবং ইনভেনটরির ধরন মোবাইল অ্যাপ হিসেবে সেট করুন। টার্গেট করা > ইনভেনটরি বিভাগের অধীনে, ইনভেনটরি এবং মোবাইল অ্যাপ্লিকেশন-এর অধীনে বিজ্ঞাপন ইউনিট বেছে নিন, যেখানে আপনি মধ্যস্থতা যোগ করতে চান।

এরপর, ইল্ড পার্টনার যোগ করুন বোতামে ক্লিক করুন।

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

বিজ্ঞাপন নেটওয়ার্ক হিসেবে Chartboost বেছে নিন, একটি অনন্য নাম লিখুন এবং মেডিয়েশন চালু করুন।

অটোমেটিক ডেটা সংগ্রহ বিকল্প চালু করুন এবং আগের বিভাগে পাওয়া ব্যবহারকারীর আইডি ও ব্যবহারকারীর স্বাক্ষর লিখুন।

ইল্ড পার্টনার বেছে নেওয়ার পরে, ইন্টিগ্রেশনের ধরন হিসেবে মোবাইল SDK মধ্যস্থতা, প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে অ্যাক্টিভ বিকল্প বেছে নিন। আগের বিভাগ থেকে পাওয়া অ্যাপ আইডি, অ্যাপের স্বাক্ষর এবং বিজ্ঞাপন দেখানোর লোকেশন লিখুন। তারপর, ডিফল্ট CPM ভ্যালু লিখুন।

Chartboost বিজ্ঞাপনের লোকেশন (নামযুক্ত লোকেশন) হল আপনার অ্যাপের এমন একটি জায়গার নাম যেখানে আপনি বিজ্ঞাপন দেখাতে চান। Ad Manager সেটিংসে উল্লেখ করা লোকেশনে অনুরোধ পাঠায়। অনুরোধ পাঠানো হয়ে গেলে, Chartboost রিপোর্টিংয়ের উদ্দেশ্যে তার UI-তে লোকেশন যোগ করবে।

Chartboost UI-তে, উন্নত সেটিংস বিকল্পে ক্লিক করে প্রাথমিক সেটিংস পৃষ্ঠায় আপনার বিজ্ঞাপন দেখানোর লোকেশন প্রকাশ করা যেতে পারে। আরও তথ্যের জন্য Chartboost নামাঙ্কিত লোকেশন গাইড দেখুন।

হয়ে গেলে, পৃষ্ঠার একদম নিচে সেভ করুন বিকল্পে ক্লিক করুন।

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

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

Ad Manager 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"

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

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

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