MobileAds

Kotlin |Java

class MobileAds

इस क्लास में ऐसा लॉजिक होता है जो Google Mobile Ads SDK पर पूरी तरह से लागू होता है. फ़िलहाल, इसमें मौजूद तरीकों का इस्तेमाल सिर्फ़ शुरुआत में किया जाता है.

खास जानकारी

कॉन्स्टेंट
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Google Mobile Ads SDK के लिए, गड़बड़ी के डिफ़ॉल्ट डोमेन का नाम.

सार्वजनिक फ़ंक्शन
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` मीडिएशन अडैप्टर के इनिशियलाइज़ेशन को बंद करने के लिए, `initialize` या पहले विज्ञापन अनुरोध से पहले कॉल करें.
`java-static InitializationStatus?`	`getInitializationStatus()` SDK टूल के शुरू होने की स्थिति पता करता है.
`java-static RequestConfiguration`	`getRequestConfiguration()` यह कुकी, ग्लोबल `RequestConfiguration` को सेट करती है.
`java-static VersionInfo!`	`getVersion()` Google Mobile Ads SDK का बाहरी वर्शन (उदाहरण के लिए, 20.6.0) मिलता है.
`java-static Unit`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(context: Context!)` यह कुकी, Google Mobile Ads SDK को चालू करती है.
`java-static Unit`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` यह कुकी, Google Mobile Ads SDK को चालू करती है.
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` विज्ञापन जांचने वाले टूल का यूज़र इंटरफ़ेस (यूआई) खुलता है.
`java-static Unit`	`openDebugMenu(context: Context!, adUnitId: String!)` इससे डीबग मेन्यू खुलता है.
`java-static Boolean`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` इससे यह कंट्रोल किया जाता है कि Google Mobile Ads SDK पब्लिशर के पहले पक्ष का आईडी चालू है या नहीं. पहले इसे एक जैसी ऐप्लिकेशन कुंजी के नाम से जाना जाता था.
`java-static CustomTabsSession?`	`registerCustomTabsSession( context: Context, client: CustomTabsClient, origin: String, callback: CustomTabsCallback? )` यह कुकी, Google Mobile Ads SDK के साथ `CustomTabsClient` को रजिस्टर करती है, ताकि इस `CustomTabsSession` में मौजूद विज्ञापनों से ऐप्लिकेशन में विज्ञापन दिखाने से मिलने वाले रेवेन्यू को बढ़ाया जा सके.
`java-static Unit`	`registerWebView(webview: WebView)` यह कुकी, Google Mobile Ads SDK के साथ `WebView` को रजिस्टर करती है, ताकि इस `WebView` में मौजूद विज्ञापनों से ऐप्लिकेशन में विज्ञापन दिखाने से मिलने वाले रेवेन्यू को बढ़ाया जा सके.
`java-static Unit`	`setAppMuted(muted: Boolean)` इससे पता चलता है कि ऐप्लिकेशन का ऑडियो म्यूट किया गया है या नहीं.
`java-static Unit`	`setAppVolume(volume: Float)` इससे ऐप्लिकेशन के ऑडियो का वॉल्यूम सेट किया जाता है.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` यह ऐप्लिकेशन के सेशन के दौरान, हर `AdRequest` के लिए इस्तेमाल किया जाने वाला ग्लोबल `RequestConfiguration` सेट करता है.
`java-static Unit`	`startPreload( context: Context, preloadConfigurations: (Mutable)List<PreloadConfiguration!>, preloadCallback: PreloadCallback )` इस फ़ंक्शन का इस्तेमाल बंद कर दिया गया है. इसके बजाय, `start` या `start` का इस्तेमाल करें.

कॉन्स्टेंट

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

Google Mobile Ads SDK के लिए, गड़बड़ी के डिफ़ॉल्ट डोमेन का नाम.

सार्वजनिक फ़ंक्शन

disableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

मीडिएशन अडैप्टर के इनिशियलाइज़ेशन को बंद करने के लिए, initialize या पहले विज्ञापन अनुरोध से पहले कॉल करें. initialize या पहला विज्ञापन अनुरोध किए जाने के बाद, इस तरीके का इस्तेमाल नहीं किया जा सकता.

