MobileAds

Kotlin |Java

public 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
`static final String`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Standardmäßiger Fehlerdomainname für das Google Mobile Ads SDK.

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

Konstanten

ERROR_DOMAIN

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

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

Öffentliche Methoden

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

public static @Nullable InitializationStatus getInitializationStatus()

Ruft den SDK-Initialisierungsstatus ab.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Ruft die globale RequestConfiguration ab.

getVersion

public static VersionInfo getVersion()

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)
public static void initialize(Context context)

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

public static void initialize(Context context, OnInitializationCompleteListener listener)

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`
`OnInitializationCompleteListener listener`	Ein Callback, der nach Abschluss der Initialisierung aufgerufen werden soll.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Öffnet die Benutzeroberfläche des Anzeigeninspektors.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

Ö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`
`String adUnitId`	Alle Ad Manager-Anzeigenblock-IDs, die mit Ihrer App verknüpft sind.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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
`boolean enabled`	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

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

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
`@NonNull Context context`	Die `Context`, in der das SDK ausgeführt wird.
`@NonNull CustomTabsClient client`	`CustomTabsClient`, die zum Erstellen der `CustomTabsSession`-Instanz verwendet wird.
`@NonNull String origin`	String, der als Ursprung im Digital Asset Link zur Überprüfung verwendet wird.
`@Nullable CustomTabsCallback callback`	Optionale `CustomTabsCallback`, um Rückrufe von `CustomTabsSession` zu erhalten.

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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
`boolean muted`	„true“, wenn die App stummgeschaltet ist, andernfalls „false“. Die Standardeinstellung ist "false".

setAppVolume

public static void setAppVolume(float volume)

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
`float volume`	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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

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

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
`@NonNull Context context`	Die `Context`, in der das SDK ausgeführt wird.
`@NonNull List<PreloadConfiguration> preloadConfigurations`	Die Konfigurationen zum Vorabladen von Anzeigen.
`@NonNull PreloadCallback preloadCallback`	Ein Callback, der aufgerufen wird, wenn sich die Anzeigenverfügbarkeit für jede Preload-Konfiguration ändert.