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

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) অ্যান্ড্রয়েড আইওএস ইউনিটি ফ্লাটার

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে মিডিয়েশন ব্যবহার করে ইউনিটি অ্যাডস থেকে বিজ্ঞাপন লোড ও প্রদর্শন করার জন্য Google Mobile Ads Flutter Plugin ব্যবহার করতে হয়, যেখানে বিডিং এবং ওয়াটারফল ইন্টিগ্রেশন অন্তর্ভুক্ত রয়েছে। এতে একটি অ্যাড ইউনিটের মিডিয়েশন কনফিগারেশনে ইউনিটি অ্যাডস যোগ করার পদ্ধতি এবং একটি ফ্লাটার অ্যাপে ইউনিটি অ্যাডস এসডিকে ও অ্যাডাপ্টার ইন্টিগ্রেট করার পদ্ধতি আলোচনা করা হয়েছে।

সমর্থিত ইন্টিগ্রেশন এবং বিজ্ঞাপন ফরম্যাট

ইউনিটি অ্যাডস-এর জন্য অ্যাড ম্যানেজার মিডিয়েশন অ্যাডাপ্টারটির নিম্নলিখিত সক্ষমতাগুলো রয়েছে:

প্রয়োজনীয়তা

• সর্বশেষ Google Mobile Ads Flutter Plugin
• ফ্লাটার ৩.৭.০ বা উচ্চতর
• [বিডিংয়ের জন্য]: বিডিংয়ে সকল সমর্থিত বিজ্ঞাপন ফরম্যাট অন্তর্ভুক্ত করতে, Unity Ads 1.1.0 বা তার উচ্চতর সংস্করণের জন্য Google Mobile Ads মিডিয়েশন প্লাগইন ব্যবহার করুন ( সর্বশেষ সংস্করণ ব্যবহার করার পরামর্শ দেওয়া হচ্ছে )।
• অ্যান্ড্রয়েডে স্থাপন করতে
  • অ্যান্ড্রয়েড এপিআই লেভেল ২৩ বা তার বেশি
• iOS-এ স্থাপন করতে
  • iOS ডেপ্লয়মেন্ট টার্গেট ১৩.০ বা তার বেশি
• Google Mobile Ads Flutter Plugin দিয়ে কনফিগার করা একটি কার্যকরী ফ্লাটার প্রজেক্ট। বিস্তারিত জানতে Google Mobile Ads Flutter Plugin সেট আপ করুন’ দেখুন।
• মধ্যস্থতার ব্যবস্থা করুন ।

ধাপ ১: ইউনিটি অ্যাডস UI-তে কনফিগারেশন সেট আপ করুন।

ইউনিটি অ্যাডস-এ সাইন আপ করুন অথবা লগ ইন করুন ।

একটি প্রকল্প তৈরি করুন

ইউনিটি অ্যাডস ড্যাশবোর্ডে , প্রজেক্টস -এ যান এবং নিউ-তে ক্লিক করুন।

ফর্মটি পূরণ করুন এবং আপনার প্রজেক্ট যোগ করতে 'Create'-এ ক্লিক করুন।

Unity Ads Monetization- এ যান, তারপর Get started-এ ক্লিক করুন।

নতুন প্রজেক্ট মডালে, ‘আমি মিডিয়েশন ব্যবহার করব এবং মিডিয়েশন পার্টনার হিসেবে গুগল অ্যাডমব’ নির্বাচন করুন, তারপর ‘নেক্সট’ ক্লিক করুন।

বিজ্ঞাপন সেটিংসের বিকল্পটি নির্বাচন করুন, তারপর পরবর্তী বাটনে ক্লিক করুন।

আপনার বসানোর বিন্যাস নির্বাচন করুন, তারপর 'পরবর্তী' বোতামে ক্লিক করুন।

ফর্মটি পূরণ করুন, তারপর 'প্রজেক্ট যোগ করুন' বাটনে ক্লিক করুন।

গেম আইডিটি লিখে রাখুন।

বিজ্ঞাপন ইউনিট এবং প্লেসমেন্ট তৈরি করুন

Unity Ads Monetization > Placements- এ যান, তারপর আপনার প্রজেক্টটি নির্বাচন করুন এবং Add ad unit-এ ক্লিক করুন।

একটি বিজ্ঞাপন ইউনিটের নাম লিখুন, তারপর আপনার প্ল্যাটফর্ম এবং বিজ্ঞাপনের ফরম্যাট নির্বাচন করুন।

