MobileAds

Kotlin |Java

class MobileAds

Klasa zawiera logikę, która odnosi się do pakietu SDK do reklam mobilnych Google jako całości. Obecnie jedyne metody w niej służą do inicjowania.

Podsumowanie

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

Funkcje publiczne
`java-static Unit`	`disableMediationAdapterInitialization(context: Context!)` Wywołaj funkcję przed `initialize` lub pierwszym żądaniem reklamy, aby wyłączyć inicjowanie adaptera zapośredniczenia.
`java-static InitializationStatus?`	`getInitializationStatus()` Pobiera stan inicjowania pakietu SDK.
`java-static RequestConfiguration`	`getRequestConfiguration()` Pobiera globalny parametr `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!)` Inicjuje pakiet SDK do reklam mobilnych Google.
`java-static Unit`	`initialize(context: Context!, listener: OnInitializationCompleteListener!)` Inicjuje pakiet 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 pakietu SDK do reklam mobilnych Google (nazywany wcześniej 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 zwiększyć 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 zwiększyć zarabianie na reklamach w aplikacji w ramach tego `WebView`.
`java-static Unit`	`setAppMuted(muted: Boolean)` Wskazuje, czy dźwięk aplikacji jest wyciszony.
`java-static Unit`	`setAppVolume(volume: Float)` Ustawia głośność dźwięku aplikacji.
`java-static Unit`	`setRequestConfiguration(requestConfiguration: RequestConfiguration)` Ustawia globalny `RequestConfiguration`, który będzie używany w przypadku każdego `AdRequest` podczas sesji aplikacji.
`java-static Unit`	`startPreload( context: Context, preloadConfigurations: (Mutable)List<PreloadConfiguration!>, preloadCallback: PreloadCallback )` Ta funkcja została wycofana. Zamiast niej użyj zasady `start` lub `start`.

Stałe

ERROR_DOMAIN

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

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

Funkcje publiczne

disableMediationAdapterInitialization

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

Wywołaj funkcję przed initialize lub pierwszym żądaniem reklamy, aby wyłączyć inicjowanie adaptera zapośredniczenia. Ta metoda nie wykonuje żadnej operacji po wywołaniu funkcji initialize lub wysłaniu pierwszego żądania reklamy.

Ostrzeżenie: wywołanie tej metody może negatywnie wpłynąć na skuteczność mediacji. Tej metody należy używać tylko wtedy, gdy w aplikacji znajdują się adaptery zapośredniczenia, ale w trakcie tej sesji 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 globalny parametr RequestConfiguration.

getVersion

java-static fun getVersion(): VersionInfo!

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

Przed wywołaniem tej funkcji nie musisz wywoływać funkcji initialize.

inicjować

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

Inicjuje pakiet 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

Inicjuje pakiet 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ść, w której działa pakiet SDK.`Context`
`listener: OnInitializationCompleteListener!`	Wywołanie zwrotne, które ma zostać wywołane po zakończeniu inicjowania.

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 wywołaniem tej funkcji należy wywołać metodę initialize.

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

putPublisherFirstPartyIdEnabled

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

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

Identyfikator jest domyślnie włączony. Gdy to ustawienie jest wyłączone, jest ono zachowywane między sesjami aplikacji, a identyfikator jest usuwany.

Przed wywołaniem tej funkcji należy wywołać metodę initialize.

Parametry
`enabled: Boolean`	Wartość logiczna „true”, jeśli własny identyfikator wydawcy jest włączony, w przeciwnym razie „false”.

Zwroty
`Boolean`	true, jeśli decyzja została zapisana. Wartość „Fałsz”, jeśli nie udało się zapisać danych.

registerCustomTabsSession

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

Rejestruje CustomTabsClient w pakiecie SDK do reklam mobilnych Google, aby zwiększyć zarabianie na reklamach w aplikacji w ramach tego CustomTabsSession. Spowoduje to utworzenie tylko jednego wystąpienia CustomTabsSession, a ponowne uruchomienie tej funkcji zastąpi istnieją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 używany jako źródło w Digital Asset Link na potrzeby weryfikacji.
`callback: CustomTabsCallback?`	opcjonalnie `CustomTabsCallback`, aby otrzymywać wywołania zwrotne od `CustomTabsSession`.

Zwroty
`CustomTabsSession?`	`CustomTabsSession`, który ma być używany w przypadku intencji kart niestandardowych podczas otwierania strony kart niestandardowych.

registerWebView

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

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

setAppMuted

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

Wskazuje, czy dźwięk aplikacji jest wyciszony. Wpływa na początkowy stan wyciszenia wszystkich reklam.

Ostrzeżenie: wyciszenie aplikacji zmniejsza możliwość wyświetlania reklam wideo i może obniżyć przychody z reklam w aplikacji. Z tego interfejsu API należy korzystać tylko wtedy, gdy aplikacja udostępnia użytkownikowi niestandardowy element sterujący wyciszaniem. W tym interfejsie API należy odzwierciedlać decyzję użytkownika o wyciszeniu.

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ść wszystkich reklam w stosunku do innych wyjść audio.

Ostrzeżenie: obniżenie głośności dźwięku w aplikacji zmniejsza możliwość wyświetlania reklam wideo i może obniżyć przychody z reklam w aplikacji. Z tego interfejsu API należy korzystać tylko wtedy, gdy aplikacja udostępnia użytkownikowi własne elementy sterujące głośnością. W tym interfejsie API należy odzwierciedlać wybór głośności użytkownika.

Parametry
`volume: Float`	głośność jako liczba zmiennoprzecinkowa od 0 (wyciszenie) 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 globalny RequestConfiguration, który będzie używany w przypadku każdego AdRequest podczas sesji aplikacji.

startPreload

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

Rozpoczyna wstępne wczytywanie reklam dla podanych konfiguracji.

Interfejsy API wstępnego wczytywania reklam są dostępne 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 ma być wywoływane, gdy zmieni się dostępność reklamy w przypadku każdej konfiguracji wstępnego wczytywania.