MobileAds

class MobileAds

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

Zusammenfassung

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

Standard-Fehlerdomainname für das Google Mobile Ads SDK.

Öffentliche Funktionen
java-static Unit

Rufen Sie die Funktion vor initialize oder vor der ersten Anzeigenanfrage auf, um die Initialisierung des Mediation-Adapters zu deaktivieren.
java-static InitializationStatus?

Ruft den Initialisierungsstatus des SDK ab.
java-static RequestConfiguration

Ruft den globalen RequestConfiguration ab.
java-static VersionInfo!

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!)

Hiermit wird das Google Mobile Ads SDK initialisiert.
java-static Unit

Hiermit wird das Google Mobile Ads SDK initialisiert.
java-static Unit

Öffnet die Benutzeroberfläche des Anzeigenprüftools.
java-static Unit
openDebugMenu(context: Context!, adUnitId: String!)

Öffnet das Debug-Menü.
java-static Boolean

Hiermit wird festgelegt, ob die eigene Publisher-ID des Google Mobile Ads SDK (früher „App-interner Schlüssel“) aktiviert ist.
java-static CustomTabsSession?
registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
)

Registriert eine CustomTabsClient beim Google Mobile Ads SDK, um die In-App-Werbemonetarisierung von Anzeigen in dieser CustomTabsSession zu verbessern.
java-static Unit

Registriert eine WebView beim Google Mobile Ads SDK, um die In-App-Werbemonetarisierung von Anzeigen in dieser WebView zu verbessern.
java-static Unit

Gibt an, ob der Ton der Anwendung stummgeschaltet ist.
java-static Unit

Hiermit wird die Audiolautstärke der Anwendung festgelegt.
java-static Unit

Legt den globalen RequestConfiguration fest, der während der Sitzung der App für jeden AdRequest verwendet wird.
java-static Unit
startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
)

Diese Funktion wird nicht mehr unterstützt.

Verwenden Sie stattdessen „start“ oder „starten“.

Konstanten

ERROR_DOMAIN

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

Standard-Fehlerdomainname für das Google Mobile Ads SDK.

Öffentliche Funktionen

disableMediationAdapterInitialization

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

Rufen Sie die Funktion vor initialize oder vor der ersten Anzeigenanfrage auf, um die Initialisierung des Mediation-Adapters zu deaktivieren. Diese Methode ist wirkungslos, sobald initialize oder die erste Anzeigenanfrage gesendet wurde.

Achtung: 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 nicht beabsichtigen, während dieser App-Sitzung die Google-Vermittlung zu verwenden (z. B. wenn Sie einen A/B-Test durchführen).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

Ruft den Initialisierungsstatus des SDK ab.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Ruft den globalen 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 vor dieser Funktion nicht aufgerufen werden.

initialize

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

Hiermit wird das Google Mobile Ads SDK initialisiert.

Rufen Sie diese Methode möglichst früh 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

Hiermit wird das Google Mobile Ads SDK initialisiert.

Rufen Sie diese Methode möglichst früh 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 Context, in der das SDK ausgeführt wird.
listener: OnInitializationCompleteListener!

Ein Callback, der nach Abschluss der Initialisierung aufgerufen wird.

openAdInspector

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

Öffnet die Benutzeroberfläche des Anzeigenprüftools.

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 Context, in der das SDK ausgeführt wird.
adUnitId: String!

Eine beliebige Ad Manager-Anzeigenblock-ID, die mit Ihrer App verknüpft ist.

putPublisherFirstPartyIdEnabled

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

Hiermit wird festgelegt, ob die eigene Publisher-ID des Google Mobile Ads SDK (früher „App-interner Schlüssel“) 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

„wahr“, wenn die eigene Publisher-ID aktiviert ist, andernfalls „falsch“.
Ausgabe
Boolean

„wahr“, wenn die Entscheidung erfolgreich gespeichert wurde. „False“, wenn die Daten nicht gespeichert werden können.

registerCustomTabsSession

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

Registriert eine CustomTabsClient beim Google Mobile Ads SDK, um die In-App-Werbemonetarisierung von Anzeigen in dieser CustomTabsSession zu verbessern. Dadurch wird nur eine Instanz von CustomTabsSession erstellt. Wenn Sie den Befehl noch einmal ausführen, wird die vorhandene Sitzung überschrieben.

Parameter
context: Context

Die Context, in der das SDK ausgeführt wird.
client: CustomTabsClient

CustomTabsClient, mit dem die CustomTabsSession-Instanz erstellt wurde.
origin: String

String, der im Digital Asset Link als Ursprung für die Überprüfung verwendet wird.
callback: CustomTabsCallback?

Optional: CustomTabsCallback, um Callbacks von zu erhalten .
Ausgabe
CustomTabsSession?

CustomTabsSession-Instanz, die für den Custom Tabs-Intent verwendet werden soll, wenn eine Custom Tabs-Seite geöffnet wird.

registerWebView

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

Registriert eine WebView beim Google Mobile Ads SDK, um die In-App-Werbemonetarisierung von Anzeigen in dieser WebView zu verbessern.

setAppMuted

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

Gibt an, ob der Ton der Anwendung stummgeschaltet ist. Beeinflusst den anfänglichen Stummschaltungsstatus für alle Anzeigen.

Warnung: Wenn Sie die Audiowiedergabe Ihrer App stummschalten, können Videoanzeigen nicht mehr ausgeliefert werden und die Werbeeinnahmen Ihrer App sinken möglicherweise. Sie sollten diese API nur verwenden, wenn Ihre App eine benutzerdefinierte Stummschaltungssteuerung bietet. Die Stummschaltungsentscheidung des Nutzers 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

Hiermit wird die Audiolautstärke der Anwendung festgelegt. Beeinflusst die Lautstärke aller Anzeigen im Vergleich zu anderen Audioausgaben.

Warnung: Wenn Sie die Audiolautstärke Ihrer App verringern, sinkt die Eignung für Videoanzeigen und möglicherweise auch der Werbeumsatz Ihrer App. Sie sollten diese API nur verwenden, wenn Ihre App dem Nutzer eine benutzerdefinierte Lautstärkeregelung bietet. Die Lautstärkeeinstellung des Nutzers sollte in dieser API berücksichtigt werden.

Parameter
volume: Float

Die Lautstärke als Gleitkommawert von 0 (stummgeschaltet) bis 1,0 (maximale Medienlautstärke). Standardeinstellung: 1.0
Löst
java.lang.IllegalArgumentException

wenn die Lautstärke außerhalb des zulässigen Bereichs liegt

setRequestConfiguration

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

Legt den globalen RequestConfiguration fest, der während der Sitzung der App für jeden AdRequest verwendet wird.

startPreload

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

Startet das Vorladen von Anzeigen für die angegebenen Konfigurationen.

APIs für das Vorladen 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!>

Konfigurationen für das Vorabladen von Anzeigen.
preloadCallback: PreloadCallback

Ein Rückruf, der für jede Preloading-Konfiguration aufgerufen wird, wenn sich die Anzeigenverfügbarkeit ändert.