MobileAds

Kotlin |Java

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
`const String!`	`ERROR_DOMAIN = "com.google.android.gms.ads"` Nome di dominio di errore predefinito per l'SDK Google Mobile Ads.

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

Costanti

ERROR_DOMAIN

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

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

Funzioni pubbliche

disableMediationAdapterInitialization

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

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

java-static fun getInitializationStatus(): InitializationStatus?

Restituisce lo stato di inizializzazione dell'SDK.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Ottiene il valore globale di RequestConfiguration.

getVersion

java-static fun getVersion(): VersionInfo!

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)
java-static fun initialize(context: Context!): Unit

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

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

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.
`listener: OnInitializationCompleteListener!`	Un callback da richiamare al termine dell'inizializzazione.

openAdInspector

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

Si apre la UI dello strumento di controllo degli annunci.

openDebugMenu

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

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.
`adUnitId: String!`	Qualsiasi ID unità pubblicitaria Ad Manager associato alla tua app.

putPublisherFirstPartyIdEnabled

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

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
`enabled: Boolean`	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

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

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
`context: Context`	L'`Context` in cui è in esecuzione l'SDK.
`client: CustomTabsClient`	`CustomTabsClient` utilizzato per creare l'istanza `CustomTabsSession`.
`origin: String`	Stringa utilizzata come origine nel Digital Asset Link per la verifica.
`callback: CustomTabsCallback?`	`CustomTabsCallback` facoltativo per ricevere richiamate da `CustomTabsSession`.

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

registerWebView

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

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

setAppMuted

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

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
`muted: Boolean`	true se l'app è disattivata, false in caso contrario. Il valore predefinito è false.

setAppVolume

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

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
`volume: Float`	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

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

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

startPreload

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

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
`context: Context`	L'`Context` in cui è in esecuzione l'SDK.
`preloadConfigurations: (Mutable)List<PreloadConfiguration!>`	Le configurazioni per precaricare gli annunci.
`preloadCallback: PreloadCallback`	Un callback da richiamare quando la disponibilità degli annunci cambia per ogni configurazione di precaricamento.