গুগল অ্যাডভারটাইজিং অ্যান্ড মেজারমেন্ট কমিউনিটি সার্ভারের #gma-next-gen-sdk ডিসকর্ড চ্যানেলে GMA নেক্সট-জেন SDK সম্পর্কে আপনার মতামত শেয়ার করুন।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা)

অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

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

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

চার্টবুস্টের মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

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

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

অ্যান্ড্রয়েড এপিআই লেভেল ২৪ বা তার বেশি

সর্বশেষ GMA Next-Gen SDK
মধ্যস্থতা শুরু করার নির্দেশিকাটি সম্পূর্ণ করুন।

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

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

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

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

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

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

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

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

অ্যাপ সেটিংস

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ধাপ ২: অ্যাড ম্যানেজার UI-তে চার্টবুস্ট ডিমান্ড সেট আপ করুন।

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

আপনার অ্যাড ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন।

ডেলিভারি > ইল্ড গ্রুপস- এ যান এবং নিউ ইল্ড গ্রুপ বোতামে ক্লিক করুন।

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

এরপর, 'Add yield partner' বাটনটিতে ক্লিক করুন।

আপনার যদি Chartboost-এর জন্য আগে থেকেই কোনো Yield partner থাকে, তাহলে আপনি তাকে নির্বাচন করতে পারেন। অন্যথায়, ‘Create a new yield partner’ নির্বাচন করুন।

অ্যাড নেটওয়ার্ক হিসেবে চার্টবুস্ট (Chartboost) নির্বাচন করুন, একটি অনন্য নাম লিখুন এবং মিডিয়েশন (Mediation) সক্রিয় করুন।

স্বয়ংক্রিয় তথ্য সংগ্রহ চালু করুন এবং পূর্ববর্তী বিভাগে প্রাপ্ত ইউজার আইডি ও ব্যবহারকারীর স্বাক্ষর প্রবেশ করান।

Yield পার্টনার নির্বাচন করা হয়ে গেলে, ইন্টিগ্রেশন টাইপ হিসেবে Mobile SDK Mediation , প্ল্যাটফর্ম হিসেবে Android এবং স্ট্যাটাস হিসেবে Active বেছে নিন। পূর্ববর্তী বিভাগে প্রাপ্ত App ID , App Signature এবং Ad Location লিখুন। তারপর, একটি ডিফল্ট CPM ভ্যালু দিন।

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

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

কাজ শেষ হলে পৃষ্ঠার নীচে থাকা সেভ বাটনে ক্লিক করুন।

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

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

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

অ্যান্ড্রয়েড স্টুডিও ইন্টিগ্রেশন (প্রস্তাবিত)

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

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

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

কোটলিন

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:chartboost:9.11.1.1")
}

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

গ্রুভি

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:chartboost:9.11.1.1'
}

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 ফাইলটি ডাউনলোড করে আপনার প্রজেক্টে যুক্ত করুন।
গুগলের মেভেন রিপোজিটরিতে থাকা চার্টবুস্ট অ্যাডাপ্টার আর্টিফ্যাক্টস -এ যান। সর্বশেষ সংস্করণটি নির্বাচন করুন, চার্টবুস্ট অ্যাডাপ্টারের .aar ফাইলটি ডাউনলোড করুন এবং আপনার প্রজেক্টে যোগ করুন।

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

ইইউ সম্মতি এবং জিডিপিআর

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

SDK সংস্করণ 8.1.0-এ, Chartboost ` addDataUseConsent() মেথডটি যুক্ত করেছে। নিম্নলিখিত নমুনা কোডটি ডেটা ব্যবহারের সম্মতি NON_BEHAVIORAL হিসেবে সেট করে। আপনি যদি এই মেথডটি কল করতে চান, GMA Next-Gen SDK মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগেই তা করার পরামর্শ দেওয়া হচ্ছে।

জাভা

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

কোটলিন

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

আরও বিস্তারিত তথ্যের জন্য এবং প্রতিটি পদ্ধতিতে কী কী মান প্রদান করা যেতে পারে তা জানতে Chartboost-এর GDPR আর্টিকেল এবং তাদের Android Privacy Methods দেখুন।

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

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

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

জাভা

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

কোটলিন

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

আরও বিস্তারিত তথ্যের জন্য এবং প্রতিটি পদ্ধতিতে কী কী মান প্রদান করা যেতে পারে তা জানতে Chartboost-এর CCPA আর্টিকেল এবং তাদের Android Privacy Methods দেখুন।

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

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

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

android:configChanges="keyboardHidden|orientation|screenSize"

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

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

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

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

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

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

অনুমতি

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

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

ত্রুটি কোড

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

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

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

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