Google Mobile Ads Unity প্লাগ-ইন সেট-আপ করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (Legacy)

Google Mobile Ads Unity প্লাগ-ইন, Unity ডেভেলপারদের Java বা Objective-C কোড না লিখেই Android এবং iOS অ্যাপে Google মোবাইল বিজ্ঞাপন পরিবেশন করতে দেয়। আপনার Unity প্রোজেক্টে C# স্ক্রিপ্ট দ্বারা ব্যবহৃত বিজ্ঞাপনের অনুরোধ করার জন্য প্লাগ-ইন একটি C# ইন্টারফেস প্রদান করে।

এই নির্দেশিকাটি সেইসব প্রকাশকদের জন্য যারা Unity অ্যাপ মনিটাইজ করতে চান।

পূর্বশর্ত

• Unity Editor 2019.4 বা তার পরবর্তী যেকোনও ভার্সন ব্যবহার করুন।
  • আমরা ২০২২.২ বা তার পরবর্তী ভার্সন ব্যবহার করার সাজেশন দিই।
• iOS-এ ডিপ্লয় করতে
  • Xcode 16.0 বা তার পরবর্তী যেকোনও ভার্সন
  • iOS 13.0 বা তার পরবর্তী ভার্সন টার্গেট করুন
  • CocoaPods
• Android-এ ডেপ্লয় করতে
  • Android API লেভেল ন্যূনতম ২৪ বা তার বেশি হতে হবে
  • Android API লেভেল ৩৫ বা তার পরবর্তী যেকোনও ভার্সনকে টার্গেট করুন

• সাজেস্ট করা হয়েছে: AdMob অ্যাকাউন্ট তৈরি করুন এবং Android বা iOS অ্যাপ রেজিস্টার করুন

Android API লেভেল প্রোজেক্ট সেটিংস > প্লেয়ার > Android > অন্যান্য সেটিংস > অন্যান্য সেটিংস-এ সেট করা হয়।

Unity প্লাগ-ইনের জন্য মোবাইল বিজ্ঞাপন ইমপোর্ট করুন

OpenUPM-CLI

আপনার ডিভাইসে OpenUPM CLI ইনস্টল করা থাকলে, নিম্নলিখিত কমান্ডের সাহায্যে OpenUPM রেজিস্ট্রি ইনস্টল করতে পারবেন:

openupm add com.google.ads.mobile

.unitypackageটি প্লাগ-ইন অ্যাসেট সরান

আপনি .unitypackage থেকে OpenUPM-এ মাইগ্রেট করলে, আপনাকে পুরনো লোকেশন থেকে ম্যানুয়ালি অ্যাসেট আনইনস্টল করতে হবে। .unitypackage থেকে ইমপোর্ট করা নিম্নলিখিত ডিরেক্টরিগুলি সরান:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

UI সহ OpenUPM

1. Unity মেনু বিকল্প এডিট করুন > প্রোজেক্ট সেটিংস > প্যাকেজ ম্যানেজার বেছে নিয়ে প্যাকেজ ম্যানেজার সেটিংস খুলুন।

2. প্যাকেজ ম্যানেজার উইন্ডোতে স্কোপড রেজিস্ট্রি হিসেবে OpenUPM যোগ করুন:

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. Unity মেনু বিকল্প Window > Package Manager বেছে নিয়ে প্যাকেজ ম্যানেজার মেনু খুলুন।

4. ম্যানেজার স্কোপ ড্রপ-ডাউন সেট করে আমার রেজিস্ট্রি বিকল্প বেছে নিন।

   

5. প্যাকেজের তালিকা থেকে Unity-র জন্য Google Mobile Ads প্যাকেজ বেছে নিন এবং ইনস্টল করুন বিকল্পে প্রেস করুন।

.unitypackageটি প্লাগ-ইন অ্যাসেট সরান

