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 ) इस CustomTabsSession में विज्ञापनों से कमाई करने के लिए, Google Mobile Ads SDK के साथ CustomTabsClient को रजिस्टर करता है.
static void	registerWebView(@NonNull WebView webview) इस WebView में विज्ञापनों से कमाई करने के लिए, Google Mobile Ads SDK के साथ WebView को रजिस्टर करता है.
static void	setAppMuted(boolean muted) इससे पता चलता है कि ऐप्लिकेशन का ऑडियो म्यूट है या नहीं.
static void	setAppVolume(float volume) ऐप्लिकेशन के ऑडियो वॉल्यूम को सेट करता है.
static void	setRequestConfiguration(     @NonNull RequestConfiguration requestConfiguration ) यह वैश्विक RequestConfiguration सेट करता है, जिसका इस्तेमाल ऐप्लिकेशन के सेशन के दौरान हर AdRequest के लिए किया जाएगा.
static void	startPreload(     @NonNull Context context,     @NonNull List<PreloadConfiguration> preloadConfigurations,     @NonNull PreloadCallback preloadCallback ) दिए गए कॉन्फ़िगरेशन के लिए, विज्ञापनों को पहले से लोड करना शुरू करता है.

कॉन्स्टेंट

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	SDK टूल जिस Context में चल रहा है.

शुरू करना

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

अगर इस तरीके को कॉल नहीं किया जाता है, तो पहला विज्ञापन अनुरोध, 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	अगर पब्लिशर का पहले पक्ष का आईडी चालू है, तो बूलियन true और अगर नहीं है, तो false.

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

registerCustomTabsSession

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

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

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

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

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

startPreload

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

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

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

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