MobileAds

Kotlin |Java

public class MobileAds

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

खास जानकारी

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

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

कॉन्स्टेंट

ERROR_DOMAIN

public static final String ERROR_DOMAIN = "com.google.android.gms.ads"

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

सार्वजानिक तरीके

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

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

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

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

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

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

getVersion

public static VersionInfo getVersion()

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

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

शुरू करें

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

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

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

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

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

शुरू करें

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

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

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

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

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

registerCustomTabsSession

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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

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

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

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

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

setAppVolume

public static void setAppVolume(float volume)

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

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

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

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

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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

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

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