MobileAds

Kotlin |Java

public class MobileAds

La classe contiene la logica che si applica all'SDK Google Mobile Ads nel suo complesso. Al momento, gli unici metodi contenuti vengono utilizzati per l'inizializzazione.

Riepilogo

Costanti
`static final String`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Nome di dominio di errore predefinito per l'SDK Google Mobile Ads.

Metodi pubblici
`static void`	`disableMediationAdapterInitialization(Context context)` Chiama prima di `initialize` o della prima richiesta di annuncio per disattivare l'inizializzazione dell'adattatore di mediazione.
`static @Nullable InitializationStatus`	`getInitializationStatus()` Restituisce lo stato di inizializzazione dell'SDK.
`static @NonNull RequestConfiguration`	`getRequestConfiguration()` Ottiene il valore globale di `RequestConfiguration`.
`static VersionInfo`	`getVersion()` Recupera la versione esterna (ad esempio 20.6.0) dell'SDK Google Mobile Ads.
`static void`	`@RequiresPermission(value = Manifest.permission.INTERNET) initialize(Context context)` Inizializza l'SDK Google Mobile Ads.
`static void`	`initialize(Context context, OnInitializationCompleteListener listener)` Inizializza l'SDK Google Mobile Ads.
`static void`	`openAdInspector(Context context, OnAdInspectorClosedListener listener)` Si apre la UI dello strumento di controllo degli annunci.
`static void`	`openDebugMenu(Context context, String adUnitId)` Apre il menu di debug.
`static boolean`	`putPublisherFirstPartyIdEnabled(boolean enabled)` Controlla se l'ID proprietario del publisher dell'SDK Google Mobile Ads, precedentemente noto come stessa chiave dell'app, è abilitato.
`static @Nullable CustomTabsSession`	`registerCustomTabsSession( @NonNull Context context, @NonNull CustomTabsClient client, @NonNull String origin, @Nullable CustomTabsCallback callback )` Registra un `CustomTabsClient` con l'SDK Google Mobile Ads per migliorare la monetizzazione degli annunci in-app all'interno di questo `CustomTabsSession`.
`static void`	`registerWebView(@NonNull WebView webview)` Registra un `WebView` con l'SDK Google Mobile Ads per migliorare la monetizzazione degli annunci in-app all'interno di questo `WebView`.
`static void`	`setAppMuted(boolean muted)` Indica se l'audio dell'applicazione è disattivato.
`static void`	`setAppVolume(float volume)` Imposta il volume audio dell'applicazione.
`static void`	`setRequestConfiguration( @NonNull RequestConfiguration requestConfiguration )` Imposta l'`RequestConfiguration` globale che verrà utilizzato per ogni `AdRequest` durante la sessione dell'app.
`static void`	`startPreload( @NonNull Context context, @NonNull List<PreloadConfiguration> preloadConfigurations, @NonNull PreloadCallback preloadCallback )` Questo metodo è obsoleto. Utilizza invece `start` o `start`.

Costanti

ERROR_DOMAIN

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

Nome di dominio di errore predefinito per l'SDK Google Mobile Ads.

Metodi pubblici

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

Chiama prima di initialize o della prima richiesta di annuncio per disattivare l'inizializzazione dell'adattatore di mediazione. Questo metodo è un'operazione no-op una volta effettuata la prima richiesta di annuncio o initialize.

Avviso: la chiamata di questo metodo può influire negativamente sul rendimento della mediazione. Questo metodo deve essere chiamato solo se includi adattatori di mediazione nella tua app, ma non prevedi di utilizzare la mediazione Google durante questa sessione dell'app (ad esempio, stai eseguendo un test A/B).

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

Restituisce lo stato di inizializzazione dell'SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Ottiene il valore globale di RequestConfiguration.

getVersion

public static VersionInfo getVersion()

Recupera la versione esterna (ad esempio 20.6.0) dell'SDK Google Mobile Ads.

initialize non deve essere chiamato prima di questa funzione.

initialize

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

Inizializza l'SDK Google Mobile Ads.

Chiama questo metodo il prima possibile dopo l'avvio dell'app per ridurre la latenza della prima richiesta di annuncio della sessione.

Se questo metodo non viene chiamato, la prima richiesta di annuncio inizializza automaticamente l'SDK Google Mobile Ads.

Parametri
`Context context`	L'`Context` in cui è in esecuzione l'SDK.

initialize

public static void initialize(Context context, OnInitializationCompleteListener listener)

Inizializza l'SDK Google Mobile Ads.

Chiama questo metodo il prima possibile dopo l'avvio dell'app per ridurre la latenza della prima richiesta di annuncio della sessione.

