এই নির্দেশিকা আপনাকে দেখায় যে কিভাবে জলপ্রপাত একত্রীকরণগুলি কভার করে মধ্যস্থতা ব্যবহার করে ইউনিটি বিজ্ঞাপনগুলি থেকে বিজ্ঞাপনগুলি লোড এবং প্রদর্শন করতে Google মোবাইল বিজ্ঞাপন SDK ব্যবহার করতে হয়৷ এটি কভার করে যে কীভাবে একটি বিজ্ঞাপন ইউনিটের মধ্যস্থতা কনফিগারেশনে ইউনিটি বিজ্ঞাপন যোগ করতে হয় এবং কীভাবে ইউনিটি বিজ্ঞাপন SDK এবং অ্যাডাপ্টারকে একটি ফ্লাটার অ্যাপে একীভূত করতে হয়।
সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফর্ম্যাট
ইউনিটি বিজ্ঞাপনের জন্য AdMob মধ্যস্থতা অ্যাডাপ্টারের নিম্নলিখিত ক্ষমতা রয়েছে:
ইন্টিগ্রেশন | |
---|---|
বিডিং | 1 |
জলপ্রপাত | |
বিন্যাস | |
ব্যানার | |
ইন্টারস্টিশিয়াল | |
পুরস্কৃত |
1 বিডিং ইন্টিগ্রেশন ওপেন বিটাতে আছে।
প্রয়োজনীয়তা
- সর্বশেষ Google মোবাইল বিজ্ঞাপন SDK
- ফ্লটার 3.7.0 বা উচ্চতর
- [বিডিংয়ের জন্য]: বিডিং-এ সমস্ত সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলিকে একীভূত করতে, ইউনিটি বিজ্ঞাপন 1.1.0 বা উচ্চতরের জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইন ব্যবহার করুন ( সর্বশেষ সংস্করণ প্রস্তাবিত )
- অ্যান্ড্রয়েডে স্থাপন করতে
- Android API স্তর 23 বা উচ্চতর
- iOS এ স্থাপন করতে
- 12.0 বা উচ্চতর আইওএস স্থাপনার লক্ষ্য
- Google মোবাইল বিজ্ঞাপন SDK-এর সাথে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রকল্প। বিস্তারিত জানার জন্য শুরু করুন দেখুন।
- মধ্যস্থতা সম্পূর্ণ করুন শুরু করুন গাইড
ধাপ 1: ইউনিটি বিজ্ঞাপন UI-তে কনফিগারেশন সেট-আপ করুন
সাইন আপ করুন বা ইউনিটি বিজ্ঞাপনে লগ ইন করুন ৷
একটি প্রকল্প তৈরি করুন
ইউনিটি বিজ্ঞাপন ড্যাশবোর্ডে , প্রকল্পগুলিতে নেভিগেট করুন এবং নতুন ক্লিক করুন।
ফর্মটি পূরণ করুন এবং আপনার প্রকল্প যোগ করতে তৈরি করুন ক্লিক করুন।
ইউনিটি বিজ্ঞাপন মনিটাইজেশনে নেভিগেট করুন, তারপর শুরু করুন ক্লিক করুন।
নতুন প্রজেক্ট মোডেলে, আমি মধ্যস্থতা পার্টনারের জন্য মধ্যস্থতা এবং Google AdMob ব্যবহার করব নির্বাচন করুন, তারপর পরবর্তী ক্লিক করুন।
বিজ্ঞাপন সেটিংসের জন্য বিকল্পটি নির্বাচন করুন, তারপরে পরবর্তী ক্লিক করুন।
আপনার প্লেসমেন্ট সেটআপ নির্বাচন করুন, তারপর পরবর্তী ক্লিক করুন।
বিডিং
জলপ্রপাত
ফর্মটি পূরণ করুন, তারপর প্রকল্প যোগ করুন ক্লিক করুন।
গেম আইডি নোট নিন।
বিজ্ঞাপন ইউনিট এবং প্লেসমেন্ট তৈরি করুন
ইউনিটি বিজ্ঞাপন মনিটাইজেশন > প্লেসমেন্টে নেভিগেট করুন, তারপর আপনার প্রকল্প নির্বাচন করুন এবং অ্যাড ইউনিটে ক্লিক করুন।
একটি বিজ্ঞাপন ইউনিটের নাম লিখুন, তারপর আপনার প্ল্যাটফর্ম এবং বিজ্ঞাপন বিন্যাস নির্বাচন করুন৷
অ্যান্ড্রয়েড
iOS
বিডিং
সেটআপের জন্য বিডিং নির্বাচন করুন। প্লেসমেন্টের অধীনে, প্লেসমেন্টের নাম লিখুন।
প্লেসমেন্ট আইডি নোট করুন।
জলপ্রপাত
সেটআপের জন্য জলপ্রপাত নির্বাচন করুন। প্লেসমেন্টের অধীনে, প্লেসমেন্টের নাম , জিও ট্যাগিং এবং টার্গেট লিখুন।
প্লেসমেন্ট আইডি নোট করুন।
অবশেষে, আপনার বিজ্ঞাপন ইউনিট এবং প্লেসমেন্ট সংরক্ষণ করতে বিজ্ঞাপন ইউনিট যোগ করুন ক্লিক করুন।
ইউনিটি বিজ্ঞাপন রিপোর্টিং API কী সনাক্ত করুন
বিডিং
বিডিং ইন্টিগ্রেশনের জন্য এই ধাপের প্রয়োজন নেই।
জলপ্রপাত
ইউনিটি বিজ্ঞাপন মনিটাইজেশন > এপিআই ম্যানেজমেন্টে নেভিগেট করুন এবং মনিটাইজেশন স্ট্যাটস এপিআই অ্যাক্সেসে এপিআই কী নোট করুন।
তারপর, ইউনিটি বিজ্ঞাপন মনিটাইজেশন > অর্গানাইজেশন সেটিংসে নেভিগেট করুন এবং সংস্থার মূল আইডিটি নোট করুন।
আপনার app-ads.txt আপডেট করুন
Apps app-ads.txt-এর জন্য অনুমোদিত বিক্রেতা হল একটি IAB টেক ল্যাব উদ্যোগ যা নিশ্চিত করতে সাহায্য করে যে আপনার অ্যাপ বিজ্ঞাপনের ইনভেনটরি শুধুমাত্র সেই চ্যানেলগুলির মাধ্যমে বিক্রি হয় যেগুলিকে আপনি অনুমোদিত হিসাবে চিহ্নিত করেছেন৷ বিজ্ঞাপনের আয়ের উল্লেখযোগ্য ক্ষতি রোধ করতে, আপনাকে একটি app-ads.txt
ফাইল প্রয়োগ করতে হবে। আপনি যদি ইতিমধ্যে এটি না করে থাকেন, তাহলে Ad Manager-এর জন্য একটি app-ads.txt ফাইল তৈরি করুন ।
ইউনিটি বিজ্ঞাপনের জন্য app-ads.txt
প্রয়োগ করতে, প্রথমবারের জন্য app-ads.txt সেট আপ দেখুন।
পরীক্ষা মোড চালু করুন
ইউনিটি বিজ্ঞাপন ড্যাশবোর্ড থেকে পরীক্ষা মোড সক্ষম করা যেতে পারে। ইউনিটি বিজ্ঞাপন মনিটাইজেশন > টেস্টিং- এ নেভিগেট করুন।
আপনি প্রতিটি প্ল্যাটফর্মের সম্পাদনা বোতামে ক্লিক করে, ওভাররাইড ক্লায়েন্ট পরীক্ষা মোড সক্ষম করে এবং সমস্ত ডিভাইসের জন্য ফোর্স টেস্ট মোড চালু (যেমন পরীক্ষা বিজ্ঞাপনগুলি ব্যবহার করুন) নির্বাচন করে আপনার অ্যাপের জন্য পরীক্ষা মোড জোর করতে পারেন৷
অ্যান্ড্রয়েড
iOS
বিকল্পভাবে, আপনি টেস্ট ডিভাইস যোগ করুন ক্লিক করে নির্দিষ্ট ডিভাইসের জন্য পরীক্ষা মোড সক্ষম করতে পারেন।
আপনার পরীক্ষার ডিভাইসের বিবরণ লিখুন, তারপর সংরক্ষণ করুন ক্লিক করুন।
ধাপ 2: AdMob UI-তে ইউনিটি বিজ্ঞাপনের চাহিদা সেট-আপ করুন
আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন
অ্যান্ড্রয়েড
নির্দেশাবলীর জন্য, Android এর জন্য গাইডের ধাপ 2 দেখুন।
iOS
নির্দেশাবলীর জন্য, iOS এর জন্য নির্দেশিকাতে ধাপ 2 দেখুন।
GDPR এবং মার্কিন রাষ্ট্রীয় প্রবিধান বিজ্ঞাপন অংশীদারদের তালিকায় ইউনিটি বিজ্ঞাপন যোগ করুন
AdMob UI-তে ইউরোপীয় ও মার্কিন রাজ্যের বিধিবিধানের বিজ্ঞাপন অংশীদারদের তালিকায় ইউনিটি বিজ্ঞাপন যোগ করতে ইউরোপীয় প্রবিধান সেটিংস এবং মার্কিন রাজ্যের প্রবিধান সেটিংসের ধাপগুলি অনুসরণ করুন।
ধাপ 3: ইউনিটি বিজ্ঞাপন SDK এবং অ্যাডাপ্টার আমদানি করুন
pub.dev এর মাধ্যমে ইন্টিগ্রেশন
আপনার প্যাকেজের pubspec.yaml
ফাইলে ইউনিটি বিজ্ঞাপন SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণগুলির সাথে নিম্নলিখিত নির্ভরতা যুক্ত করুন:
dependencies:
gma_mediation_unity: ^
ম্যানুয়াল ইন্টিগ্রেশন
Unity Ads-এর জন্য Google Mobile Ads মধ্যস্থতা প্লাগইন-এর সর্বশেষ সংস্করণ ডাউনলোড করুন, ডাউনলোড করা ফাইলটি বের করুন এবং আপনার ফ্লাটার প্রকল্পে এক্সট্র্যাক্ট করা প্লাগইন ফোল্ডার (এবং এর বিষয়বস্তু) যোগ করুন। তারপর, নিম্নলিখিত নির্ভরতা যোগ করে আপনার pubspec.yaml
ফাইলে প্লাগইনটি উল্লেখ করুন:
dependencies:
gma_mediation_unity:
path: path/to/local/package
ধাপ 4: Unity Ads SDK-এ গোপনীয়তা সেটিংস প্রয়োগ করুন
ইইউ সম্মতি এবং জিডিপিআর
Google EU ব্যবহারকারীর সম্মতি নীতির অধীনে, আপনাকে নিশ্চিত করতে হবে যে ডিভাইস শনাক্তকারী এবং ব্যক্তিগত ডেটার ব্যবহার সম্পর্কিত ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ব্যবহারকারীদের নির্দিষ্ট কিছু প্রকাশ দেওয়া হয়েছে এবং তাদের কাছ থেকে সম্মতি নেওয়া হয়েছে। এই নীতি EU ই-প্রাইভেসি নির্দেশিকা এবং সাধারণ ডেটা সুরক্ষা নিয়ন্ত্রণের (GDPR)-এর প্রয়োজনীয়তাগুলিকে প্রতিফলিত করে৷ সম্মতি চাওয়ার সময়, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত ডেটা সংগ্রহ, গ্রহণ বা ব্যবহার করতে পারে এবং প্রতিটি নেটওয়ার্কের ব্যবহার সম্পর্কে তথ্য প্রদান করতে পারে। Google বর্তমানে স্বয়ংক্রিয়ভাবে এই জাতীয় নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ পাস করতে অক্ষম৷
ইউনিটি বিজ্ঞাপনের জন্য Google মোবাইল বিজ্ঞাপন মধ্যস্থতা প্লাগইনে GmaMediationUnity.setGDPRConsent()
পদ্ধতি অন্তর্ভুক্ত রয়েছে। নিচের নমুনা কোডটি দেখায় কিভাবে Unity Ads SDK-কে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই পদ্ধতিতে কল করতে চান, তাহলে Google Mobile Ads SDK-এর মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগে এটি করার পরামর্শ দেওয়া হয়।
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
আরও বিশদ বিবরণের জন্য ইউনিটি বিজ্ঞাপনের গোপনীয়তা সম্মতি এবং ডেটা এপিআই এবং জিডিপিআর নির্দেশিকা মেনে চলা এবং প্রতিটি পদ্ধতিতে যে মানগুলি দেওয়া যেতে পারে তা দেখুন।
মার্কিন যুক্তরাষ্ট্র গোপনীয়তা আইন
মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইনে ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" এর "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দিতে হবে (যেমন আইন সেই শর্তগুলিকে সংজ্ঞায়িত করে), "বিক্রয়" পক্ষের হোমপেজে একটি বিশিষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে অপ্ট-আউটের প্রস্তাব দেওয়া হয়েছে৷ মার্কিন যুক্তরাষ্ট্রের গোপনীয়তা আইন মেনে চলার নির্দেশিকা Google বিজ্ঞাপন পরিবেশনের জন্য সীমাবদ্ধ ডেটা প্রক্রিয়াকরণ সক্ষম করার ক্ষমতা প্রদান করে, কিন্তু Google আপনার মধ্যস্থতা চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে অক্ষম। অতএব, আপনাকে অবশ্যই আপনার মধ্যস্থতা শৃঙ্খলে প্রতিটি বিজ্ঞাপন নেটওয়ার্ক সনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রিতে অংশগ্রহণ করতে পারে এবং সম্মতি নিশ্চিত করতে সেই নেটওয়ার্কগুলির প্রতিটি থেকে নির্দেশিকা অনুসরণ করতে পারে।
ইউনিটি বিজ্ঞাপনের জন্য 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-এর জন্য আপনার পরীক্ষার ডিভাইসটি নিবন্ধন করেছেন এবং ইউনিটি বিজ্ঞাপন UI-তে পরীক্ষা মোড সক্ষম করেছেন ।
পরীক্ষা বিজ্ঞাপন যাচাই করুন
আপনি ইউনিটি বিজ্ঞাপন থেকে পরীক্ষামূলক বিজ্ঞাপন পাচ্ছেন তা যাচাই করতে, ইউনিটি বিজ্ঞাপন (বিডিং) এবং ইউনিটি বিজ্ঞাপন (ওয়াটারফল) বিজ্ঞাপন উত্স(গুলি) ব্যবহার করে বিজ্ঞাপন পরিদর্শক-এ একক বিজ্ঞাপন উত্স পরীক্ষা সক্ষম করুন।
ত্রুটি কোড
যদি অ্যাডাপ্টার ইউনিটি বিজ্ঞাপন থেকে একটি বিজ্ঞাপন পেতে ব্যর্থ হয়, তাহলে প্রকাশকরা নিম্নলিখিত ক্লাসের অধীনে 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 | বিজ্ঞাপন প্রস্তুত না হওয়ার কারণে ইউনিটি বিজ্ঞাপন দেখাতে ব্যর্থ হয়েছে৷ |
107 | ইউনিটিএডস প্লেসমেন্ট পরিবর্তিত কলব্যাককে প্লেসমেন্ট স্টেট kUnityAdsPlacementStateDisabled বলে। |
108 | এই প্লেসমেন্টের জন্য ইতিমধ্যেই একটি বিজ্ঞাপন লোড করা হয়েছে৷ UnityAds SDK একই প্লেসমেন্টের জন্য একাধিক বিজ্ঞাপন লোড করা সমর্থন করে না। |
109 | UnityAds দ্বারা ফিরে আসা ব্যানার বিজ্ঞাপনটি অনুরোধ করা আকারের সাথে মেলে না। |
110 | UnityAds একটি প্রাথমিক ত্রুটি ফিরিয়ে দিয়েছে। |
111 | অসমর্থিত বিজ্ঞাপন বিন্যাস। |
Unity Ads Flutter Mediation Adapter Changelog
সংস্করণ 1.4.0
- ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টারের সংস্করণ 4.14.1.0 সমর্থন করে।
- ইউনিটি iOS অ্যাডাপ্টারের সংস্করণ 4.14.1.1 সমর্থন করে।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.3.0
- ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টারের সংস্করণ 4.13.1.0 সমর্থন করে।
- ইউনিটি iOS অ্যাডাপ্টারের সংস্করণ 4.13.1.0 সমর্থন করে।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.2.0
- ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.13.0.0 সমর্থন করে।
- ইউনিটি iOS অ্যাডাপ্টারের সংস্করণ 4.12.5.0 সমর্থন করে।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.1.0
- ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টারের সংস্করণ 4.12.3.0 সমর্থন করে।
- ইউনিটি iOS অ্যাডাপ্টারের সংস্করণ 4.12.3.1 সমর্থন করে।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.2.0 দিয়ে তৈরি এবং পরীক্ষিত।
সংস্করণ 1.0.0
- প্রাথমিক মুক্তি।
- ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টারের সংস্করণ 4.10.0.0 সমর্থন করে।
- ইউনিটি iOS অ্যাডাপ্টারের সংস্করণ 4.10.0.0 সমর্থন করে।
- Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.0.0 দিয়ে তৈরি এবং পরীক্ষিত।