Diese Seite wurde von der Cloud Translation API übersetzt.

MobileAds

Kotlin |Java

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

Öffentliche Methoden
`static void`	`disableMediationAdapterInitialization(Context context)` Rufen Sie diese Funktion vor `initialize` oder vor der ersten Anzeigenanfrage auf, um die Initialisierung des Mediation-Adapters zu deaktivieren.
`static @Nullable InitializationStatus`	`getInitializationStatus()` Ruft den Initialisierungsstatus des SDK ab.
`static @NonNull RequestConfiguration`	`getRequestConfiguration()` Ruft den globalen `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)` Hiermit wird das Google Mobile Ads SDK initialisiert.
`static void`	`initialize(Context context, OnInitializationCompleteListener listener)` Hiermit wird das Google Mobile Ads SDK initialisiert.
`static void`	`openAdInspector(Context context, OnAdInspectorClosedListener listener)` Öffnet die Benutzeroberfläche des Anzeigenprüftools.
`static void`	`openDebugMenu(Context context, String adUnitId)` Öffnet das Debug-Menü.
`static boolean`	`putPublisherFirstPartyIdEnabled(boolean enabled)` Damit wird festgelegt, ob die eigene Publisher-ID des Google Mobile Ads SDK (früher „App-interner Schlüssel“) aktiviert ist.
`static @Nullable CustomTabsSession`	`registerCustomTabsSession( @NonNull Context context, @NonNull CustomTabsClient client, @NonNull String origin, @Nullable CustomTabsCallback callback )` Registriert eine `CustomTabsClient` beim Google Mobile Ads SDK, um die In-App-Werbemonetarisierung von Anzeigen in dieser `CustomTabsSession` zu verbessern.
`static void`	`registerWebView(@NonNull WebView webview)` Registriert eine `WebView` beim Google Mobile Ads SDK, um die In-App-Werbemonetarisierung von Anzeigen in dieser `WebView` zu verbessern.
`static void`	`setAppMuted(boolean muted)` Gibt an, ob der Ton der Anwendung stummgeschaltet ist.
`static void`	`setAppVolume(float volume)` Hiermit wird die Audiolautstärke der Anwendung festgelegt.
`static void`	`setRequestConfiguration( @NonNull RequestConfiguration requestConfiguration )` Legt den globalen `RequestConfiguration` fest, der während der Sitzung der App für jeden `AdRequest` verwendet wird.
`static void`	`startPreload( @NonNull Context context, @NonNull List<PreloadConfiguration> preloadConfigurations, @NonNull PreloadCallback preloadCallback )` Startet das Vorladen von Anzeigen für die angegebenen Konfigurationen.

Konstanten

ERROR_DOMAIN

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

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

Öffentliche Methoden

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

Rufen Sie diese 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

public static @Nullable InitializationStatus getInitializationStatus()

Ruft den Initialisierungsstatus des SDK ab.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Ruft den globalen RequestConfiguration ab.

getVersion

public static VersionInfo getVersion()

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

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 bei der ersten Anzeigenanfrage automatisch initialisiert.

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

initialize

public static void initialize(Context context, OnInitializationCompleteListener listener)

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 bei der ersten Anzeigenanfrage automatisch initialisiert.

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

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Öffnet die Benutzeroberfläche des Anzeigenprüftools.

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 `Context`, in der das SDK ausgeführt wird.
`String adUnitId`	Eine beliebige Ad Manager-Anzeigenblock-ID, die mit Ihrer App verknüpft ist.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

setAppVolume

public static void setAppVolume(float volume)

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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

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

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