Se questo metodo non viene chiamato, la prima richiesta di annuncio inizializza automaticamente l'SDK Google Mobile Ads.

Parametri
`Context context`	L'attività `Context` in cui è in esecuzione l'SDK.
`OnInitializationCompleteListener listener`	Un callback da richiamare al termine dell'inizializzazione.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Si apre la UI dello strumento di controllo degli annunci.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

Apre il menu di debug. initialize deve essere chiamato prima di questa funzione.

Parametri
`Context context`	L'attività `Context` in cui è in esecuzione l'SDK.
`String adUnitId`	Qualsiasi ID unità pubblicitaria Ad Manager associato alla tua app.

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

Controlla se l'ID proprietario del publisher dell'SDK Google Mobile Ads, precedentemente noto come stessa chiave dell'app, è abilitato.

L'ID è attivo per impostazione predefinita. Se disattivata, l'impostazione viene mantenuta nelle sessioni dell'app e l'ID viene cancellato.

initialize deve essere chiamato prima di questa funzione.

Parametri
`boolean enabled`	booleano true se l'ID proprietario del publisher è attivato, false in caso contrario.

Resi
`boolean`	true se la decisione è stata salvata correttamente. False se non è possibile renderlo persistente.

registerCustomTabsSession

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

Registra un CustomTabsClient con l'SDK Google Mobile Ads per migliorare la monetizzazione degli annunci in-app all'interno di questo CustomTabsSession. Verrà creata una sola istanza di CustomTabsSession e la riesecuzione di questo comando sovrascrive la sessione esistente.

Parametri
`@NonNull Context context`	L'`Context` in cui è in esecuzione l'SDK.
`@NonNull CustomTabsClient client`	`CustomTabsClient` utilizzato per creare l'istanza `CustomTabsSession`.
`@NonNull String origin`	Stringa utilizzata come origine nel Digital Asset Link per la verifica.
`@Nullable CustomTabsCallback callback`	`CustomTabsCallback` facoltativo per ricevere richiamate da `CustomTabsSession`.

Resi
`@Nullable CustomTabsSession`	`CustomTabsSession` da utilizzare per l'intent Schede personalizzate quando si apre una pagina Schede personalizzate.

registerWebView

public static void registerWebView(@NonNull WebView webview)

Registra un WebView con l'SDK Google Mobile Ads per migliorare la monetizzazione degli annunci in-app all'interno di questo WebView.

setAppMuted

public static void setAppMuted(boolean muted)

Indica se l'audio dell'applicazione è disattivato. Influisce sullo stato di disattivazione audio iniziale per tutti gli annunci.

Avviso: la disattivazione dell'audio dell'applicazione riduce l'idoneità degli annunci video e potrebbe ridurre le entrate pubblicitarie dell'app. Devi utilizzare questa API solo se la tua app fornisce all'utente un controllo di disattivazione dell'audio personalizzato e devi riflettere la decisione di disattivazione dell'audio dell'utente in questa API.

Parametri
`boolean muted`	true se l'app è disattivata, false in caso contrario. Il valore predefinito è false.

setAppVolume

public static void setAppVolume(float volume)

Imposta il volume audio dell'applicazione. Influisce sui volumi audio di tutti gli annunci rispetto ad altri output audio.

Avviso: la riduzione del volume audio dell'app riduce l'idoneità degli annunci video e potrebbe ridurre le entrate pubblicitarie dell'app. Devi utilizzare questa API solo se la tua app fornisce all'utente controlli del volume personalizzati e devi riflettere la scelta del volume dell'utente in questa API.

Parametri
`float volume`	il volume come float da 0 (audio disattivato) a 1,0 (volume dei contenuti multimediali completo). Il valore predefinito è 1.0

Genera
`java.lang.IllegalArgumentException`	se il volume non rientra nell'intervallo valido

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

Imposta l'RequestConfiguration globale che verrà utilizzato per ogni AdRequest durante la sessione dell'app.

startPreload

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

Inizia a precaricare gli annunci per le configurazioni specificate.

Le API di precaricamento degli annunci sono in versione alpha limitata. Per ulteriori informazioni, contatta il tuo account manager.

Parametri
`@NonNull Context context`	L'`Context` in cui è in esecuzione l'SDK.
`@NonNull List<PreloadConfiguration> preloadConfigurations`	Le configurazioni per precaricare gli annunci.
`@NonNull PreloadCallback preloadCallback`	Un callback da richiamare quando la disponibilità degli annunci cambia per ogni configurazione di precaricamento.