আপনি .unitypackage থেকে OpenUPM-এ মাইগ্রেট করলে, আপনাকে পুরনো লোকেশন থেকে ম্যানুয়ালি অ্যাসেট আনইনস্টল করতে হবে। .unitypackage থেকে ইমপোর্ট করা নিম্নলিখিত ডিরেক্টরিগুলি সরান:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. সবচেয়ে সাম্প্রতিক রিলিজের ভার্সন ট্যাগ নিয়ে আসুন। v প্রিফিক্স বাদ দিয়ে, ফেরত আসা ট্যাগটি হল Google Mobile Ads Unity Plugin ভার্সন।

   • macOS এবং Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. আগের কমান্ড থেকে পাওয়া ভার্সন ব্যবহার করে OpenUPM স্কোপড রেজিস্ট্রি ও ডিপেন্ডেন্সি যোগ করতে Packages/manifest.json ফাইলটি পরিবর্তন করুন:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

.unitypackageটি প্লাগ-ইন অ্যাসেট সরান

আপনি .unitypackage থেকে OpenUPM-এ মাইগ্রেট করলে, আপনাকে পুরনো লোকেশন থেকে ম্যানুয়ালি অ্যাসেট আনইনস্টল করতে হবে। .unitypackage থেকে ইমপোর্ট করা নিম্নলিখিত ডিরেক্টরিগুলি সরান:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

GitHub থেকে ইমপোর্ট করুন

1. GitHub থেকে .unitypackage রিলিজ ডাউনলোড করুন।
2. Unity মেনু বিকল্প থেকে .unitypackage ফাইল ইমপোর্ট করুন অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ এবং সব আইটেম ইমপোর্ট করুন।

ঐচ্ছিক: এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার বন্ধ করুন

আপনি যদি নিজের বিল্ড টুলের সাহায্যে Android এবং iOS লাইব্রেরি ম্যানেজ করেন, তাহলে com.unity.external-dependency-manager প্যাকেজ বন্ধ করতে পারবেন:

Unity Editor-এ, উইন্ডো > প্যাকেজ ম্যানেজার বেছে নিন এবং এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার (com.unity.external-dependency-manager) প্যাকেজ সরিয়ে দিন। এই প্যাকেজ সরিয়ে দিলে অ্যাসেট > Google Mobile Ads > সেটিংস থেকে এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার চালু করুন বিকল্প মুছে যায়।

মনে রাখবেন: GoogleMobileAdsSettings.asset ফাইল মুছে দিলে আপনার সেটিংস রিসেট হয়ে যায় এবং পরবর্তী ইমপোর্ট বা এডিটর লোড করার সময় com.unity.external-dependency-manager প্যাকেজ আবার ইনস্টল হয়। পরে প্যাকেজটি আবার ইনস্টল করতে, অ্যাসেট > Google Mobile Ads > সেটিংস বিকল্প বেছে নিন এবং এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার চালু করুন বিকল্প বেছে নিন।

পুরনো এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার ইনস্টল করুন

আপনার প্রোজেক্টে Unity 2022.2 বা তার আগের ভার্সন ব্যবহার করা হলে, Unity-র প্যাকেজ বন্ধ করার পরে আপনি Google-এর পুরনো com.google.external-dependency-manager প্যাকেজ ইনস্টল করতে পারবেন:

• Unity রিলিজ পৃষ্ঠার জন্য এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার থেকে লেটেস্ট .unitypackage ফাইল ডাউনলোড করুন এবং অ্যাসেট > প্যাকেজ ইমপোর্ট করুন > কাস্টম প্যাকেজ বিকল্প বেছে নিন।

• নিম্নলিখিত OpenUPM CLI কমান্ড রান করুন:

  openupm add com.google.external-dependency-manager

নেটিভ ডিপেন্ডেন্সি ম্যানুয়ালি কনফিগার করুন

আপনি এক্সটার্নাল ডিপেন্ডেন্সি ম্যানেজার প্যাকেজ ব্যবহার না করলে, Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml এবং Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml ফাইল থেকে প্রয়োজনীয় লাইব্রেরি আপনার বিল্ড ফাইলে যোগ করুন:

• Android-এর জন্য, এডিট করুন > প্রোজেক্ট সেটিংস > প্লেয়ার > Android > প্রকাশনা সেটিংস > বিল্ড বিকল্প বেছে নিন এবং কাস্টম মেন গ্রেডেল টেমপ্লেট চালু করুন। Assets/Plugins/Android/mainTemplate.gradle ফাইলের dependencies ব্লকে GoogleMobileAdsDependencies.xml এবং GoogleUmpDependencies.xml ফাইল থেকে প্রয়োজনীয় লাইব্রেরি যোগ করুন:

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  এছাড়াও, GoogleMobileAdsDependencies.xml ফাইলে থাকা ভার্সন ব্যবহার করে androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process এবং androidx.fragment:fragment প্যাকেজ যোগ করুন।

