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

এই নির্দেশিকা আপনাকে দেখায় যে কিভাবে জলপ্রপাত একত্রীকরণগুলি কভার করে মধ্যস্থতা ব্যবহার করে ইউনিটি বিজ্ঞাপনগুলি থেকে বিজ্ঞাপনগুলি লোড এবং প্রদর্শন করতে 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

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.3.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.2.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.3.1 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.1.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.2.0 দিয়ে তৈরি এবং পরীক্ষিত।

সংস্করণ 1.0.0

  • Google মোবাইল বিজ্ঞাপন ফ্লাটার প্লাগইন সংস্করণ 5.0.0 দিয়ে তৈরি এবং পরীক্ষিত।