Ta strona została przetłumaczona przez Cloud Translation API.

MobileAds

Kotlin |Java

class MobileAds

Klasa zawiera logikę, która dotyczy pakietu SDK do reklam mobilnych Google jako całości. Obecnie jedyne metody w nim używane są do inicjalizacji.

Podsumowanie

Stałe
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Domyślna nazwa domeny błędów w pakiecie SDK do reklam mobilnych Google.

Funkcje publiczne
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` Aby wyłączyć inicjalizację pośrednika, wywołaj tę metodę przed wywołaniem `initialize` lub pierwszym żądaniem reklamy.
`java-static InitializationStatus?`	`getInitializationStatus()` Pobiera stan inicjowania pakietu SDK.
`java-static RequestConfiguration`	`getRequestConfiguration()` Pobiera globalną wartość `RequestConfiguration`.
`java-static VersionInfo!`	`getVersion()` Pobiera zewnętrzną wersję pakietu SDK do reklam mobilnych Google (np. 20.6.0).
`java-static Unit`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(context: Context!)` Inicjowanie pakietu SDK do reklam mobilnych Google.
`java-static Unit`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` Inicjowanie pakietu SDK do reklam mobilnych Google.
`java-static Unit`	`openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!)` Otwiera interfejs inspektora reklam.
`java-static Unit`	`openDebugMenu(context: Context!, adUnitId: String!)` Otwiera menu debugowania.
`java-static Boolean`	`putPublisherFirstPartyIdEnabled(enabled: Boolean)` Określa, czy własny identyfikator wydawcy w pakiecie SDK do reklam mobilnych Google (dawniej Same App Key) jest włączony.
`java-static CustomTabsSession?`	`registerCustomTabsSession( context: Context, client: CustomTabsClient, origin: String, callback: CustomTabsCallback? )` Rejestruje `CustomTabsClient` w pakiecie SDK do reklam mobilnych Google, aby poprawić zarabianie na reklamach w aplikacji w ramach tego `CustomTabsSession`.
`java-static Unit`	`registerWebView(webview: WebView)` Rejestruje `WebView` w pakiecie SDK do reklam mobilnych Google, aby poprawić zarabianie na reklamach w aplikacji w ramach tego `WebView`.
`java-static Unit`	`setAppMuted(muted: Boolean)` Wskazuje, czy dźwięk w aplikacji jest wyciszony.
`java-static Unit`	`setAppVolume(volume: Float)` Ustawia głośność dźwięku aplikacji.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` Ustawia globalną wartość `RequestConfiguration`, która będzie używana dla każdego `AdRequest` podczas sesji aplikacji.
`java-static Unit`	`startPreload( context: Context, preloadConfigurations: (Mutable)List<PreloadConfiguration!>, preloadCallback: PreloadCallback )` Ta funkcja została wycofana. Zamiast tego użyj start lub start.

Stałe

ERROR_DOMAIN

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

Domyślna nazwa domeny błędów w pakiecie SDK do reklam mobilnych Google.

Funkcje publiczne

disableMediationAdapterInitialization

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

Aby wyłączyć inicjalizację pośrednika, wywołaj tę metodę przed wywołaniem initialize lub pierwszym żądaniem reklamy. Ta metoda jest nieaktywna, gdy initialize lub pierwsze żądanie reklamy zostało już wysłane.

Ostrzeżenie: wywołanie tej metody może negatywnie wpłynąć na skuteczność pośredniczenia. Ta metoda powinna być wywoływana tylko wtedy, gdy w aplikacji są uwzględnione adaptery zapośredniczenia, ale w ramach tej sesji aplikacji nie planujesz korzystać z zapośredniczenia Google (np. przeprowadzasz test A/B).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

Pobiera stan inicjowania pakietu SDK.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Pobiera globalną wartość RequestConfiguration.

getVersion

java-static fun getVersion(): VersionInfo!

Pobiera zewnętrzną wersję pakietu SDK do reklam mobilnych Google (np. 20.6.0).

Przed tą funkcją nie trzeba wywoływać funkcji initialize.

inicjować

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

Inicjowanie pakietu SDK do reklam mobilnych Google.

Wywołuj tę metodę jak najszybciej po uruchomieniu aplikacji, aby skrócić czas oczekiwania na pierwsze żądanie reklamy w sesji.

Jeśli ta metoda nie zostanie wywołana, pierwsze żądanie reklamy automatycznie zainicjuje pakiet SDK do reklam mobilnych Google.

Parametry
`context: Context!`	`Context`, w którym działa pakiet SDK.

inicjować

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

Inicjowanie pakietu SDK do reklam mobilnych Google.

Wywołuj tę metodę jak najszybciej po uruchomieniu aplikacji, aby skrócić czas oczekiwania na pierwsze żądanie reklamy w sesji.

Jeśli ta metoda nie zostanie wywołana, pierwsze żądanie reklamy automatycznie zainicjuje pakiet SDK do reklam mobilnych Google.