Monetization > Placements- এ যান, তারপর Add Ad Unit-এ ক্লিক করুন।

একটি বিজ্ঞাপন ইউনিটের নাম লিখুন, তারপর আপনার প্ল্যাটফর্ম এবং বিজ্ঞাপনের ফরম্যাট নির্বাচন করুন।

সেটআপের জন্য ওয়াটারফল নির্বাচন করুন। প্লেসমেন্টের অধীনে, প্লেসমেন্টের নাম , জিও ট্যাগিং এবং টার্গেট লিখুন।

প্লেসমেন্ট আইডি-টি লিখে রাখুন।

অবশেষে, আপনার বিজ্ঞাপন ইউনিট ও তার অবস্থান সংরক্ষণ করতে 'Add ad unit'-এ ক্লিক করুন।

ইউনিটি অ্যাডস রিপোর্টিং এপিআই কী সনাক্ত করুন

আপনার app-ads.txt আপডেট করুন।

Apps-এর জন্য অনুমোদিত বিক্রেতা app-ads.txt হলো IAB টেক ল্যাবের একটি উদ্যোগ, যা নিশ্চিত করতে সাহায্য করে যে আপনার অ্যাপের বিজ্ঞাপন ইনভেন্টরি শুধুমাত্র আপনার দ্বারা অনুমোদিত হিসেবে চিহ্নিত চ্যানেলগুলোর মাধ্যমেই বিক্রি হয়। বিজ্ঞাপনের আয়ে বড় ধরনের ক্ষতি এড়াতে, আপনাকে একটি app-ads.txt ফাইল প্রয়োগ করতে হবে। যদি আপনি ইতিমধ্যে তা না করে থাকেন, তাহলে Ad Manager-এর জন্য একটি app-ads.txt ফাইল তৈরি করুন ।

ইউনিটি অ্যাডস-এর জন্য app-ads.txt প্রয়োগ করতে, প্রথমবারের মতো app-ads.txt সেট আপ করা দেখুন।

টেস্ট মোড চালু করুন

ইউনিটি অ্যাডস ড্যাশবোর্ড থেকে টেস্ট মোড চালু করা যায়। ইউনিটি অ্যাডস মনিটাইজেশন > টেস্টিং- এ যান।

প্রতিটি প্ল্যাটফর্মের এডিট বাটনে ক্লিক করে, ‘Override client test mode’ সক্রিয় করে এবং সমস্ত ডিভাইসের জন্য ‘Force test mode ON’ (অর্থাৎ টেস্ট বিজ্ঞাপন ব্যবহার করুন) নির্বাচন করে আপনি আপনার অ্যাপের জন্য টেস্ট মোড বাধ্যতামূলক করতে পারেন।

বিকল্পভাবে, আপনি 'অ্যাড টেস্ট ডিভাইস' (Add Test Device) এ ক্লিক করে নির্দিষ্ট ডিভাইসগুলির জন্য টেস্ট মোড চালু করতে পারেন।

আপনার টেস্ট ডিভাইসের বিবরণ লিখুন, তারপর সেভ-এ ক্লিক করুন।

ধাপ ২: অ্যাড ম্যানেজার UI-তে ইউনিটি অ্যাডস ডিমান্ড সেট আপ করুন।

আপনার বিজ্ঞাপন ইউনিটের জন্য মধ্যস্থতা সেটিংস কনফিগার করুন।

GDPR এবং মার্কিন যুক্তরাষ্ট্রের রাজ্য বিধিমালা অনুযায়ী বিজ্ঞাপন অংশীদারদের তালিকায় ইউনিটি অ্যাডস যোগ করুন

অ্যাড ম্যানেজার UI-তে ইউরোপীয় এবং মার্কিন রাজ্য বিধিমালা অ্যাড পার্টনার তালিকায় ইউনিটি অ্যাডস যোগ করতে , ইউরোপীয় বিধিমালা সেটিংস এবং মার্কিন রাজ্য বিধিমালা সেটিংস- এর ধাপগুলো অনুসরণ করুন।

ধাপ ৩: ইউনিটি অ্যাডস এসডিকে এবং অ্যাডাপ্টার ইম্পোর্ট করুন

pub.dev এর মাধ্যমে একীকরণ

আপনার প্যাকেজের pubspec.yaml ফাইলে Unity Ads SDK এবং অ্যাডাপ্টারের সর্বশেষ সংস্করণ সহ নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করুন:

dependencies:
  gma_mediation_unity: ^1.6.5