• iOS-এর জন্য, আপনার Xcode প্রোজেক্ট এক্সপোর্ট করুন। আপনার এক্সপোর্ট করা প্রোজেক্ট ফোল্ডারে Podfile ফাইলে GoogleMobileAdsDependencies.xml এবং GoogleUmpDependencies.xml ফাইল থেকে প্রয়োজনীয় পড যোগ করুন:

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  তারপর আপনার এক্সপোর্ট করা iOS প্রোজেক্ট ফোল্ডারে এই কমান্ড রান করুন:

  pod install --repo-update

আপনার AdMob অ্যাপ আইডি সেট করুন

Unity এডিটরে, মেনু থেকে অ্যাসেট > Google Mobile Ads > সেটিংস বিকল্প বেছে নিন।

প্রতিটি ফিল্ডে আপনার Android ও iOS AdMob অ্যাপ আইডি লিখুন।

Google Mobile Ads Unity Plugin এইসব সেটিংস টেক্সট হিসেবে Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset কনফিগারেশন ফাইলে সেভ করে।

SDK শুরু করুন

বিজ্ঞাপন লোড করার আগে, MobileAds.Initialize() কল করে আপনার অ্যাপকে Google Mobile Ads Unity Plugin ইনিশিয়ালাইজ করতে দিন। এটি শুধুমাত্র একবারই করতে হবে, আদর্শগতভাবে অ্যাপ লঞ্চ করার সময়।

সতর্কতা: MobileAds.Initialize() কল করার সময় Google Mobile Ads Unity Plugin বা মধ্যস্থতাকারী পার্টনার SDK-এর মাধ্যমে বিজ্ঞাপন প্রিলোড করা হতে পারে। আপনাকে যদি ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য (UK) বা সুইজারল্যান্ডের ব্যবহারকারীদের থেকে সম্মতি নিতে হয়, তাহলে tagForChildDirectedTreatment বা tag_for_under_age_of_consent-এর মতো অনুরোধ-নির্দিষ্ট ফ্ল্যাগ সেট করুন অথবা বিজ্ঞাপন লোড করার আগে অন্য কোনও অ্যাকশন নিন। Google Mobile Ads Unity Plugin শুরু করার আগে আপনি এটি করেছেন কিনা তা যাচাই করুন।

MobileAds.Initialize()-কে কীভাবে কল করতে হয় তার উদাহরণ এখানে দেওয়া হল:

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

মূল থ্রেডে Unity অবজেক্টের সাথে ইন্টার‍্যাক্ট করা

Google Mobile Ads Unity Plugin ব্যাকগ্রাউন্ড থ্রেডে বিজ্ঞাপন ইভেন্ট তৈরি করে। বিজ্ঞাপন কলব্যাক Unity অবজেক্টের সাথে ইন্টার‍্যাক্ট করলে, যেমন UnityEngine, স্পষ্টভাবে MobileAdsEventExecutor.ExecuteInUpdate পদ্ধতি ব্যবহার করে Unity মূল থ্রেডে সেই কাজ শিডিউল করুন। প্রয়োগ করার বিবরণ সম্পর্কে জানতে, Unity মেইন থ্রেডে বিজ্ঞাপন ইভেন্ট বাড়ান দেখুন।

বিজ্ঞাপনের ফর্ম্যাট বেছে নিন

Android বা iOS প্ল্যাটফর্মে ডিপ্লয় করার সময় আপনার Unity অ্যাপে এখন Google Mobile Ads Unity Plugin অন্তর্ভুক্ত করা হয়েছে। আপনি এখন বিজ্ঞাপন প্রয়োগ করার জন্য রেডি। AdMob বিভিন্ন ধরনের বিজ্ঞাপনের ফর্ম্যাট অফার করে, যাতে আপনি এমন একটি বেছে নিতে পারেন যা ব্যবহারকারীকে সেরা অভিজ্ঞতা প্রদান করে।

