MobileAds

class MobileAds


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

खास जानकारी

कॉन्स्टेंट

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

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

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

java-static Unit

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

java-static InitializationStatus?

SDK टूल शुरू करने का स्टेटस दिखाता है.

java-static RequestConfiguration

ग्लोबल RequestConfiguration की जानकारी मिलती है.

java-static VersionInfo!

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

Google Mobile Ads SDK को शुरू करता है.

java-static Unit

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

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

इससे डीबग मेन्यू खुलता है.

java-static Boolean

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

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

इस CustomTabsSession में विज्ञापनों से होने वाली कमाई को बेहतर बनाने के लिए, Google Mobile Ads SDK के साथ CustomTabsClient को रजिस्टर करता है.

java-static Unit

इस WebView में विज्ञापनों से होने वाली कमाई को बेहतर बनाने के लिए, Google Mobile Ads SDK के साथ WebView को रजिस्टर करता है.

java-static Unit

इससे पता चलता है कि ऐप्लिकेशन का ऑडियो म्यूट है या नहीं.

java-static Unit

ऐप्लिकेशन के ऑडियो वॉल्यूम को सेट करता है.

java-static Unit

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

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!

SDK टूल जिस Context में चल रहा है.

शुरू करना

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

Google Mobile Ads SDK को शुरू करता है.

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

अगर इस तरीके को नहीं बुलाया जाता है, तो पहला विज्ञापन अनुरोध, 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

अगर पब्लिशर का पहले पक्ष का आईडी चालू है, तो बूलियन true है. अगर नहीं, तो false है.

रिटर्न
Boolean

अगर फ़ैसला सेव हो जाता है, तो true. अगर यह सेव नहीं हो पाता है, तो 'गलत है'.

registerCustomTabsSession

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

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

पैरामीटर
context: Context

SDK टूल जिस Context में चल रहा है.

client: CustomTabsClient

CustomTabsClient का इस्तेमाल CustomTabsSession इंस्टेंस बनाने के लिए किया जाता है.

origin: String

पुष्टि के लिए, Digital Asset Link पर ऑरिजिन के तौर पर इस्तेमाल की जाने वाली स्ट्रिंग.

callback: CustomTabsCallback?

CustomTabsCallback से कॉलबैक पाने के लिए, यह जानकारी देना ज़रूरी नहीं है .

रिटर्न
CustomTabsSession?

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

registerWebView

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

इस WebView में विज्ञापनों से होने वाली कमाई को बेहतर बनाने के लिए, Google Mobile Ads SDK के साथ 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

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

startPreload

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

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

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

पैरामीटर
context: Context

SDK टूल जिस Context में चल रहा है.

preloadConfigurations: (Mutable)List<PreloadConfiguration!>

विज्ञापनों को पहले से लोड करने के लिए कॉन्फ़िगरेशन.

preloadCallback: PreloadCallback

हर प्रीलोड कॉन्फ़िगरेशन के लिए, विज्ञापन की उपलब्धता में बदलाव होने पर कॉलबैक ट्रिगर किया जाएगा.