चेतावनी: इस तरीके को कॉल करने से, आपकी मीडिएशन परफ़ॉर्मेंस पर बुरा असर पड़ सकता है. इस तरीके का इस्तेमाल सिर्फ़ तब किया जाना चाहिए, जब आपने अपने ऐप्लिकेशन में मीडिएशन अडैप्टर शामिल किए हों, लेकिन आपको इस ऐप्लिकेशन सेशन के दौरान Google मीडिएशन का इस्तेमाल नहीं करना हो. उदाहरण के लिए, A/B टेस्ट किया जा रहा हो.

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

SDK टूल के शुरू होने की स्थिति पता करता है.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

यह कुकी, ग्लोबल RequestConfiguration को सेट करती है.

getVersion

java-static fun getVersion(): VersionInfo!

Google Mobile Ads SDK का बाहरी वर्शन (उदाहरण के लिए, 20.6.0) मिलता है.

इस फ़ंक्शन से पहले, initialize को कॉल करने की ज़रूरत नहीं है.

शुरू करें

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

यह कुकी, Google Mobile Ads SDK को चालू करती है.

ऐप्लिकेशन लॉन्च होने के बाद, इस तरीके को जल्द से जल्द कॉल करें, ताकि सेशन के पहले विज्ञापन अनुरोध के लिए इंतज़ार का समय कम हो सके.

अगर इस तरीके का इस्तेमाल नहीं किया जाता है, तो विज्ञापन के पहले अनुरोध पर Google Mobile Ads SDK अपने-आप शुरू हो जाता है.

पैरामीटर
`context: Context!`	वह `Context` जिसमें एसडीके टूल चल रहा है.

शुरू करें

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

यह कुकी, Google Mobile Ads SDK को चालू करती है.

पैरामीटर
`context: Context!`	वह गतिविधि `Context` जिसमें SDK टूल चल रहा है.
`listener: OnInitializationCompleteListener!`	शुरू होने की प्रोसेस पूरी होने पर, इस कॉलबैक को शुरू किया जाएगा.

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

विज्ञापन जांचने वाले टूल का यूज़र इंटरफ़ेस (यूआई) खुलता है.

openDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

इससे डीबग मेन्यू खुलता है. इस फ़ंक्शन से पहले initialize को कॉल किया जाना चाहिए.

पैरामीटर
`context: Context!`	वह गतिविधि `Context` जिसमें SDK टूल चल रहा है.
`adUnitId: String!`	आपके ऐप्लिकेशन से जुड़ा कोई भी Ad Manager विज्ञापन यूनिट आईडी.

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

इससे यह कंट्रोल किया जाता है कि Google Mobile Ads SDK पब्लिशर के पहले पक्ष का आईडी चालू है या नहीं. पहले इसे एक जैसी ऐप्लिकेशन कुंजी के नाम से जाना जाता था.

आईडी, डिफ़ॉल्ट रूप से चालू होता है. इस सेटिंग को बंद करने पर, यह ऐप्लिकेशन के सभी सेशन में बनी रहती है और आईडी मिट जाता है.

इस फ़ंक्शन से पहले initialize को कॉल किया जाना चाहिए.

पैरामीटर
`enabled: Boolean`	अगर पब्लिशर के पहले पक्ष का आईडी चालू है, तो बूलियन वैल्यू सही होगी. अगर ऐसा नहीं है, तो बूलियन वैल्यू गलत होगी.

रिटर्न
`Boolean`	अगर फ़ैसले को सेव कर लिया गया है, तो यह वैल्यू सही होती है. अगर इसे सेव नहीं किया जा सका, तो इसकी वैल्यू 'गलत है' होगी.

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

यह कुकी, Google Mobile Ads SDK के साथ CustomTabsClient को रजिस्टर करती है, ताकि इस CustomTabsSession में मौजूद विज्ञापनों से ऐप्लिकेशन में विज्ञापन दिखाने से मिलने वाले रेवेन्यू को बढ़ाया जा सके. इससे सिर्फ़ CustomTabsSession का एक इंस्टेंस बनेगा. इसे फिर से चलाने पर, मौजूदा सेशन बदल जाएगा.

