এই নির্দেশিকা আপনাকে দেখায় যে কিভাবে জলপ্রপাত একত্রীকরণগুলি কভার করে মধ্যস্থতা ব্যবহার করে ইউনিটি বিজ্ঞাপনগুলি থেকে বিজ্ঞাপনগুলি লোড এবং প্রদর্শন করতে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করতে হয়৷ এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে ইউনিটি বিজ্ঞাপন যোগ করতে হয় এবং কীভাবে ইউনিটি বিজ্ঞাপন SDK এবং অ্যাডাপ্টারকে একটি Flutter অ্যাপে সংহত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
ইউনিটি বিজ্ঞাপনের জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
| মিশ্রণ | |
|---|---|
| বিডিং | |
| জলপ্রপাত | |
| বিন্যাস | |
| ব্যানার | |
| কৌশলে | |
| পুরস্কৃত | |
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 21 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী Flutter প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: ইউনিটি বিজ্ঞাপন UI-তে কনফিগারেশন সেট-আপ করুন
সাইন আপ করুন বা ইউনিটি বিজ্ঞাপনে লগ ইন করুন ৷
একটি প্রকল্প তৈরি করুন
ইউনিটি অ্যাডস ড্যাশবোর্ডে , প্রকল্পগুলিতে নেভিগেট করুন এবং প্রকল্প তৈরি করুন ক্লিক করুন।
ফর্মটি পূরণ করুন এবং আপনার প্রকল্প যোগ করতে প্রকল্প তৈরি করুন ক্লিক করুন।
মনিটাইজেশনে নেভিগেট করুন > শুরু করুন , তারপর শুরু করুন ক্লিক করুন।
প্রজেক্ট সেটআপ মোডেলে, আমি মধ্যস্থতা পার্টনারের জন্য মধ্যস্থতা এবং Google AdMob ব্যবহার করার পরিকল্পনা করছি নির্বাচন করুন, তারপর পরবর্তী ক্লিক করুন।
আপনার বিজ্ঞাপন সেটিংস নির্বাচন করুন, তারপর পরবর্তী ক্লিক করুন।
ফর্মটি পূরণ করুন, তারপর প্রকল্প যোগ করুন ক্লিক করুন।
গেম আইডি নোট নিন।
একটি বিজ্ঞাপন ইউনিট তৈরি করুন
মনিটাইজেশন > বিজ্ঞাপন ইউনিটে নেভিগেট করুন, তারপর অ্যাড ইউনিটে ক্লিক করুন।
একটি বিজ্ঞাপন ইউনিটের নাম লিখুন, তারপর আপনার প্ল্যাটফর্ম এবং বিজ্ঞাপন বিন্যাস নির্বাচন করুন।
অ্যান্ড্রয়েড
iOS
অবশেষে, আপনার বিজ্ঞাপন ইউনিট সংরক্ষণ করতে তৈরি করুন ক্লিক করুন।
একটি বসানো যোগ করুন
প্রকল্পটি তৈরি হয়ে গেলে, মনিটাইজেশন > প্লেসমেন্টে নেভিগেট করুন। একটি নতুন প্লেসমেন্ট তৈরি করতে, আপনার বিজ্ঞাপন ইউনিটের জন্য প্লেসমেন্ট যোগ করুন ক্লিক করুন।
প্রয়োজনীয় বিশদটি পূরণ করুন এবং প্লেসমেন্ট যোগ করুন ক্লিক করুন।
প্লেসমেন্ট আইডি নোট করুন।
অ্যান্ড্রয়েড
iOS
আপনার শংসাপত্র পুনরুদ্ধার করুন
গেম আইডি এবং প্লেসমেন্ট আইডি ছাড়াও, আপনারAdMob বিজ্ঞাপন ইউনিট আইডি সেট আপ করার জন্য আপনার ইউনিটি বিজ্ঞাপন API কী এবং সংস্থার মূল আইডির প্রয়োজন হবে।
মনিটাইজেশন > সেটআপ > এপিআই ম্যানেজমেন্টে নেভিগেট করুন এবং মনিটাইজেশন স্ট্যাটস এপিআই অ্যাক্সেস কী নোট করুন।
তারপর, মনিটাইজেশন > অর্গানাইজেশন সেটিংসে নেভিগেট করুন এবং প্রতিষ্ঠানের মূল আইডি নোট করুন।
পরীক্ষা মোড চালু করুন
ইউনিটি বিজ্ঞাপন ড্যাশবোর্ড থেকে পরীক্ষা মোড সক্ষম করা যেতে পারে। আপনার প্রকল্পের সেটিংসের অধীনে, টেস্টিং ট্যাবটি নির্বাচন করুন৷
আপনি প্রতিটি প্ল্যাটফর্মের সম্পাদনা বোতামে ক্লিক করে, ওভাররাইড ক্লায়েন্ট পরীক্ষা মোড চেক করে এবং সমস্ত ডিভাইসের জন্য ফোর্স টেস্ট মোড চালু (অর্থাৎ পরীক্ষার বিজ্ঞাপন ব্যবহার করুন) নির্বাচন করে আপনার অ্যাপের জন্য পরীক্ষা মোড জোর করতে পারেন।
অ্যান্ড্রয়েড
iOS
বিকল্পভাবে, আপনি অ্যাড টেস্ট ডিভাইস বোতামে ক্লিক করে নির্দিষ্ট ডিভাইসের জন্য পরীক্ষা মোড সক্ষম করতে পারেন।
ফর্মটি পূরণ করুন এবং সংরক্ষণ করুন ক্লিক করুন।
ধাপ 2: AdMob UI-তে ইউনিটি বিজ্ঞাপনের চাহিদা সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য,Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য,iOS- এর জন্য গাইডের ধাপ 2 দেখুন।
Unity Ads যোগ করুন GDPR এবং US রাজ্যের প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায়
GDPR সেটিংসএবংইউএস স্টেট রেগুলেশন সেটিংসএ ধাপগুলি অনুসরণ করুন AdMob UI এ।
ধাপ 3: ইউনিটি বিজ্ঞাপন SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml ফাইলেUnity Ads SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন:
dependencies:
gma_mediation_unity: ^1.0.0
ম্যানুয়াল ইন্টিগ্রেশন
Unity Ads এর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি বের করুন এবং এক্সট্রাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) আপনার ফ্লাটার প্রকল্পে যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_unity:
path: path/to/local/package
ধাপ 4: Unity Ads SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতির অধীনে, আপনাকে নিশ্চিত করতে হবে যে ডিভাইস শনাক্তকারী এবং ব্যক্তিগত ডেটার ব্যবহার সম্পর্কিত ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ব্যবহারকারীদের নির্দিষ্ট কিছু প্রকাশ দেওয়া হয়েছে এবং তাদের কাছ থেকে সম্মতি নেওয়া হয়েছে। এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ সম্মতি চাওয়ার সময়, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত ডেটা সংগ্রহ, গ্রহণ বা ব্যবহার করতে পারে এবং প্রতিটি নেটওয়ার্কের ব্যবহার সম্পর্কে তথ্য প্রদান করতে পারে। Google বর্তমানে স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
Unity Adsএর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন-এGmaMediationUnity.setGDPRConsent()GmaMediationUn. নিচের নমুনা কোডটি দেখায় কিভাবে Unity Ads SDK-কে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই পদ্ধতিতে কল করতে চান, তাহলে Google Mobile Ads SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়।
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
আরও বিশদ বিবরণের জন্য ইউনিটি বিজ্ঞাপনের গোপনীয়তা সম্মতি এবং ডেটা এপিআই এবং জিডিপিআর নির্দেশিকা মেনে চলা এবং প্রতিটি পদ্ধতিতে যে মানগুলি দেওয়া যেতে পারে তা দেখুন।
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দেওয়ার প্রয়োজন (যেমন আইন সেই শর্তাদি সংজ্ঞায়িত করে), অপ্ট-আউট সহ "বিক্রয়" পার্টির হোমপেজে একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অফার করা হয়েছে। মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
Unity Adsএর জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনGmaMediationUnity.setCCPAConsent() নিচের নমুনা কোডটি দেখায় কিভাবে Unity Ads SDK-কে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই পদ্ধতিতে কল করতে চান, তাহলে Google Mobile Ads SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়।
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
ধাপ 5: প্রয়োজনীয় কোড যোগ করুন
অ্যান্ড্রয়েড
ইউনিটি অ্যাড অ্যান্ড্রয়েড ইন্টিগ্রেশনের জন্য কোনও অতিরিক্ত কোডের প্রয়োজন নেই।
iOS
SKAdNetwork ইন্টিগ্রেশন
আপনার প্রকল্পের Info.plist ফাইলে SKAdNetwork শনাক্তকারী যোগ করতে ইউনিটি বিজ্ঞাপনের ডকুমেন্টেশন অনুসরণ করুন।
ধাপ 6: আপনার বাস্তবায়ন পরীক্ষা করুন
পরীক্ষা বিজ্ঞাপন সক্ষম করুন
নিশ্চিত করুন যে আপনিAdMob এর জন্য আপনার পরীক্ষার ডিভাইসটি নিবন্ধন করেছেন এবং Unity Ads UI-তে পরীক্ষা মোড সক্ষম করেছেন ৷
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনিUnity Adsথেকে পরীক্ষামূলক বিজ্ঞাপনগুলি পাচ্ছেন তা যাচাই করতে, Unity Ads (Waterfall) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টার ইউনিটি বিজ্ঞাপন থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে ResponseInfo ব্যবহার করে বিজ্ঞাপন প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটি পরীক্ষা করতে পারেন:
অ্যান্ড্রয়েড
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
iOS
GADMAdapterUnity
GADMediationAdapterUnity
একটি বিজ্ঞাপন লোড হতে ব্যর্থ হলে UnityAds অ্যাডাপ্টার দ্বারা নিক্ষিপ্ত কোড এবং সহগামী বার্তাগুলি এখানে রয়েছে:
অ্যান্ড্রয়েড
| ভুল সংকেত | কারণ |
|---|---|
| 0-10 | UnityAds SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। আরো বিস্তারিত জানার জন্য কোড দেখুন. |
| 101 | Admob UI এ কনফিগার করা UnityAds সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
| 102 | UnityAds একটি NO_FILL অবস্থার সাথে একটি প্লেসমেন্ট ফিরিয়ে দিয়েছে। |
| 103 | UnityAds একটি অক্ষম অবস্থার সাথে একটি প্লেসমেন্ট ফিরিয়ে দিয়েছে৷ |
| 104 | UnityAds একটি শূন্য প্রসঙ্গে একটি বিজ্ঞাপন দেখানোর চেষ্টা করেছে৷ |
| 105 | ইউনিটি বিজ্ঞাপনগুলি থেকে বিজ্ঞাপনগুলি শুরু, লোড এবং/অথবা দেখানোর জন্য ব্যবহৃত প্রসঙ্গটি কোনও কার্যকলাপের উদাহরণ নয়। |
| 106 | UnityAds এমন একটি বিজ্ঞাপন দেখানোর চেষ্টা করেছে যা দেখানোর জন্য প্রস্তুত নয়। |
| 107 | ইউনিটি অ্যাডস ডিভাইসে সমর্থিত নয়। |
| 108 | UnityAds একবারে প্রতি প্লেসমেন্টে শুধুমাত্র 1টি বিজ্ঞাপন লোড করতে পারে। |
| 109 | UnityAds একটি ERROR অবস্থার সাথে শেষ হয়েছে৷ |
| 200-204 | UnityAds ব্যানার একটি নির্দিষ্ট ত্রুটি. আরো বিস্তারিত জানার জন্য কোড দেখুন. |
iOS
| 0-9 | UnityAds SDK একটি ত্রুটি ফিরিয়ে দিয়েছে। আরও বিস্তারিত জানার জন্য ইউনিটির ডকুমেন্টেশন দেখুন। |
| 101 | Admob UI এ কনফিগার করা UnityAds সার্ভারের প্যারামিটার অনুপস্থিত/অবৈধ। |
| 102 | ডিভাইস ইউনিটিএডস দ্বারা সমর্থিত নয়। |
| 103 | UnityAds ত্রুটির অবস্থা kUnityAdsFinishStateError সহ উপস্থাপনা শেষ করেছে৷ |
| 104 | ইউনিটি অ্যাড অবজেক্টটি এর ইনিশিয়ালাইজার কল করার পরে শূন্য। |
| 105 | বিজ্ঞাপন প্রস্তুত না হওয়ার কারণে ইউনিটি বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে৷ |
| 106 | ইউনিটিএডস প্লেসমেন্ট পরিবর্তিত কলব্যাককে প্লেসমেন্ট স্টেট kUnityAdsPlacementStateNoFill বলে। |
| 107 | ইউনিটিএডস প্লেসমেন্ট পরিবর্তিত কলব্যাককে প্লেসমেন্ট স্টেট kUnityAdsPlacementStateDisabled বলে। |
| 108 | এই প্লেসমেন্টের জন্য ইতিমধ্যেই একটি বিজ্ঞাপন লোড করা হয়েছে৷ UnityAds SDK একই প্লেসমেন্টের জন্য একাধিক বিজ্ঞাপন লোড করা সমর্থন করে না। |
Unity Ads Flutter Mediation Adapter Changelog
সংস্করণ 1.0.0
- প্রাথমিক মুক্তি।
- ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টারের সংস্করণ 4.10.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা
- ইউনিটি iOS অ্যাডাপ্টারের সংস্করণ 4.10.0.0 এর সাথে যাচাইকৃত সামঞ্জস্যতা