Parametry
`context: Context!`	Aktywność `Context`, w której działa pakiet SDK.
`listener: OnInitializationCompleteListener!`	Wywołanie zwrotne, które zostanie wywołane po zakończeniu inicjalizacji.

openAdInspector

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

Otwiera interfejs inspektora reklam.

openDebugMenu

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

Otwiera menu debugowania. Przed tą funkcją musi zostać wywołana metoda initialize.

Parametry
`context: Context!`	Aktywność `Context`, w której działa pakiet SDK.
`adUnitId: String!`	Identyfikator dowolnej jednostki reklamowej Ad Managera powiązanej z Twoją aplikacją.

putPublisherFirstPartyIdEnabled

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

Określa, czy własny identyfikator wydawcy w pakiecie SDK do reklam mobilnych Google (dawniej Same App Key) jest włączony.

Domyślnie identyfikator jest włączony. Gdy jest wyłączone, ustawienie jest zachowywane w przypadku sesji aplikacji, a identyfikator jest wymazywany.

Przed tą funkcją musi zostać wywołana metoda initialize.

Parametry
`enabled: Boolean`	boolean true, jeśli własny identyfikator wydawcy jest włączony, w przeciwnym razie ma wartość false.

Zwroty
`Boolean`	true, jeśli decyzja została zapisana; false w przeciwnym razie. Wartość „Fałsz”, jeśli nie uda się zapisać.

registerCustomTabsSession

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

Rejestruje CustomTabsClient w pakiecie SDK do reklam mobilnych Google, aby poprawić zarabianie na reklamach w aplikacji w ramach tego CustomTabsSession. Spowoduje to utworzenie tylko 1 instancji funkcji CustomTabsSession, a ponowne jej uruchomienie zastąpi bieżącą sesję.

Parametry
`context: Context`	`Context`, w którym działa pakiet SDK.
`client: CustomTabsClient`	`CustomTabsClient` użyty do utworzenia instancji `CustomTabsSession`.
`origin: String`	Ciąg znaków używany jako źródło w Digital Asset Link na potrzeby weryfikacji.
`callback: CustomTabsCallback?`	opcjonalnie `CustomTabsCallback`, aby odbierać połączenia zwrotne z .

Zwroty
`CustomTabsSession?`	`CustomTabsSession`, który ma być używany do obsługi zamiaru w przypadku stron niestandardowych podczas ich otwierania.

registerWebView

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

Rejestruje WebView w pakiecie SDK do reklam mobilnych Google, aby poprawić zarabianie na reklamach w aplikacji w ramach tego WebView.

setAppMuted

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

Wskazuje, czy dźwięk w aplikacji jest wyciszony. Wpływa na wstępny stan wyciszenia wszystkich reklam.

Ostrzeżenie: wyciszenie aplikacji zmniejsza kwalifikowalność reklam wideo i może obniżyć przychody z reklam w aplikacji. Należy używać tego interfejsu API tylko wtedy, gdy aplikacja udostępnia użytkownikowi możliwość wyciszenia dźwięku. W tym interfejsie API należy uwzględnić decyzję użytkownika dotyczącą wyciszenia.

Parametry
`muted: Boolean`	Wartość true, jeśli aplikacja jest wyciszona, w przeciwnym razie wartość false. Wartość domyślna to fałsz.

setAppVolume

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

Ustawia głośność dźwięku aplikacji. Wpływa na głośność dźwięku wszystkich reklam w stosunku do innych dźwięków.

Ostrzeżenie: zmniejszenie głośności dźwięku w aplikacji powoduje, że reklamy wideo nie kwalifikują się do wyświetlania, co może zmniejszyć przychody z reklam w aplikacji. Z tego interfejsu API należy korzystać tylko wtedy, gdy aplikacja udostępnia użytkownikowi oddzielne elementy sterujące głośnością, a interfejs API odzwierciedla wybór użytkownika.

Parametry
`volume: Float`	głośność w postaci liczby zmiennoprzecinkowej od 0 (wyciszona) do 1,0 (pełna głośność multimediów). Domyślna wartość to 1,0.

Rzuty
`java.lang.IllegalArgumentException`	jeśli głośność jest poza prawidłowym zakresem.

setRequestConfiguration

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

Ustawia globalną wartość RequestConfiguration, która będzie używana dla każdego AdRequest podczas sesji aplikacji.

startPreload

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

Rozpoczyna wstępny wczytywanie reklam dla podanych konfiguracji.

Interfejsy API do wstępnego wczytywania reklam są w ograniczonej wersji alfa. Aby uzyskać więcej informacji, skontaktuj się z menedżerem konta.

Parametry
`context: Context`	`Context`, w którym działa pakiet SDK.
`preloadConfigurations: (Mutable)List<PreloadConfiguration!>`	Konfiguracje wstępnego wczytywania reklam.
`preloadCallback: PreloadCallback`	Wywołanie zwrotne, które zostanie wywołane, gdy zmieni się dostępność reklamy w przypadku każdej konfiguracji wstępnego wczytania.