पैरामीटर
`context: Context`	वह `Context` जिसमें एसडीके टूल चल रहा है.
`client: CustomTabsClient`	`CustomTabsSession` इंस्टेंस बनाने के लिए इस्तेमाल किया गया `CustomTabsClient`.
`origin: String`	पुष्टि के लिए, Digital Asset Link पर ओरिजन के तौर पर इस्तेमाल की गई स्ट्रिंग.
`callback: CustomTabsCallback?`	`CustomTabsSession` से कॉलबैक पाने के लिए, `CustomTabsCallback` की जानकारी देना ज़रूरी नहीं है.

रिटर्न
`CustomTabsSession?`	कस्टम टैब पेज खोलने पर, Custom Tabs Intent के लिए इस्तेमाल किया जाने वाला `CustomTabsSession` इंस्टेंस.

registerWebView

java-static fun registerWebView(webview: WebView): Unit

यह कुकी, Google Mobile Ads SDK के साथ WebView को रजिस्टर करती है, ताकि इस WebView में मौजूद विज्ञापनों से ऐप्लिकेशन में विज्ञापन दिखाने से मिलने वाले रेवेन्यू को बढ़ाया जा सके.

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

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

चेतावनी: ऐप्लिकेशन को म्यूट करने से, वीडियो विज्ञापन दिखाने की ज़रूरी शर्तें पूरी नहीं हो पाती हैं. इससे आपके ऐप्लिकेशन से मिलने वाले विज्ञापन रेवेन्यू में कमी आ सकती है. आपको इस एपीआई का इस्तेमाल सिर्फ़ तब करना चाहिए, जब आपका ऐप्लिकेशन उपयोगकर्ता को म्यूट करने का कस्टम कंट्रोल देता हो. साथ ही, आपको इस एपीआई में उपयोगकर्ता के म्यूट करने के फ़ैसले को दिखाना चाहिए.

पैरामीटर
`muted: Boolean`	अगर ऐप्लिकेशन म्यूट है, तो वैल्यू true होगी. अगर ऐसा नहीं है, तो वैल्यू false होगी. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होती है.

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

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

चेतावनी: ऐप्लिकेशन के ऑडियो वॉल्यूम को कम करने से, वीडियो विज्ञापन दिखाने की ज़रूरी शर्तें पूरी नहीं होती हैं. इससे आपके ऐप्लिकेशन के विज्ञापन रेवेन्यू में भी कमी आ सकती है. आपको इस एपीआई का इस्तेमाल सिर्फ़ तब करना चाहिए, जब आपका ऐप्लिकेशन उपयोगकर्ता को वॉल्यूम कंट्रोल करने की सुविधा देता हो. साथ ही, आपको इस एपीआई में उपयोगकर्ता की चुनी गई वॉल्यूम सेटिंग दिखानी चाहिए.

पैरामीटर
`volume: Float`	वॉल्यूम को फ़्लोट के तौर पर सेट किया जाता है. इसकी वैल्यू 0 (म्यूट) से लेकर 1.0 (मीडिया का पूरा वॉल्यूम) तक होती है. डिफ़ॉल्ट वैल्यू 1.0 होती है

थ्रो
`java.lang.IllegalArgumentException`	अगर वॉल्यूम मान्य सीमा से बाहर है

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

यह ऐप्लिकेशन के सेशन के दौरान, हर AdRequest के लिए इस्तेमाल किया जाने वाला ग्लोबल RequestConfiguration सेट करता है.

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

यह फ़ंक्शन, दिए गए कॉन्फ़िगरेशन के लिए विज्ञापनों को पहले से लोड करना शुरू करता है.

विज्ञापन प्रीलोड करने वाले एपीआई, फ़िलहाल ऐल्फ़ा वर्शन में उपलब्ध हैं. ज़्यादा जानकारी के लिए, कृपया अपने खाता मैनेजर से संपर्क करें.

पैरामीटर
`context: Context`	वह `Context` जिसमें एसडीके टूल चल रहा है.
`preloadConfigurations: (Mutable)List<PreloadConfiguration!>`	विज्ञापनों को पहले से लोड करने के लिए कॉन्फ़िगरेशन.
`preloadCallback: PreloadCallback`	हर प्रीलोड कॉन्फ़िगरेशन के लिए, विज्ञापन की उपलब्धता में बदलाव होने पर इस कॉलबैक को शुरू किया जाएगा.