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

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

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

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

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

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

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

পূর্বশর্ত

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

Android API লেভেল 24 বা এর পরের যেকোনও ভার্সন।

GMA Next-Gen SDK-এর লেটেস্ট ভার্সন।
মধ্যস্থতা সেট-আপ করুন।

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

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

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

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

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

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

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

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

অ্যাপ সেটিংস

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

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

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

Chartboost API Explorer

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

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

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

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

Yield পার্টনার বেছে নেওয়া হয়ে গেলে, ইন্টিগ্রেশন ধরন হিসেবে মোবাইল 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:chartboost:9.14.1.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:chartboost:9.14.1.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

EU সম্মতি ও GDPR

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

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

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

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

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

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 গোপনীয়তা পদ্ধতি দেখুন।

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

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

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

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.getAdSourceResponses() নিচের ক্লাস থেকে চেক করতে পারেন:

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 ইন্টারস্টিশিয়াল বা পুরস্কার প্রদানকারী বিজ্ঞাপন দেখানোর জন্য রেডি নেই।