ম্যানুয়াল ইন্টিগ্রেশন

Unity Ads- এর জন্য Google Mobile Ads মিডিয়েশন প্লাগইনের সর্বশেষ সংস্করণটি ডাউনলোড করুন, ডাউনলোড করা ফাইলটি এক্সট্র্যাক্ট করুন এবং এক্সট্র্যাক্ট করা প্লাগইন ফোল্ডারটি (এবং এর ভেতরের সবকিছু) আপনার Flutter প্রজেক্টে যোগ করুন। এরপর, আপনার pubspec.yaml ফাইলে নিম্নলিখিত ডিপেন্ডেন্সিটি যোগ করে প্লাগইনটিকে রেফারেন্স করুন:

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

ধাপ ৪: ইউনিটি অ্যাডস এসডিকে-তে গোপনীয়তা সেটিংস প্রয়োগ করুন

ইইউ সম্মতি এবং জিডিপিআর

Google EU ব্যবহারকারীর সম্মতি নীতি মেনে চলার জন্য, আপনাকে ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য এবং সুইজারল্যান্ডে থাকা আপনার ব্যবহারকারীদের কাছে কিছু তথ্য প্রকাশ করতে হবে এবং যেখানে আইনত প্রয়োজন সেখানে কুকি বা অন্যান্য স্থানীয় স্টোরেজ ব্যবহারের জন্য এবং বিজ্ঞাপনের ব্যক্তিগতকরণের জন্য ব্যক্তিগত ডেটা সংগ্রহ, শেয়ার ও ব্যবহারের জন্য তাদের সম্মতি নিতে হবে। এই নীতিটি EU ePrivacy Directive এবং General Data Protection Regulation (GDPR)-এর প্রয়োজনীয়তাগুলো প্রতিফলিত করে। আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন উৎসে সম্মতি পৌঁছেছে কিনা তা যাচাই করার দায়িত্ব আপনার। Google স্বয়ংক্রিয়ভাবে এই ধরনের নেটওয়ার্কগুলিতে ব্যবহারকারীর সম্মতির পছন্দ প্রেরণ করতে অক্ষম।

ইউনিটি অ্যাডস-এর জন্য গুগল মোবাইল অ্যাডস মিডিয়েশন প্লাগইনটিতে GmaMediationUnity.setGDPRConsent() মেথডটি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে ইউনিটি অ্যাডস SDK-তে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই মেথডটি কল করার সিদ্ধান্ত নেন, Google Mobile Ads Flutter Plugin মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগেই তা করার পরামর্শ দেওয়া হচ্ছে।

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

আরও বিস্তারিত তথ্যের জন্য এবং প্রতিটি মেথডে যে ভ্যালুগুলো প্রদান করা যায়, সে সম্পর্কে জানতে ইউনিটি অ্যাডস-এর প্রাইভেসি কনসেন্ট ও ডেটা এপিআই এবং কনজিউমার প্রাইভেসি অ্যাক্ট কমপ্লায়েন্স গাইড দেখুন।

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন

মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন অনুযায়ী, ব্যবহারকারীদের তাদের "ব্যক্তিগত তথ্য" (আইনে এই পদগুলির যে সংজ্ঞা দেওয়া হয়েছে) "বিক্রয়" থেকে অপ্ট-আউট করার অধিকার দেওয়া আবশ্যক। এই অপ্ট-আউটের সুযোগটি "বিক্রেতা" পক্ষের হোমপেজে একটি সুস্পষ্ট "আমার ব্যক্তিগত তথ্য বিক্রি করবেন না" লিঙ্কের মাধ্যমে দেওয়া হয়। মার্কিন যুক্তরাষ্ট্রের রাজ্যগুলির গোপনীয়তা আইন পরিপালন নির্দেশিকা গুগল বিজ্ঞাপন পরিবেশনের জন্য সীমিত ডেটা প্রক্রিয়াকরণ সক্ষম করার সুযোগ দেয়, কিন্তু গুগল আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্কে এই সেটিংটি প্রয়োগ করতে পারে না। অতএব, আপনাকে আপনার মিডিয়েশন চেইনের প্রতিটি বিজ্ঞাপন নেটওয়ার্ক শনাক্ত করতে হবে যা ব্যক্তিগত তথ্য বিক্রয়ে অংশ নিতে পারে এবং পরিপালন নিশ্চিত করার জন্য সেই নেটওয়ার্কগুলির প্রত্যেকটির নির্দেশিকা অনুসরণ করতে হবে।

