AdMob মেডিয়েশনের সাথে Chartboost ইন্টিগ্রেট করা

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

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

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

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

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

পূর্বশর্ত

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

• লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
• React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
• Android-এ ডিপ্লয় করতে
  • Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
• iOS-এ ডিপ্লয় করতে
  • iOS ডেপ্লয়মেন্ট টার্গেট 13.0 বা তার পরের যেকোনও ভার্সন।
• Google Mobile Ads SDK for React Native-এর সাথে কনফিগার করা একটি কার্যকরী React Native প্রোজেক্ট। আরও বিবরণের জন্য Google Mobile Ads SDK for React Native সেট-আপ করুন দেখুন।
  • gma-sdk-react-native ফোল্ডার থেকে adapters ফোল্ডার ডাউনলোড ও এক্সট্র্যাক্ট করেছেন কিনা তা নিশ্চিত করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, Google Mobile Ads SDK for React Native ইনস্টল করুন বিকল্পে গিয়ে এক, দুই ও তিন নম্বর ধাপ অনুসরণ করুন।
• AdMob মেডিয়েশন সেট-আপ করুন।

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

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

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

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

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

মনে রাখবেন: আপনি আগে দেখানো অ্যাপ ম্যানেজমেন্ট ট্যাবে গিয়ে এবং আপনার অ্যাপ বেছে নিয়ে অ্যাপের ড্যাশবোর্ডে যেতে পারবেন।

Android

iOS

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

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

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

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

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

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

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

Android

iOS

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

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

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

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

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

Android

নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।

iOS

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

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

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

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

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

মনে রাখবেন: মানানসই Chartboost এবং Google Mobile Ads SDK for React Native ভার্সন ইন্টিগ্রেট করতে না পারলে, বিল্ড সংক্রান্ত সমস্যা হতে পারে।

আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, Chartboost-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি gma-sdk-react-native/adapters/chartboost/ ডিরেক্টরি থেকে আপনার প্রোজেক্টের local_packages/ ডিরেক্টরিতে কপি করুন। আপনার কাছে adapters ফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/chartboost/gma-mediation-chartboost-0.1.0.tgz local_packages/
   

   EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।

2. আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:

   npm

   npm install ./local_packages/gma-mediation-chartboost-0.1.0.tgz
   

   তন্তু

   yarn add ./local_packages/gma-mediation-chartboost-0.1.0.tgz
   

3. আপনি Android-এর জন্য তৈরি করলে, আপনার প্রোজেক্টের android ডিরেক্টরিতে build.gradle ফাইলে নিম্নলিখিত রিপোজিটরি যোগ করুন:

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

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

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

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

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

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

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

নিম্নলিখিত স্যাম্পেল কোড ডেটা ব্যবহারের সম্মতি OptInSale-এ সেট করে। আপনি যদি এই পদ্ধতি কল করার সিদ্ধান্ত নেন, তাহলে সাজেস্ট করা হচ্ছে যে Google Mobile Ads SDK for React Native ব্যবহার করে বিজ্ঞাপনের অনুরোধ করার আগে আপনি এটি করুন।

import {
  ChartboostCCPAConsent,
  ChartboostMediation,
} from '@google/gma-mediation-chartboost';
// ...

ChartboostMediation.addCCPADataUseConsent(ChartboostCCPAConsent.OPT_IN_SALE);

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

Android

Chartboost ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।

iOS

SKAdNetwork ইন্টিগ্রেশন

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

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

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

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

গুরুত্বপূর্ণ: আপনার অ্যাপ রিলিজ করার আগে AdMob ও Chartboost-এর জন্য টেস্ট মোড বন্ধ করুন।

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

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

ঐচ্ছিক ধাপ

Android

অনুমতি

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

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

iOS

iOS ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও ধাপের প্রয়োজন নেই।

ত্রুটি কোড

Chartboost থেকে অ্যাডাপ্টার বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা চেক করতে পারবেন:

Android

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

iOS

GADMAdapterChartboost
GADMediationAdapterChartboost

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

Android

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

iOS

সমস্যার কোড	কারণ
১০১	AdMob UI-তে কনফিগার করা Chartboost সার্ভার প্যারামিটার নেই/ভুল।
102	Chartboost SDK-এর ক্ষেত্রে ইনিশিয়ালাইজেশন সংক্রান্ত সমস্যা দেখা দিয়েছে।
103	শো করার সময় Chartboost বিজ্ঞাপন ক্যাশে করা হয়নি।
104	অনুরোধ করা বিজ্ঞাপনের সাইজ Chartboost-এ কাজ করে এমন ব্যানারের সাইজের সাথে মেলে না।
১০৫	ডিভাইসের OS ভার্সন Chartboost SDK-এর ন্যূনতম OS ভার্সনের থেকে পুরনো।
200-299	Chartboost SDK ক্যাশে সংক্রান্ত সমস্যা। আরও বিবরণের জন্য কোড দেখুন।
300-399	Chartboost SDK-তে সমস্যা দেখাচ্ছে। আরও বিবরণের জন্য কোড দেখুন।
400-499	Chartboost SDK ক্লিক সংক্রান্ত সমস্যা। আরও বিবরণের জন্য কোড দেখুন।

ভার্সন 0.1.0

• প্রাথমিক রিলিজ।

• Chartboost Android অ্যাডাপ্টার ভার্সন 9.12.0.0 কাজ করে।
• Chartboost iOS অ্যাডাপ্টার ভার্সন 9.12.0.1 কাজ করে।