MobileAds

Kotlin |Java

public 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
`static final String`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Domyślna nazwa domeny błędu w pakiecie SDK do reklam mobilnych Google.

Metody publiczne
`static void`	`disableMediationAdapterInitialization(Context context)` Wywołaj funkcję przed `initialize` lub pierwszym żądaniem reklamy, aby wyłączyć inicjowanie adaptera zapośredniczenia.
`static @Nullable InitializationStatus`	`getInitializationStatus()` Pobiera stan inicjowania pakietu SDK.
`static @NonNull RequestConfiguration`	`getRequestConfiguration()` Pobiera globalny parametr `RequestConfiguration`.
`static VersionInfo`	`getVersion()` Pobiera zewnętrzną wersję pakietu SDK do reklam mobilnych Google (np. 20.6.0).
`static void`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(Context context)` Inicjuje pakiet SDK do reklam mobilnych Google.
`static void`	`initialize(Context context, OnInitializationCompleteListener listener)` Inicjuje pakiet SDK do reklam mobilnych Google.
`static void`	`openAdInspector(Context context, OnAdInspectorClosedListener listener)` Otwiera interfejs inspektora reklam.
`static void`	`openDebugMenu(Context context, String adUnitId)` Otwiera menu debugowania.
`static boolean`	`putPublisherFirstPartyIdEnabled(boolean enabled)` Określa, czy własny identyfikator wydawcy pakietu SDK do reklam mobilnych Google (nazywany wcześniej Same App Key) jest włączony.
`static @Nullable CustomTabsSession`	`registerCustomTabsSession( @NonNull Context context, @NonNull CustomTabsClient client, @NonNull String origin, @Nullable CustomTabsCallback callback )` Rejestruje `CustomTabsClient` w pakiecie SDK do reklam mobilnych Google, aby zwiększyć zarabianie na reklamach w aplikacji w ramach tego `CustomTabsSession`.
`static void`	`registerWebView(@NonNull WebView webview)` Rejestruje `WebView` w pakiecie SDK do reklam mobilnych Google, aby zwiększyć zarabianie na reklamach w aplikacji w ramach tego `WebView`.
`static void`	`setAppMuted(boolean muted)` Wskazuje, czy dźwięk aplikacji jest wyciszony.
`static void`	`setAppVolume(float volume)` Ustawia głośność dźwięku aplikacji.
`static void`	`setRequestConfiguration( @NonNull RequestConfiguration requestConfiguration )` Ustawia globalny `RequestConfiguration`, który będzie używany w przypadku każdego `AdRequest` podczas sesji aplikacji.
`static void`	`startPreload( @NonNull Context context, @NonNull List<PreloadConfiguration> preloadConfigurations, @NonNull PreloadCallback preloadCallback )` Ta metoda została wycofana. Zamiast niej użyj zasady `start` lub `start`.

Stałe

ERROR_DOMAIN

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

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

Metody publiczne

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

public static @Nullable InitializationStatus getInitializationStatus()

Pobiera stan inicjowania pakietu SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Pobiera globalny parametr RequestConfiguration.

getVersion

public static VersionInfo getVersion()

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

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ć

public static void initialize(Context context, OnInitializationCompleteListener listener)

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`
`OnInitializationCompleteListener listener`	Wywołanie zwrotne, które ma zostać wywołane po zakończeniu inicjowania.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Otwiera interfejs inspektora reklam.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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`
`String adUnitId`	Dowolny identyfikator jednostki reklamowej Ad Managera powiązany z Twoją aplikacją.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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
`@NonNull Context context`	`Context`, w którym działa pakiet SDK.
`@NonNull CustomTabsClient client`	`CustomTabsClient` użyty do utworzenia instancji `CustomTabsSession`.
`@NonNull String origin`	Ciąg używany jako źródło w Digital Asset Link na potrzeby weryfikacji.
`@Nullable CustomTabsCallback callback`	opcjonalnie `CustomTabsCallback`, aby otrzymywać wywołania zwrotne od `CustomTabsSession`.

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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
`boolean muted`	wartość true, jeśli aplikacja jest wyciszona, w przeciwnym razie wartość false. Wartość domyślna to fałsz.

setAppVolume

public static void setAppVolume(float volume)

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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

Ustawia globalny RequestConfiguration, który będzie używany w przypadku każdego AdRequest podczas sesji aplikacji.

startPreload

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

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
`@NonNull Context context`	`Context`, w którym działa pakiet SDK.
`@NonNull List<PreloadConfiguration> preloadConfigurations`	Konfiguracje wstępnego wczytywania reklam.
`@NonNull 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.