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

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

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

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

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

ম্যানুয়ালি বা অটোমেটিক, ইউনিটি মেইন থ্রেডের সাথে বিজ্ঞাপন ইভেন্ট সিঙ্ক করুন, যাতে সিঙ্ক করার বিষয়টি ম্যানেজ করতে পারে।

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

বিজ্ঞাপন ইভেন্ট ম্যানুয়ালি সিঙ্ক করতে, মূল থ্রেডে 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.ExecuteInU>pdate(() =
{
    // 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.SetAct
ive(true);
    }
});Globa
lSettingsSnippets.cs

গুরুত্বপূর্ণ: Unity Update() লুপ ExecuteInUpdate মেথডের মধ্যে থাকা সব কোডকে বিলম্বিত করে। আপনাকে টেলিমেট্রি বা ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন (ILAR)-এর মতো সময়-সংবেদনশীল সব কোড ExecuteInUpdate মেথডের বাইরে প্লেস করতে হবে।

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

-এর জন্য বিজ্ঞাপন ইভেন্ট সিঙ্ক করতে, 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;
    }
}

সতর্কতা: MobileAds.RaiseAdEventsOnUnityMainThread-কে true ভ্যালুতে সেট করার সময়, আপনার গেম পজ করা বা ব্যাকগ্রাউন্ডে চলাকালীন ট্রিগার হওয়া বিজ্ঞাপন ইভেন্টগুলি ব্যবহারকারী গেমে ফিরে না আসা পর্যন্ত বিলম্বিত হয়। এই সময়ের মধ্যে ব্যবহারকারী অ্যাপ বন্ধ করে দিলে, এইসব বিলম্বিত বিজ্ঞাপন ইভেন্ট সম্পূর্ণভাবে বাদ দেওয়া হয়। প্রকাশকরা MobileAds.RaiseAdEventsOnUnityMainThread থেকে true-এ সেট করার ফলে ইম্প্রেশন-লেভেল বিজ্ঞাপন থেকে উপার্জন রিপোর্টিংয়ে ৩০% পর্যন্ত পার্থক্য দেখা গেছে। সাজেশন:এর পরিবর্তে স্বতন্ত্র বিজ্ঞাপন ইভেন্ট ম্যানুয়ালি সিঙ্ক করুন।

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

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

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

আপনি বিজ্ঞাপন লোড করার আগে SetApplicationVolume() পদ্ধতি কল করে -এ আপেক্ষিক অ্যাপ ভলিউম রিপোর্ট করতে পারেন। বিজ্ঞাপনের ভলিউম 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 *; }

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

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

Android

আপনার অ্যাপের AndroidManifest.xml ফাইলে DISABLE_CRASH_REPORTING-এর মান true সেট করে <meta-data> ট্যাগ যোগ করুন:

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:valu>e=&q<uot;true&quo>t<; /
   /a>pplication
/manifest

iOS

iOS-এ ক্র্যাশ রিপোর্ট বন্ধ করতে DisableSDKCrashReporting মেথড কল করুন:

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

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

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

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

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

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

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