MobileAds
क्लास, Google Mobile Ads SDK के लिए ग्लोबल सेटिंग उपलब्ध कराती है.
Unity के मुख्य थ्रेड पर विज्ञापन इवेंट बढ़ाना
Google Mobile Ads SDK, Unity के मुख्य थ्रेड के बजाय किसी दूसरे थ्रेड पर इवेंट जनरेट करता है. अगर आपने विज्ञापन इवेंट लागू किए हैं और Unity ऑब्जेक्ट के साथ इंटरैक्ट किया है, तो आपको Mobile Ads SDK इवेंट को Unity के मुख्य थ्रेड के साथ सिंक करना होगा.
विज्ञापन इवेंट को Unity की मुख्य थ्रेड के साथ मैन्युअल तरीके से या अपने-आप सिंक करें. इसके लिए, Google Mobile Ads SDK को सिंक करने की अनुमति दें.
विज्ञापन इवेंट को मैन्युअल तरीके से सिंक करना
विज्ञापन इवेंट सिंक करने के लिए, मुख्य थ्रेड पर ExecuteInUpdate
तरीके का इस्तेमाल मैन्युअल तरीके से करें. इस तरीके का इस्तेमाल तब करना ज़रूरी है, जब RaiseAdEventsOnUnityMainThread
प्रॉपर्टी बंद हो और UnityEngine ऑब्जेक्ट के साथ इंटरैक्ट करती हो.
यहां दिए गए उदाहरण में, बैकग्राउंड थ्रेड को लॉग किया गया है. साथ ही, UnityEngine ऑब्जेक्ट के साथ इंटरैक्ट करने के लिए एक ऐक्शन चलाया गया है:
rewardedAd.OnAdPaid += (AdValue value) =>
{
// Log the ad value immediately.
UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");
MobileAdsEventExecutor.ExecuteInUpdate(() =>
{
// Interact with UnityEngine objects here.
});
};
विज्ञापन इवेंट के आधार पर सिंक करने की प्रोसेस को ऑटोमेट करना
विज्ञापन इवेंट सिंक करने के लिए, Google Mobile Ads SDK के लिए 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 SDK को ऐप्लिकेशन के वॉल्यूम की जानकारी देने से, वीडियो विज्ञापनों में ऐप्लिकेशन के वॉल्यूम की सेटिंग लागू की जा सकती है. इससे यह पक्का होता है कि उपयोगकर्ताओं को वीडियो विज्ञापन, उम्मीद के मुताबिक ऑडियो वॉल्यूम के साथ दिखें.
डिवाइस का वॉल्यूम, आवाज़ कम या ज़्यादा करने वाले बटन या ओएस-लेवल के वॉल्यूम स्लाइडर से कंट्रोल किया जाता है. इससे डिवाइस के ऑडियो आउटपुट का वॉल्यूम तय होता है. हालांकि, ऐप्लिकेशन अपने हिसाब से डिवाइस के वॉल्यूम के मुकाबले वॉल्यूम लेवल को कम या ज़्यादा कर सकते हैं, ताकि ऑडियो का अनुभव बेहतर बनाया जा सके.
विज्ञापन लोड करने से पहले, SetApplicationVolume()
तरीके को कॉल करके, Google Mobile Ads SDK को ऐप्लिकेशन के वॉल्यूम के बारे में बताया जा सकता है. विज्ञापन की आवाज़ की मान्य वैल्यू, 0.0
(बिना आवाज़) से लेकर 1.0
(डिवाइस की मौजूदा आवाज़) तक होती हैं. यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि एसडीके को ऐप्लिकेशन के वॉल्यूम की जानकारी कैसे दी जाती है:
// 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 (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);
Android ऐप्लिकेशन के कोड को छोटा करना
Unity के इस पब्लिशिंग विकल्प की मदद से, Java कोड को छोटा करने की सुविधा चालू की जा सकती है. अगर आपने कोड छोटा करने की सुविधा चालू की है, तो आपको एक कस्टम प्रोगार्ड फ़ाइल भी बनानी होगी, ताकि एसडीके से रेफ़र की गई क्लास को सेव रखा जा सके.
कस्टम Proguard फ़ाइल चालू करें
प्रोजेक्ट सेटिंग > प्लेयर > Android > पब्लिश करने की सेटिंग > बिल्ड पर जाएं और इनमें से कोई एक विकल्प चुनें:
- कस्टम Proguard फ़ाइल
/Assets/Plugins/Android/proguard-user.txt
खोलें और यह जोड़ें:
-keep class com.google.** { public *; }
क्रैश होने की रिपोर्ट करने की सुविधा बंद करना
Google Mobile Ads SDK, डीबग करने और विश्लेषण करने के लिए क्रैश रिपोर्ट इकट्ठा करता है. इस क्रैश रिपोर्टिंग को नीचे दिए गए कोड की मदद से बंद किया जा सकता है. यहां दिए गए सेक्शन में, Android और iOS पर क्रैश रिपोर्टिंग की सुविधा बंद करने का तरीका बताया गया है.
Android
अपने ऐप्लिकेशन की AndroidManifest.xml
फ़ाइल में, <meta-data>
टैग जोड़ें. साथ ही, DISABLE_CRASH_REPORTING
को true
पर सेट करें:
<manifest>
<application>
<meta-data
android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
android:value="true" />
</application>
</manifest>
iOS
iOS पर क्रैश रिपोर्ट बंद करने के लिए, DisableSDKCrashReporting
वाले तरीके को कॉल करें:
void Awake() {
MobileAds.DisableSDKCrashReporting();
}
Unity प्लगिन का वर्शन पाना
Unity SDK टूल का वर्शन पाने के लिए, यह कमांड चलाएं:
// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());
प्लैटफ़ॉर्म का वर्शन पाना
Unity के लिए Google Mobile Ads SDK, Android और iOS प्लैटफ़ॉर्म SDK पर निर्भर करता है. प्लैटफ़ॉर्म SDK टूल का वर्शन पाने के लिए, यह कमांड चलाएं:
// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());