গ্লোবাল সেটিংস

MobileAds ক্লাস Google Mobile Ads Unity Plugin-এর জন্য গ্লোবাল সেটিংস প্রদান করে।

Unity-র মূল থ্রেডে বিজ্ঞাপন ইভেন্ট তৈরি করুন

Google Mobile Ads Unity Plugin, Unity-র মূল থ্রেড থেকে আলাদা থ্রেডে ইভেন্ট রেইজ করে। আপনি যদি বিজ্ঞাপন ইভেন্ট প্রয়োগ করেন এবং Unity অবজেক্টের সাথে ইন্টার‍্যাক্ট করেন, তাহলে আপনাকে Unity-র মূল থ্রেডের সাথে Google Mobile Ads Unity Plugin ইভেন্ট সিঙ্ক করতে হবে।

ম্যানুয়ালি বা অটোমেটিক, Google Mobile Ads Unity Plugin-কে সিঙ্ক্রোনাইজেশন ম্যানেজ করতে দিয়ে, ইউনিটি মেইন থ্রেডের সাথে বিজ্ঞাপন ইভেন্ট সিঙ্ক্রোনাইজ করুন।

সাজেস্ট করা: বিজ্ঞাপন ইভেন্ট ম্যানুয়ালি সিঙ্ক করুন

বিজ্ঞাপন ইভেন্ট ম্যানুয়ালি সিঙ্ক করতে, মূল থ্রেডে ExecuteInUpdate পদ্ধতি ব্যবহার করুন। UnityEngine অবজেক্টের সাথে ইন্টার‍্যাক্ট করার সময় এবং RaiseAdEventsOnUnityMainThread প্রপার্টি বন্ধ থাকলে, আপনার ExecuteInUpdate পদ্ধতি ব্যবহার করা উচিত।

নিম্নলিখিত উদাহরণটি একটি ব্যাকগ্রাউন্ড থ্রেড লগ করে এবং UnityEngine অবজেক্টের সাথে ইন্টার‍্যাক্ট করার জন্য একটি অ্যাকশন রান করে:

// Google Mobile Ads events are raised off the Unity main thread.

// This log is executed off the Unity main thread.
// Write all time-sensitive code before ExecuteInUpdate().
Debug.Log("Executing off the Unity main thread.");

// Use ExecuteInUpdate to run code on the main thread, allowing you to
// interact with Unity UI and GameObjects.
// Changed to fully-qualified name to resolve CS0103
GoogleMobileAds.Common.MobileAdsEventExecutor.ExecuteInUpdate(() =>
{
    // This callback may be delayed on Android until the user returns to the app.
    Debug.Log("Executing on the Unity main thread.");

    // Place all code that interacts with Unity UI and GameObjects inside this callback.
    if (_myGameObject != null)
    {
        _myGameObject.SetActive(true);
    }
});
GlobalSettingsSnippets.cs

বিজ্ঞাপন ইভেন্টে সিঙ্ক করা অটোমেট করুন

Google Mobile Ads Unity Plugin-এর জন্য বিজ্ঞাপন ইভেন্ট সিঙ্ক করতে, MobileAds.RaiseAdEventsOnUnityMainThread প্রপার্টি true-এ সেট করুন:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

ভিডিও বিজ্ঞাপনের ভলিউম কন্ট্রোল

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

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

বিজ্ঞাপন লোড করার আগে SetApplicationVolume() মেথড কল করে আপনি Google Mobile Ads Unity Plugin-এ অ্যাপের আপেক্ষিক ভলিউম সম্পর্কে অভিযোগ জানাতে পারবেন। বিজ্ঞাপনের ভলিউম 0.0 (মিউট) থেকে 1.0 (ডিভাইসের বর্তমান ভলিউম) পর্যন্ত হতে পারে। SDK-তে কীভাবে আপেক্ষিক অ্যাপ ভলিউম রিপোর্ট করতে হয় তার একটি উদাহরণ এখানে দেওয়া হল:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

অ্যাপের ভলিউম মিউট করা হয়েছে তা SDK-কে জানাতে, বিজ্ঞাপন লোড করার আগে SetApplicationMuted() মেথড কল করুন:

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

ডিফল্ট হিসেবে, অ্যাপের ভলিউম 1-এ সেট করা থাকে, যা ডিভাইসের বর্তমান ভলিউম এবং অ্যাপটি মিউট করা থাকে না।

কুকির জন্য সম্মতি

আপনার অ্যাপের বিশেষ প্রয়োজনীয়তা থাকলে, আপনি ঐচ্ছিক ApplicationPreferences কী gad_has_consent_for_cookies শূন্যতে সেট করে সীমিত বিজ্ঞাপন চালু করতে পারবেন:

// Enable limited ads
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Android মিনিফিকেশন

এই Unity প্রকাশনা বিকল্প আপনাকে জাভা কোড ছোট করার সুবিধা চালু করতে দেয়। আপনি যদি ছোট করার বিকল্প চালু করেন, তাহলে SDK-এর মাধ্যমে রেফারেন্স করা ক্লাসগুলি রাখার জন্য আপনাকে একটি কাস্টম proguard ফাইলও তৈরি করতে হবে।

1. কাস্টম Proguard ফাইল চালু করুন

   প্রোজেক্ট সেটিংস > প্লেয়ার > Android > প্রকাশনা সেটিংস > বিল্ড বিকল্পে গিয়ে এগুলি বেছে নিন:

   • কাস্টম Proguard ফাইল

2. /Assets/Plugins/Android/proguard-user.txt খুলে নিম্নলিখিত তথ্য যোগ করুন:

-keep class com.google.** { public *; }

ক্র্যাশ রিপোর্টিং বন্ধ করুন

Google Mobile Ads Unity Plugin ডিবাগিং ও বিশ্লেষণের উদ্দেশ্যে ক্র্যাশ রিপোর্ট সংগ্রহ করে। ক্র্যাশ রিপোর্টিং বন্ধ করতে, Android এবং iOS-এর জন্য নিম্নলিখিত বিভাগগুলি দেখুন।

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}

Unity প্লাগ-ইন ভার্সন পান

Unity SDK ভার্সন পেতে, নিম্নলিখিত কমান্ড রান করুন:

// Get the Unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

প্ল্যাটফর্মের ভার্সন পান

Unity-র জন্য Google Mobile Ads Unity Plugin, Android ও iOS প্ল্যাটফর্ম SDK-এর উপর নির্ভর করে। প্ল্যাটফর্ম SDK-এর ভার্সন পেতে, নিম্নলিখিত কমান্ড রান করুন:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());