ग्लोबल सेटिंग

प्लैटफ़ॉर्म चुनें: Android (बीटा वर्शन) Android iOS Unity

MobileAds क्लास, Google Mobile Ads Unity Plugin के लिए ग्लोबल सेटिंग उपलब्ध कराता है.

Unity के मुख्य थ्रेड पर विज्ञापन इवेंट बढ़ाना

Google Mobile Ads Unity Plugin, Unity के मुख्य थ्रेड के बजाय किसी दूसरे थ्रेड पर इवेंट जनरेट करता है. अगर आपने विज्ञापन इवेंट लागू किए हैं और Unity ऑब्जेक्ट के साथ इंटरैक्ट किया है, तो आपको Google Mobile Ads Unity Plugin इवेंट को Unity के मुख्य थ्रेड के साथ सिंक करना होगा.

विज्ञापन इवेंट को Unity के मुख्य थ्रेड के साथ मैन्युअल तरीके से या अपने-आप सिंक करें. इसके लिए, Google Mobile Ads Unity Plugin को सिंक करने की अनुमति दें.

सुझाया गया: विज्ञापन इवेंट को मैन्युअल तरीके से सिंक करें

विज्ञापन इवेंट को मैन्युअल तरीके से सिंक करने के लिए, मुख्य थ्रेड पर ExecuteInUpdate तरीके का इस्तेमाल करें. UnityEngine ऑब्जेक्ट के साथ इंटरैक्ट करते समय, आपको ExecuteInUpdate मेथड का इस्तेमाल करना होगा. साथ ही, RaiseAdEventsOnUnityMainThread प्रॉपर्टी के बंद होने पर भी आपको इस मेथड का इस्तेमाल करना होगा.

यहां दिए गए उदाहरण में, बैकग्राउंड थ्रेड को लॉग किया गया है. साथ ही, UnityEngine ऑब्जेक्ट के साथ इंटरैक्ट करने के लिए एक ऐक्शन चलाया गया है:

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    // Place all time-sensitive code outside of ExecuteInUpdate().
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
        // This method is delayed, don't put time sensitive code here.
    });
};

विज्ञापन इवेंट के आधार पर सिंक करने की प्रोसेस को ऑटोमेट करना

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 को ऐप्लिकेशन के वॉल्यूम की जानकारी देने से, वीडियो विज्ञापनों में ऐप्लिकेशन के वॉल्यूम की सेटिंग लागू की जा सकती हैं. इससे यह पक्का होता है कि उपयोगकर्ताओं को वीडियो विज्ञापन, उम्मीद के मुताबिक ऑडियो वॉल्यूम के साथ दिखें.

डिवाइस का वॉल्यूम, आवाज़ कम या ज़्यादा करने वाले बटन या ओएस-लेवल के वॉल्यूम स्लाइडर से कंट्रोल किया जाता है. इससे डिवाइस के ऑडियो आउटपुट का वॉल्यूम तय होता है. हालांकि, ऐप्लिकेशन ऑडियो के अनुभव को बेहतर बनाने के लिए, डिवाइस के वॉल्यूम के हिसाब से वॉल्यूम लेवल को अलग-अलग तरीके से कम या ज़्यादा कर सकते हैं.

विज्ञापन लोड करने से पहले, SetApplicationVolume() तरीके को कॉल करके, Google Mobile Ads Unity Plugin को ऐप्लिकेशन के वॉल्यूम के बारे में सूचना दी जा सकती है. विज्ञापन की आवाज़ की मान्य वैल्यू, 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
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Android ऐप्लिकेशन को छोटा करना

Unity के इस पब्लिशिंग विकल्प की मदद से, Java कोड को छोटा करने की सुविधा चालू की जा सकती है. अगर आपने कोड छोटा करने की सुविधा चालू की है, तो आपको एक कस्टम प्रोगार्ड फ़ाइल भी बनानी होगी, ताकि एसडीके से रेफ़र की गई क्लास को सेव रखा जा सके.

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 प्लगिन, Android और iOS प्लैटफ़ॉर्म के SDK टूल पर निर्भर करता है. प्लैटफ़ॉर्म SDK टूल का वर्शन पाने के लिए, यह कमांड चलाएं:

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