ইউনিটি অ্যাডস-এর জন্য গুগল মোবাইল অ্যাডস মিডিয়েশন প্লাগইনটিতে GmaMediationUnity.setCCPAConsent() মেথডটি অন্তর্ভুক্ত রয়েছে। নিম্নলিখিত নমুনা কোডটি দেখায় কিভাবে ইউনিটি অ্যাডস SDK-তে সম্মতির তথ্য পাঠাতে হয়। আপনি যদি এই মেথডটি কল করার সিদ্ধান্ত নেন, Google Mobile Ads Flutter Plugin মাধ্যমে বিজ্ঞাপনের অনুরোধ করার আগেই তা করার পরামর্শ দেওয়া হচ্ছে।

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

ধাপ ৫: প্রয়োজনীয় কোড যোগ করুন

ধাপ ৬: আপনার বাস্তবায়ন পরীক্ষা করুন

টেস্ট বিজ্ঞাপন সক্রিয় করুন

আপনার টেস্ট ডিভাইসটি অ্যাড ম্যানেজারে রেজিস্টার করুন এবং ইউনিটি অ্যাডস UI-তে টেস্ট মোড চালু করুন ।

পরীক্ষামূলক বিজ্ঞাপন যাচাই করুন

আপনি ইউনিটি অ্যাডস থেকে টেস্ট অ্যাড পাচ্ছেন কিনা তা যাচাই করতে, অ্যাড ইন্সপেক্টরে ইউনিটি অ্যাডস (বিডিং) এবং ইউনিটি অ্যাডস (ওয়াটারফল) অ্যাড সোর্স(গুলি) ব্যবহার করে সিঙ্গেল অ্যাড সোর্স টেস্টিং সক্ষম করুন।

ত্রুটি কোড

যদি অ্যাডাপ্টারটি ইউনিটি অ্যাডস থেকে কোনো বিজ্ঞাপন গ্রহণ করতে ব্যর্থ হয়, তাহলে পাবলিশাররা নিম্নলিখিত ক্লাসগুলির অধীনে থাকা ResponseInfo ব্যবহার করে বিজ্ঞাপনের প্রতিক্রিয়া থেকে অন্তর্নিহিত ত্রুটিটি পরীক্ষা করতে পারেন:

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

GADMAdapterUnity
GADMediationAdapterUnity

যখন কোনো বিজ্ঞাপন লোড হতে ব্যর্থ হয়, তখন UnityAds অ্যাডাপ্টার যে কোড এবং তার সাথে বার্তাগুলো প্রদর্শন করে, তা নিচে দেওয়া হলো:

ইউনিটি অ্যাডস ফ্লাটার মিডিয়েশন অ্যাডাপ্টার চেঞ্জলগ

সংস্করণ ১.৬.৫

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.16.6.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.16.6.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৬.৪

• ফ্লাটারের সর্বনিম্ন সংস্করণ ৩.৩৫.১-এ আপডেট করা হয়েছে।
• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 7.0.0 সমর্থন করার জন্য আপডেট করা হয়েছে।
• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.16.5.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.16.5.0 সমর্থন করে।

সংস্করণ ১.৬.৩

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.16.3.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.16.3.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৬.২

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.16.3.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ ৪.১৬.২.০ সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৬.১

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.16.1.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.16.1.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৬.০

• এখন ন্যূনতম iOS সংস্করণ 13.0 প্রয়োজন।
• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.16.0.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.16.0.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৫.১

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.15.1.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.15.1.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৫.০

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.15.0.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.15.0.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৪.১

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.14.2.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.14.2.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৪.০

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.14.1.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.14.1.1 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 6.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.৩.০

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.13.1.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.13.1.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ ৫.৩.১ দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.২.০

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.13.0.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ ৪.১২.৫.০ সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ ৫.৩.১ দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.১.০

• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.12.3.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ ৪.১২.৩.১ সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ ৫.২.০ দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।

সংস্করণ ১.০.০

• প্রাথমিক প্রকাশ।
• ইউনিটি অ্যান্ড্রয়েড অ্যাডাপ্টার সংস্করণ 4.10.0.0 সমর্থন করে।
• ইউনিটি আইওএস অ্যাডাপ্টার সংস্করণ 4.10.0.0 সমর্থন করে।

• গুগল মোবাইল অ্যাডস ফ্লাটার প্লাগইন সংস্করণ 5.0.0 দিয়ে তৈরি ও পরীক্ষা করা হয়েছে।