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

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

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 বিভিন্ন ধরনের বিজ্ঞাপনের ফর্ম্যাট অফার করে, যাতে আপনি এমন একটি বেছে নিতে পারেন যা ব্যবহারকারীর জন্য সেরা অভিজ্ঞতা প্রদান করে।

ব্যানার

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

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

স্থান

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

পৃষ্ঠা মধ্যকালিন বিজ্ঞাপন প্রয়োগ করা

নেটিভ

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

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

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

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

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

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

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

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

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

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

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

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

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