এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে বিডিং ও ওয়াটারফল ইন্টিগ্রেশন কভার করে, মধ্যস্থতা ব্যবহার করে Unity Ads থেকে বিজ্ঞাপন লোড ও ডিসপ্লে করতে কীভাবে Google Mobile Ads SDK for React Native ব্যবহার করবেন। এটি বিজ্ঞাপন ইউনিটের মিডিয়েশন কনফিগারেশনে কীভাবে Unity Ads যোগ করতে হয় এবং React Native অ্যাপে কীভাবে Unity Ads SDK ও অ্যাডাপ্টার ইন্টিগ্রেট করতে হয় তা কভার করে।
যেসব ইন্টিগ্রেশন ও বিজ্ঞাপনের ফর্ম্যাট ব্যবহার করা যায়
Unity Ads-এর জন্য 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 মেডিয়েশন সেট-আপ করুন।
ধাপ ১: Unity Ads UI-তে কনফিগারেশন সেট-আপ করা
Unity Ads-এ সাইন-আপ অথবা লগ-ইন করুন।
প্রোজেক্ট তৈরি করুন
Unity Ads ড্যাশবোর্ডে, প্রোজেক্ট বিকল্পে নেভিগেট করুন এবং নতুন বিকল্পে ক্লিক করুন।
ফর্ম পূরণ করুন এবং আপনার প্রোজেক্ট যোগ করতে তৈরি করুন বিকল্পে ক্লিক করুন।
নেভিগেট করে Unity Ads মনিটাইজেশন বিকল্পে যান, তারপর শুরু করুন বিকল্পে ক্লিক করুন।
নতুন প্রোজেক্ট মডেলে, আমি মধ্যস্থতা ব্যবহার করব এবং মধ্যস্থতা পার্টনার হিসেবে Google Admob বেছে নিন, তারপর পরবর্তী বিকল্পে ক্লিক করুন।
বিজ্ঞাপন সেটিংসের জন্য বিকল্প বেছে নিন, তারপর পরবর্তী বিকল্পে ক্লিক করুন।
আপনার প্লেসমেন্ট সেট-আপ বেছে নিন, তারপর পরবর্তী বিকল্পে ক্লিক করুন।
বিডিং
জলপ্রপাত
ফর্ম পূরণ করে প্রোজেক্ট যোগ করুন বিকল্পে ক্লিক করুন।
গেম আইডি নোট করে রাখুন।
বিজ্ঞাপন ইউনিট ও প্লেসমেন্ট তৈরি করা
Unity Ads Monetization > প্লেসমেন্ট বিকল্পে গিয়ে আপনার প্রোজেক্ট বেছে নিন এবং বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।
বিজ্ঞাপন ইউনিটের নাম লিখুন, তারপর আপনার প্ল্যাটফর্ম এবং বিজ্ঞাপনের ফর্ম্যাট বেছে নিন।
Android
iOS
বিডিং
সেট-আপ-এর জন্য বিডিং বেছে নিন। প্লেসমেন্ট বিকল্পের অধীনে, প্লেসমেন্টের নাম লিখুন।
প্লেসমেন্ট আইডি নোট করে নিন।
জলপ্রপাত
সেট-আপ-এর জন্য ওয়াটারফল বেছে নিন। প্লেসমেন্ট বিকল্পের অধীনে, প্লেসমেন্টের নাম, জিও ট্যাগিং এবং টার্গেট লিখুন।
প্লেসমেন্ট আইডি নোট করে নিন।
সবশেষে, আপনার বিজ্ঞাপন ইউনিট ও প্লেসমেন্ট সেভ করতে বিজ্ঞাপন ইউনিট যোগ করুন বিকল্পে ক্লিক করুন।
Unity Ads রিপোর্টিং API key খুঁজে বের করা
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপটি প্রয়োজনীয় নয়।
জলপ্রপাত
Unity Ads মনিটাইজেশন > API ম্যানেজমেন্ট বিকল্পে গিয়ে মনিটাইজেশন স্ট্যাটাস API অ্যাক্সেস বিকল্পে API কী নোট করে নিন।
তারপর, Unity Ads মনিটাইজেশন > প্রতিষ্ঠান সেটিংস বিকল্পে নেভিগেট করুন এবং প্রতিষ্ঠান কোর আইডি নোট করুন।
আপনার app-ads.txt আপডেট করুন
অ্যাপের জন্য অনুমোদিত বিক্রেতা বা app-ads.txt হল IAB Tech Lab-এর একটি উদ্যোগ যা আপনার অ্যাপের বিজ্ঞাপন ইনভেনটরি শুধুমাত্র আপনার অনুমোদিত চ্যানেলের মাধ্যমে বিক্রি করা নিশ্চিত করতে সাহায্য করে। বিজ্ঞাপন থেকে উপার্জনে
উল্লেখযোগ্য ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে।
আপনি আগে থেকে এটি না করে থাকলে,
আপনার অ্যাপের জন্য app-ads.txt ফাইল সেট-আপ করুন।
Unity Ads-এর জন্য app-ads.txt প্রয়োগ করতে,
প্রথমবার app-ads.txt সেট-আপ করা দেখুন।
টেস্ট মোড চালু করুন
Unity Ads ড্যাশবোর্ড থেকে টেস্ট মোড চালু করা যেতে পারে। Unity Ads মনিটাইজেশন > টেস্টিং বিকল্পে যান।
প্রতিটি প্ল্যাটফর্মের এডিট বোতামে ক্লিক করে, ক্লায়েন্ট টেস্ট মোড ওভাররাইড করুন বিকল্প চালু করে এবং সব ডিভাইসের জন্য টেস্ট মোড চালু করতে বাধ্য করুন (অর্থাৎ টেস্ট বিজ্ঞাপন ব্যবহার করুন) বিকল্প বেছে নিয়ে আপনি অ্যাপের জন্য টেস্ট মোড চালু করতে বাধ্য করতে পারবেন।
Android
iOS
অন্যথায়, আপনি টেস্ট ডিভাইস যোগ করুন বিকল্পে ক্লিক করে নির্দিষ্ট ডিভাইসের জন্য টেস্ট মোড চালু করতে পারেন।
আপনার টেস্ট ডিভাইসের বিবরণ লিখুন, তারপর সেভ করুন বিকল্পে ক্লিক করুন।
ধাপ ২: AdMob UI-তে Unity Ads-এর চাহিদা সেট-আপ করা
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
Android
নির্দেশাবলীর জন্য, Android-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS-এর জন্য নির্দেশিকার ২ নম্বর ধাপ দেখুন।
জিডিপিআর (GDPR) এবং মার্কিন যুক্তরাষ্ট্রের বিভিন্ন রাজ্যের রেগুলেশন সংক্রান্ত বিজ্ঞাপন পার্টনারের তালিকায় Unity Ads যোগ করা
AdMob UI-তে ইউরোপিয়ান ও মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন বিজ্ঞাপন পার্টনারের তালিকায় Unity Ads যোগ করতে, ইউরোপিয়ান রেগুলেশন সেটিংস এবং মার্কিন যুক্তরাষ্ট্রের স্টেট রেগুলেশন সেটিংস বিকল্পে দেওয়া ধাপগুলি অনুসরণ করুন।
ধাপ ৩: Unity Ads SDK ও অ্যাডাপ্টার ইম্পোর্ট করা
আপনার প্রোজেক্টের রুট ডিরেক্টরিতে, Unity Ads-এর জন্য Google Mobile Ads SDK for React Native মিডিয়েশন অ্যাডাপ্টার ইনস্টল করুন। নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
Google Mobile Ads SDK for React Native অ্যাডাপ্টার tar ফাইলটি
gma-sdk-react-native/adapters/unity/ডিরেক্টরি থেকে আপনার প্রোজেক্টেরlocal_packages/ডিরেক্টরিতে কপি করুন। আপনার কাছেadaptersফোল্ডার না থাকলে, পূর্বশর্ত দেখুন।mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/unity/gma-mediation-unity-0.1.0.tgz local_packages/EXTRACT_DIR-এর জায়গায় সেই ডিরেক্টরির পাথ লিখুন যেখানে আপনি আর্কাইভ এক্সট্র্যাক্ট করেছেন।
আপনার পছন্দের প্যাকেজ ম্যানেজার ব্যবহার করে অ্যাডাপ্টার প্যাকেজ ইনস্টল করুন:
npm
npm install ./local_packages/gma-mediation-unity-0.1.0.tgzতন্তু
yarn add ./local_packages/gma-mediation-unity-0.1.0.tgz
ধাপ ৪: Unity Ads SDK-তে গোপনীয়তা সেটিংস প্রয়োগ করা
EU কনসেন্ট ও জিডিপিআর (GDPR)
Google-এর ইউরোপীয় ইউনিয়নের ব্যবহারকারী সম্মতি নীতি মেনে চলতে, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য ও সুইজারল্যান্ডের ব্যবহারকারীদের বিশেষ কিছু তথ্য জানাতে হবে। এছাড়াও, আইনত প্রয়োজনীয় হলে, কুকি বা অন্যান্য লোকাল স্টোরেজ ব্যবহার করা এবং সেই সাথে পছন্দমতো বিজ্ঞাপন দেখানোর ক্ষেত্রে ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহার করার জন্য ব্যবহারকারীর অনুমতি নিতে হবে। ইউরোপীয় ইউনিয়নের ই-প্রাইভেসি নির্দেশিকা এবং জেনারেল ডেটা প্রোটেকশন রেগুলেশন (GDPR) অনুযায়ী এই নীতি তৈরি করা হয়েছে। আপনার মিডিয়েশন চেনের প্রতিটি বিজ্ঞাপন সোর্সে সম্মতি প্রচার করা হয়েছে কিনা তা যাচাই করার দায়িত্ব আপনার।
Unity Ads React Native অ্যাডাপ্টার ভার্সন 0.1.0 এবং পরবর্তী ভার্সন, IAB-এর ট্রান্সপারেন্সি ও কনসেন্ট ফ্রেমওয়ার্কের (TCF) সাথে ইন্টিগ্রেট করা কনসেন্ট ম্যানেজমেন্ট প্ল্যাটফর্ম থেকে জিডিপিআর (GDPR) কনসেন্ট সিগন্যাল Unity Ads SDK-তে পাস করার সুবিধা প্রদান করে। আরও তথ্যের জন্য, TCF বা TCF নয় এমন সম্মতি কনফিগারেশন সেট-আপ করুন নিবন্ধটি দেখুন।
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের রাজ্য-ভিত্তিক গোপনীয়তা আইন অনুসারে ব্যবহারকারীকে তার "ব্যক্তিগত তথ্য" "বিক্রি" করার বিকল্প ছেড়ে বেরিয়ে আসার অধিকার দিতে হবে (আইনে যেভাবে এই শব্দগুলি সংজ্ঞায়িত আছে)। "বিক্রি করা" পার্টির হোমপেজে স্পষ্টভাবে দেখানো "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে বেরিয়ে আসার সুবিধা দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন মেনে চলা সংক্রান্ত নির্দেশিকা Google বিজ্ঞাপন পরিষেবার জন্য সীমাবদ্ধ ডেটা প্রসেসিং (RDP) চালু করার সুবিধা প্রদান করে, তবে Google আপনার মধ্যস্থতা চেনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিং প্রয়োগ করতে পারে না। তাই, আপনার মিডিয়েশন চেনে থাকা প্রতিটি বিজ্ঞাপন নেটওয়ার্ককে শনাক্ত করতে হবে, যারা ব্যক্তিগত তথ্য বিক্রির সাথে যুক্ত থাকতে পারে এবং সম্মতি নিশ্চিত করতে সেইসব নেটওয়ার্কের প্রতিটি থেকে পাওয়া নির্দেশিকা অনুসরণ করতে হবে।
Unity Ads-এর
জন্য Google মোবাইল বিজ্ঞাপন মিডিয়েশন প্লাগ-ইনে
UnityMediation.setCCPAConsent()
পদ্ধতি অন্তর্ভুক্ত আছে। নিম্নলিখিত স্যাম্পেল কোড থেকে জানা যায় যে কীভাবে Unity Ads SDK-তে
সম্মতি সংক্রান্ত তথ্য পাস করতে হয়। আপনি এই পদ্ধতি কল করার সিদ্ধান্ত নিলে,
Google Mobile Ads SDK for React Native-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে
এটি করার জন্য সাজেস্ট করা হয়।
import { UnityMediation } from '@google/gma-mediation-unity';
// ...
UnityMediation.setCCPAConsent(false);
বয়স সংক্রান্ত ট্রিটমেন্ট সেট করুন
Unity Ads মিডিয়েশন প্লাগ-ইন ভার্সন 0.1.0 এবং তার পরবর্তী ভার্সন বাচ্চাদের জন্য তৈরি কন্টেন্ট সংক্রান্ত সেটিং এবং সম্মতি দেওয়ার উপযুক্ত বয়সের চেয়ে কম বয়সের ব্যবহারকারী সংক্রান্ত সেটিং Unity Ads-এ ফরওয়ার্ড করে।
প্রতি ব্যবহারকারীর ভিত্তিতে এইসব সিগন্যাল প্রসেস করতে, Unity Ads-এর জন্য আপনাকে Unity Monetization ড্যাশবোর্ডে মিক্সড অডিয়েন্স ডেজিগনেশন চালু করতে হবে। আপনার প্রোজেক্টে মিশ্র দর্শক সংক্রান্ত ডেজিগনেশন চালু করার ব্যাপারে আরও তথ্য পেতে, গেম-লেভেল বয়স সংক্রান্ত ডেজিগনেশন সেট করা দেখুন।
ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন
Android
Unity Ads Android ইন্টিগ্রেশনের জন্য অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রোজেক্টের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে, Unity Ads-এর
ডকুমেন্টেশন
অনুসরণ করুন।
ধাপ ৬: আপনার ইমপ্লিমেন্টেশন পরীক্ষা করুন
টেস্ট বিজ্ঞাপন চালু করুন
AdMob-এর জন্য আপনার টেস্ট ডিভাইস রেজিস্টার করেছেন কিনা এবং Unity Ads UI-তে টেস্ট মোড চালু করেছেন কিনা তা ভাল করে দেখে নিন।
টেস্ট বিজ্ঞাপন যাচাই করা
Unity Ads থেকে আপনি টেস্ট বিজ্ঞাপন পাচ্ছেন কিনা তা যাচাই করতে, Unity Ads (বিডিং) এবং Unity Ads (ওয়াটারফল) বিজ্ঞাপন সোর্স ব্যবহার করে বিজ্ঞাপন ইন্সপেক্টরে সিঙ্গেল বিজ্ঞাপন সোর্স টেস্টিং চালু করুন।
ত্রুটি কোড
অ্যাডাপ্টার Unity Ads থেকে বিজ্ঞাপন পেতে ব্যর্থ হলে, প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে
ResponseInfo ব্যবহার করে
বিজ্ঞাপনের উত্তর থেকে অন্তর্নিহিত ত্রুটি
চেক করতে পারেন:
Android
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
কোনও বিজ্ঞাপন লোড না হলে UnityAds অ্যাডাপ্টার যেসব কোড ও মেসেজ দেখায় সেগুলি এখানে দেওয়া হল:
Android
| সমস্যার কোড | কারণ |
|---|---|
| 0-10 | UnityAds SDK-তে কোনও সমস্যা হয়েছে। আরও বিবরণের জন্য কোড দেখুন। |
| ১০১ | Admob UI-তে কনফিগার করা UnityAds সার্ভার প্যারামিটার নেই/ভুল। |
| 102 | UnityAds একটি প্লেসমেন্ট ফিরিয়ে দিয়েছে যার স্ট্যাটাস NO_FILL। |
| 103 | UnityAds একটি প্লেসমেন্ট ফিরিয়ে দিয়েছে যার স্ট্যাটাস বন্ধ করা আছে। |
| 104 | UnityAds একটি নাল কনটেক্সট সহ বিজ্ঞাপন দেখানোর চেষ্টা করেছে। |
| ১০৫ | Unity Ads থেকে বিজ্ঞাপন শুরু, লোড এবং/অথবা দেখানোর জন্য ব্যবহৃত প্রসঙ্গ কোনও অ্যাক্টিভিটি ইনস্ট্যান্স নয়। |
| 106 | UnityAds এমন একটি বিজ্ঞাপন দেখানোর চেষ্টা করেছে যা দেখানোর জন্য প্রস্তুত নয়। |
| 107 | ডিভাইসে UnityAds কাজ করে না। |
| 108 | UnityAds একবারে প্রতিটি প্লেসমেন্টে শুধু ১টি বিজ্ঞাপন লোড করতে পারে। |
| ১০৯ | UnityAds-এর স্ট্যাটাস সমস্যা সংক্রান্ত স্ট্যাটাস হিসেবে শেষ হয়েছে। |
| 110 | অনুরোধ করা বিজ্ঞাপনের সাইজ UnityAds-এর সাথে মানানসই ব্যানার সাইজের সাথে মিলছে না। |
| 111 | UnityAds-এ ইনিশিয়ালাইজেশন সংক্রান্ত সমস্যা হয়েছে। |
| 112 | Unity Ads একটি নাল বা খালি বিডিং টোকেন রিটার্ন করেছে। |
| 200-204 | UnityAds Banner a specific error. আরও বিবরণের জন্য কোড দেখুন। |
iOS
| 0-9 | UnityAds SDK-তে কোনও সমস্যা হয়েছে। আরও তথ্যের জন্য Unity-এর ডকুমেন্টেশন দেখুন। |
| ১০১ | AdMob UI-তে কনফিগার করা UnityAds সার্ভার প্যারামিটার নেই/ভুল। |
| 102 | UnityAds-এ ডিভাইস কাজ করে না। |
| 103 | UnityAds kUnityAdsFinishStateError সমস্যা সংক্রান্ত স্ট্যাটাস সহ দেখানো শেষ করেছে। |
| 104 | Unity বিজ্ঞাপন অবজেক্টের ইনিশিয়ালাইজার কল করার পরে সেটি শূন্য হয়ে যায়। |
| ১০৫ | বিজ্ঞাপন রেডি না থাকার কারণে Unity Ads দেখানো যায়নি। |
| 107 | UnityAds, প্লেসমেন্ট স্টেট kUnityAdsPlacementStateDisabled সহ প্লেসমেন্ট পরিবর্তন সংক্রান্ত কলব্যাক কল করেছে। |
| 108 | এই প্লেসমেন্টের জন্য আগে থেকেই একটি বিজ্ঞাপন লোড করা ছিল। UnityAds SDK একই প্লেসমেন্টের জন্য একাধিক বিজ্ঞাপন লোড করতে পারে না। |
| ১০৯ | UnityAds-এর মাধ্যমে দেখানো ব্যানার বিজ্ঞাপন অনুরোধ করা সাইজের সাথে মিলছে না। |
| 110 | UnityAds-এ ইনিশিয়ালাইজেশন সংক্রান্ত সমস্যা হয়েছে। |
| 111 | বিজ্ঞাপনের ফর্ম্যাট কাজ করে না। |
| 112 | UnityAds একটি নাল বা খালি বিডিং টোকেন রিটার্ন করেছে। |
ভার্সন 0.1.0
- প্রাথমিক রিলিজ।
- Unity Ads Android অ্যাডাপ্টার ভার্সন 4.20.1.0 কাজ করে।
- Unity Ads iOS অ্যাডাপ্টার ভার্সন 4.20.0.0 কাজ করে।
- Google Mobile Ads React Native প্লাগ-ইন ভার্সন 0.1.0-এর মাধ্যমে তৈরি ও পরীক্ষা করা হয়েছে।