MobileAds

Kotlin |Java

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

Metody publiczne
static void	disableMediationAdapterInitialization(Context context) Aby wyłączyć inicjalizację pośrednika, wywołaj tę metodę przed wywołaniem initialize lub pierwszym żądaniem reklamy.
static @Nullable InitializationStatus	getInitializationStatus() Pobiera stan inicjowania pakietu SDK.
static @NonNull RequestConfiguration	getRequestConfiguration() Pobiera globalną wartość 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) Inicjowanie pakietu SDK do reklam mobilnych Google.
static void	initialize(Context context, OnInitializationCompleteListener listener) Inicjowanie pakietu 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 w pakiecie SDK do reklam mobilnych Google (dawniej 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 poprawić 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 poprawić zarabianie na reklamach w aplikacji w ramach tego WebView.
static void	setAppMuted(boolean muted) Wskazuje, czy dźwięk w aplikacji jest wyciszony.
static void	setAppVolume(float volume) Ustawia głośność dźwięku aplikacji.
static void	setRequestConfiguration(     @NonNull RequestConfiguration requestConfiguration ) Ustawia globalną wartość RequestConfiguration, która będzie używana dla 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 tego użyj start lub start.

Stałe

ERROR_DOMAIN

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

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

Metody publiczne

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

public static @Nullable InitializationStatus getInitializationStatus()

Pobiera stan inicjowania pakietu SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Pobiera globalną wartość RequestConfiguration.

getVersion

public static VersionInfo getVersion()

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

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ć

public static void initialize(Context context, OnInitializationCompleteListener listener)

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.
OnInitializationCompleteListener listener	Wywołanie zwrotne, które zostanie wywołane po zakończeniu inicjalizacji.

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 tą funkcją musi zostać wywołana metoda initialize.

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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 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
@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 znaków używany jako źródło w Digital Asset Link na potrzeby weryfikacji.
@Nullable CustomTabsCallback callback	opcjonalnie CustomTabsCallback, aby odbierać połączenia zwrotne z .

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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
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ść 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
float volume	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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

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

Ta metoda została wycofana.

Zamiast tego użyj start lub start.

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
@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 zostanie wywołane, gdy zmieni się dostępność reklamy w przypadku każdej konfiguracji wstępnego wczytania.