MobileAds

Kotlin |Java

class MobileAds

Die Klasse enthält Logik, die für das Google Mobile Ads SDK als Ganzes gilt. Derzeit werden darin nur Methoden für die Initialisierung verwendet.

Zusammenfassung

Konstanten
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Standardmäßiger Fehlerdomainname für das Google Mobile Ads SDK.

Öffentliche Funktionen
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` Rufen Sie die Methode vor `initialize` oder der ersten Anzeigenanfrage auf, um die Initialisierung des Vermittlungsadapters zu deaktivieren.
`java-static InitializationStatus?`	`getInitializationStatus()` Ruft den SDK-Initialisierungsstatus ab.
`java-static RequestConfiguration`	`getRequestConfiguration()` Ruft die globale `RequestConfiguration` ab.
`java-static VersionInfo!`	`getVersion()` Ruft die externe Version (z. B. 20.6.0) des Google Mobile Ads SDK ab.
`java-static Unit`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(context: Context!)` Initialisiert das Google Mobile Ads SDK.
`java-static Unit`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` Initialisiert das Google Mobile Ads SDK.
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` Öffnet die Benutzeroberfläche des Anzeigeninspektors.
`java-static Unit`	`openDebugMenu(context: Context!, adUnitId: String!)` Öffnet das Debug-Menü.
`java-static Boolean`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` Legt fest, ob die eigene Publisher-ID des Google Mobile Ads SDKs (früher „App-interner Schlüssel“ (SameAppKey)) aktiviert ist.
`java-static CustomTabsSession?`	`registerCustomTabsSession( context: Context, client: CustomTabsClient, origin: String, callback: CustomTabsCallback? )` Registriert ein `CustomTabsClient` beim Google Mobile Ads SDK, um die In-App-Monetarisierung von Anzeigen in diesem `CustomTabsSession` zu verbessern.
`java-static Unit`	`registerWebView(webview: WebView)` Registriert ein `WebView` beim Google Mobile Ads SDK, um die In-App-Monetarisierung von Anzeigen in diesem `WebView` zu verbessern.
`java-static Unit`	`setAppMuted(muted: Boolean)` Gibt an, ob der Ton der Anwendung stummgeschaltet ist.
`java-static Unit`	`setAppVolume(volume: Float)` Legt die Audiolautstärke der Anwendung fest.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` Legt die globale `RequestConfiguration` fest, die für jedes `AdRequest` während der Sitzung der App verwendet wird.
`java-static Unit`	`startPreload( context: Context, preloadConfigurations: (Mutable)List<PreloadConfiguration!>, preloadCallback: PreloadCallback )` Diese Funktion wurde eingestellt. Verwende stattdessen `start` oder `start`.

Konstanten

ERROR_DOMAIN

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

Standardmäßiger Fehlerdomainname für das Google Mobile Ads SDK.

Öffentliche Funktionen

disableMediationAdapterInitialization

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

Rufen Sie die Methode vor initialize oder der ersten Anzeigenanfrage auf, um die Initialisierung des Vermittlungsadapters zu deaktivieren. Diese Methode ist ein No-Op, sobald initialize oder die erste Anzeigenanfrage erfolgt ist.

Warnung: Das Aufrufen dieser Methode kann sich negativ auf die Vermittlungsleistung auswirken. Diese Methode sollte nur aufgerufen werden, wenn Sie Vermittlungsadapter in Ihre App einbinden, aber während dieser App-Sitzung keine Google-Vermittlung verwenden möchten (z. B. wenn Sie einen A/B-Test durchführen).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

Ruft den SDK-Initialisierungsstatus ab.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Ruft die globale RequestConfiguration ab.

getVersion

java-static fun getVersion(): VersionInfo!

Ruft die externe Version (z. B. 20.6.0) des Google Mobile Ads SDK ab.

initialize muss nicht vor dieser Funktion aufgerufen werden.

initialize

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

Initialisiert das Google Mobile Ads SDK.

Rufen Sie diese Methode so früh wie möglich nach dem Start der App auf, um die Latenz bei der ersten Anzeigenanfrage der Sitzung zu reduzieren.

Wenn diese Methode nicht aufgerufen wird, wird das Google Mobile Ads SDK automatisch bei der ersten Anzeigenanfrage initialisiert.

Parameter
`context: Context!`	Die `Context`, in der das SDK ausgeführt wird.

initialize

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

Initialisiert das Google Mobile Ads SDK.

Rufen Sie diese Methode so früh wie möglich nach dem Start der App auf, um die Latenz bei der ersten Anzeigenanfrage der Sitzung zu reduzieren.

Wenn diese Methode nicht aufgerufen wird, wird das Google Mobile Ads SDK automatisch bei der ersten Anzeigenanfrage initialisiert.

Parameter
`context: Context!`	Die Aktivität, in der das SDK ausgeführt wird.`Context`
`listener: OnInitializationCompleteListener!`	Ein Callback, der nach Abschluss der Initialisierung aufgerufen werden soll.