ব্যানার

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

ব্যানার বিজ্ঞাপন প্রয়োগ করা

স্থান

ইন্টারস্টিশিয়াল বিজ্ঞাপন ইউনিট আপনার অ্যাপে ফুল-পেজ বিজ্ঞাপন দেখায়। আপনার অ্যাপের ইন্টারফেসে স্বাভাবিক বিরতি ও ট্রানজিশনে এগুলি প্লেস করুন, যেমন গেমিং অ্যাপে লেভেল সম্পূর্ণ হওয়ার পরে।

ইন্টারস্টিশিয়াল বিজ্ঞাপন প্রয়োগ করা

নেটিভ

নেটিভ বিজ্ঞাপন হল এমন বিজ্ঞাপন যেখানে আপনি নিজের অ্যাপে শিরোনাম ও কল-টু-অ্যাকশনের মতো অ্যাসেট যেভাবে দেখানো হয় তা কাস্টমাইজ করতে পারবেন। বিজ্ঞাপন নিজে স্টাইল করার মাধ্যমে, আপনি স্বাভাবিক, বাধাহীন বিজ্ঞাপন প্রেজেন্টেশন তৈরি করতে পারেন যা ব্যবহারকারীর অভিজ্ঞতাকে আরও সমৃদ্ধ করতে পারে।

নেটিভ বিজ্ঞাপন প্রয়োগ করা

পুরস্কার জিতেছেন

পুরস্কার প্রদানকারী বিজ্ঞাপন ইউনিটের মাধ্যমে ব্যবহারকারীরা গেম খেলতে, সমীক্ষায় অংশগ্রহণ করতে বা ভিডিও দেখতে পারেন এবং কয়েন, অতিরিক্ত লাইফ বা পয়েন্টের মতো ইন-অ্যাপ পুরস্কার জিততে পারেন। আপনি বিভিন্ন বিজ্ঞাপন ইউনিটের জন্য বিভিন্ন পুরস্কার সেট করতে এবং ব্যবহারকারীর পাওয়া পুরস্কারের ভ্যালু ও আইটেম নির্দিষ্ট করতে পারবেন।

পুরস্কার প্রদানকারী বিজ্ঞাপন প্রয়োগ করা

পুরস্কৃত ইন্টারস্টিশিয়াল

পুরস্কৃত ইন্টারস্টিশিয়াল হল এক নতুন ধরনের ইনসেনটিভ-ভিত্তিক বিজ্ঞাপন ফর্ম্যাট যা আপনাকে অ্যাপের স্বাভাবিক ট্রানজিশনের সময় অটোমেটিক দেখানো বিজ্ঞাপনের জন্য কয়েন বা অতিরিক্ত লাইফের মতো পুরস্কার অফার করার সুবিধা দেয়।

পুরস্কার প্রদানকারী বিজ্ঞাপনের মতো, পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপন দেখার জন্য ব্যবহারকারীদের অপ্ট-ইন করতে হয় না।

পুরস্কার প্রদানকারী বিজ্ঞাপনে অপ্ট-ইন প্রম্পটের পরিবর্তে, পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপনে একটি ইন্ট্রো স্ক্রিন প্রয়োজন হয় যা পুরস্কারের ঘোষণা করে এবং ব্যবহারকারী চাইলে অপ্ট-আউট করার সুযোগ দেয়।

পুরস্কার প্রদানকারী ইন্টারস্টিশিয়াল বিজ্ঞাপন প্রয়োগ করা

অ্যাপ খোলার সাথে সাথে দেখা যায়

অ্যাপ খোলার সঙ্গে সঙ্গে দেখা যায় এমন বিজ্ঞাপন হল একটি বিজ্ঞাপনের ফর্ম্যাট যা ব্যবহারকারীরা আপনার অ্যাপ খুললে অথবা অন্য অ্যাপ থেকে আপনার অ্যাপে ফেরত এলে দেখানো হয়। বিজ্ঞাপনটি লোডিং স্ক্রিনের উপরে দেখানো হয়।

অ্যাপ খোলার সাথে সাথে দেখা যায় এমন বিজ্ঞাপন প্রয়োগ করা