এই নির্দেশিকা থেকে আপনি জানতে পারবেন কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করে মধ্যস্থতা-এর মাধ্যমে DT Exchange থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে হয়, যার মধ্যে ওয়াটারফল ইন্টিগ্রেশনও কভার করা হয়। এটি কভার করে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে DT Exchange যোগ করতে হয় এবং কীভাবে DT Exchange SDK এবং অ্যাডাপ্টারকে React Native অ্যাপে ইন্টিগ্রেট করতে হয়।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
DT Exchange-এর জন্য React Native মিডিয়েশন অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা আছে:
| ইন্টিগ্রেশন | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| ফর্ম্যাট | |
| অ্যাপ খোলা | |
| ব্যানার | |
| স্থান | |
| পুরস্কার জিতেছেন | |
| পুরস্কৃত ইন্টারস্টিশিয়াল | |
| নেটিভ | |
পূর্বশর্ত
চালিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলি যাচাই করুন:
- লেটেস্ট Google Mobile Ads SDK for React Native ভার্সন।
- React Native ফ্রেমওয়ার্ক ভার্সন 0.85.0 বা তার পরবর্তী যেকোনও ভার্সন।
- Android-এ ডিপ্লয় করতে
- Android API লেভেল ২৪ বা তার পরের যেকোনও ভার্সন।
- iOS-এ ডিপ্লয় করতে
- iOS ডেপ্লয়মেন্ট টার্গেট 15.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 মেডিয়েশন সেট-আপ করুন।
ধাপ ১: DT Exchange UI-তে কনফিগারেশন সেট-আপ করা
নতুন অ্যাপ ও বিজ্ঞাপনের প্লেসমেন্ট যোগ করুন
DT Exchange Console-এ সাইন-আপ বা লগ-ইন করুন।
অ্যাপ যোগ করুন বিকল্পে ক্লিক করুন।
আপনার প্ল্যাটফর্ম ও প্লেসমেন্ট বেছে নিন, ফর্মের বাকি অংশ পূরণ করুন এবং তারপরে অ্যাপ তৈরি করুন বিকল্পে ক্লিক করুন।
Android
iOS
আপনার প্লেসমেন্টের নাম লিখুন এবং ধরন বেছে নিন। তারপর, প্লেসমেন্ট সেভ করুন বিকল্পে ক্লিক করুন।
অ্যাপ আইডি ও প্লেসমেন্ট আইডি
বাঁদিকের নেভিগেশন বার খুলতে সেটির উপর মাউস নিয়ে যান, তারপর অ্যাপ ম্যানেজমেন্ট বিকল্পে ক্লিক করুন।
অ্যাপ ম্যানেজমেন্ট পৃষ্ঠায়, আপনার অ্যাপের পাশে থাকা অ্যাপ আইডি নোট করুন।
আপনার অ্যাপ বেছে নিন এবং প্লেসমেন্ট ট্যাবে নেভিগেট করুন। প্লেসমেন্ট আইডি নোট করে নিন।
প্রকাশক আইডি, কনজিউমার কী এবং কনজিউমার সিক্রেট
বাঁদিকের মেনু থেকে আপনার ইউজারনেমে ক্লিক করে ব্যবহারকারীর প্রোফাইল বিকল্প বেছে নিন।
প্রকাশক আইডি, কনজিউমার কী এবং কনজিউমার সিক্রেট নোট করে রাখুন কারণ পরবর্তী ধাপে এগুলি প্রয়োজন হবে।
আপনার app-ads.txt আপডেট করুন
অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
আপনার অ্যাপের জন্য app-ads.txt ফাইল সেট-আপ করুন।
DT Exchange-এর জন্য app-ads.txt প্রয়োগ করতে,
আপনার app-ads.txt ফাইলে DT যোগ করুন।
ধাপ ২: AdMob UI-তে DT Exchange ডিমান্ড সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারদের তালিকায় DT Exchange যোগ করুন
AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় DT Exchange (Fyber Monetization) যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস -এ দেওয়া ধাপগুলি অনুসরণ করুন।
ধাপ ৩: DT Exchange SDK ও অ্যাডাপ্টার ইমপোর্ট করুন
আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, DT Exchange-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি
gma-sdk-react-native/adapters/dt-exchange/ডিরেক্টরি থেকে আপনার প্রোজেক্টেরlocal_packages/ডিরেক্টরিতে কপি করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/dt-exchange/gma-mediation-dtexchange-0.1.0.tgz local_packages/EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।
আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:
npm
npm install ./local_packages/gma-mediation-dtexchange-0.1.0.tgzতন্তু
yarn add ./local_packages/gma-mediation-dtexchange-0.1.0.tgz
ধাপ ৪: DT Exchange SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
DT Exchange React Native অ্যাডাপ্টার ভার্সন 0.1.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে DT Exchange SDK-তে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, Android এবং iOS GDPR ডকুমেন্টেশন দেখুন।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।
নিম্নলিখিত স্যাম্পেল কোড থেকে বোঝা যায় যে কীভাবে সম্মতি সংক্রান্ত তথ্য ম্যানুয়ালি DT Exchange অ্যাডাপ্টারে পাস করতে হয়:
import { DTExchangeMediation } from '@google/gma-mediation-dtexchange';
// ...
DTExchangeMediation.setUSPrivacyString('myUSPrivacyString');
// You can also clear CCPA consent information using the following method:
DTExchangeMediation.clearUSPrivacyString();
আরও তথ্য এবং পদ্ধতিতে প্রদান করা যেতে পারে এমন ভ্যালুর জন্য DT Exchange-এর CCPA ওপেন সোর্স নিবন্ধটি দেখুন।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
Android
DT Exchange ইন্টিগ্রেশনের জন্য অতিরিক্ত কোনও কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, DT Exchange-এর
ডকুমেন্টেশন
অনুসরণ করুন।
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করতে ভুলবেন না।
টেস্ট বিজ্ঞাপন যাচাই করা
আপনি DT Exchange থেকে টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, DT Exchange (Bidding) এবং DT Exchange (Waterfall) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইনস্পেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ত্রুটি কোড
অ্যাডাপ্টার DT Exchange থেকে বিজ্ঞাপন পেতে না পারলে, প্রকাশকরা
নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে
বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত সমস্যা
চেক করতে পারবেন:
Android
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
কোনও বিজ্ঞাপন লোড না হলে DT Exchange অ্যাডাপ্টারের মাধ্যমে দেখানো কোড ও মেসেজ এখানে দেওয়া হল:
Android
| সমস্যার কোড | কারণ |
|---|---|
| ১০১ | AdMob UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার নেই/ভুল। |
| 103 | অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না। |
| ১০৫ | DT SDK একটি বিজ্ঞাপন লোড করেছে কিন্তু একটি অপ্রত্যাশিত কন্ট্রোলার রিটার্ন করেছে। |
| 106 | বিজ্ঞাপন দেখানোর জন্য রেডি নয়। |
| 107 | প্রসঙ্গটি কোনও অ্যাক্টিভিটি ইনস্ট্যান্স নয়। |
| 108 | বিজ্ঞাপন দেখানো যায়নি। |
| 200-399 | DT SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন। |
iOS
| সমস্যার কোড | কারণ |
|---|---|
| 0-10 | DT SDK-তে কোনও সমস্যা হয়েছে। আরও তথ্যের জন্য ডকুমেন্টেশন দেখুন। |
| ১০১ | AdMob UI-তে কনফিগার করা DT Exchange সার্ভার প্যারামিটার নেই/ভুল। |
| 102 | অনুরোধ করা বিজ্ঞাপনের সাইজ DT Exchange-এ কাজ করে এমন ব্যানারের সাইজের সাথে মিলছে না। |
| 103 | বিজ্ঞাপন দেখানো যায়নি কারণ বিজ্ঞাপনের অবজেক্ট আগেই ব্যবহার করা হয়েছে। |
| 104 | বিজ্ঞাপন রেডি না থাকার কারণে DT Exchange বিজ্ঞাপন দেখানো যায়নি। |
| ১০৫ | DT SDK-তে ইনিশিয়ালাইজেশন সংক্রান্ত সমস্যা হয়েছে। |
ভার্সন 0.1.0
- প্রাথমিক রিলিজ।
- DT Exchange Android অ্যাডাপ্টার ভার্সন 8.4.7.1-এ কাজ করে।
- DT Exchange iOS অ্যাডাপ্টার ভার্সন 8.4.10.0-এ কাজ করে।
- Google Mobile Ads React Native প্লাগ-ইন ভার্সন 0.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।