openAdInspector

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

Öffnet die Benutzeroberfläche des Anzeigeninspektors.

openDebugMenu

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

Öffnet das Debug-Menü. initialize muss vor dieser Funktion aufgerufen werden.

Parameter
`context: Context!`	Die Aktivität, in der das SDK ausgeführt wird.`Context`
`adUnitId: String!`	Alle Ad Manager-Anzeigenblock-IDs, die mit Ihrer App verknüpft sind.

putPublisherFirstPartyIdEnabled

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

Legt fest, ob die eigene Publisher-ID des Google Mobile Ads SDKs (früher „App-interner Schlüssel“ (SameAppKey)) aktiviert ist.

Die ID ist standardmäßig aktiviert. Wenn die Einstellung deaktiviert ist, wird sie sitzungsübergreifend beibehalten und die ID wird gelöscht.

initialize muss vor dieser Funktion aufgerufen werden.

Parameter
`enabled: Boolean`	Boolescher Wert, der „true“ ist, wenn die eigene Publisher-ID aktiviert ist, andernfalls „false“.

Ausgabe
`Boolean`	„true“, wenn die Entscheidung erfolgreich gespeichert wurde. „False“, wenn die Speicherung fehlschlägt.

registerCustomTabsSession

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

Registriert ein CustomTabsClient beim Google Mobile Ads SDK, um die In-App-Monetarisierung von Anzeigen in diesem CustomTabsSession zu verbessern. Dadurch wird nur eine Instanz von CustomTabsSession erstellt und durch erneutes Ausführen wird die vorhandene Sitzung überschrieben.

Parameter
`context: Context`	Die `Context`, in der das SDK ausgeführt wird.
`client: CustomTabsClient`	`CustomTabsClient`, die zum Erstellen der `CustomTabsSession`-Instanz verwendet wird.
`origin: String`	String, der als Ursprung im Digital Asset Link zur Überprüfung verwendet wird.
`callback: CustomTabsCallback?`	Optionale `CustomTabsCallback`, um Rückrufe von `CustomTabsSession` zu erhalten.

Ausgabe
`CustomTabsSession?`	`CustomTabsSession`-Instanz, die für den Custom Tabs-Intent beim Öffnen einer Custom Tabs-Seite verwendet werden soll.

registerWebView

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

Registriert ein WebView beim Google Mobile Ads SDK, um die In-App-Monetarisierung von Anzeigen in diesem WebView zu verbessern.

setAppMuted

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

Gibt an, ob der Ton der Anwendung stummgeschaltet ist. Wirkt sich auf den anfänglichen Stummschaltungsstatus aller Anzeigen aus.

Warnung: Wenn Sie Ihre Anwendung stummschalten, können weniger Videoanzeigen ausgeliefert werden. Das kann sich auf den Umsatz aus Anzeigen in Ihrer App auswirken. Sie sollten diese API nur verwenden, wenn Ihre App dem Nutzer eine benutzerdefinierte Stummschaltungsfunktion bietet. Die Entscheidung des Nutzers zur Stummschaltung sollte in dieser API berücksichtigt werden.

Parameter
`muted: Boolean`	„true“, wenn die App stummgeschaltet ist, andernfalls „false“. Die Standardeinstellung ist "false".

setAppVolume

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

Legt die Audiolautstärke der Anwendung fest. Wirkt sich auf die Lautstärke aller Anzeigen im Verhältnis zu anderen Audioausgaben aus.

Warnung: Wenn Sie die Lautstärke Ihrer App verringern, können weniger Videoanzeigen ausgeliefert werden und Ihre Werbeeinnahmen sinken möglicherweise. Sie sollten diese API nur verwenden, wenn Ihre App dem Nutzer benutzerdefinierte Lautstärkeregler zur Verfügung stellt. Die Lautstärke, die der Nutzer auswählt, sollte in dieser API berücksichtigt werden.

Parameter
`volume: Float`	Die Lautstärke als Gleitkommazahl von 0 (stumm) bis 1,0 (volle Medienlautstärke). Der Standardwert ist 1,0.

Löst
`java.lang.IllegalArgumentException`	wenn das Volumen außerhalb des gültigen Bereichs liegt

setRequestConfiguration

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

Legt die globale RequestConfiguration fest, die für jedes AdRequest während der Sitzung der App verwendet wird.

startPreload

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

Beginnt mit dem Vorabladen von Anzeigen für die angegebenen Konfigurationen.

APIs zum Vorabladen von Anzeigen befinden sich in einer eingeschränkten Alphaphase. Weitere Informationen erhalten Sie von Ihrem Account Manager.

Parameter
`context: Context`	Die `Context`, in der das SDK ausgeführt wird.
`preloadConfigurations: (Mutable)List<PreloadConfiguration!>`	Die Konfigurationen zum Vorabladen von Anzeigen.
`preloadCallback: PreloadCallback`	Ein Callback, der aufgerufen wird, wenn sich die Anzeigenverfügbarkeit für jede Preload-Konfiguration ändert.