MobileAds

class MobileAds

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

Riepilogo

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

Nome di dominio predefinito per gli errori dell'SDK Google Mobile Ads.

Funzioni pubbliche
java-static Unit

Esegui la chiamata prima di initialize o della prima richiesta di annuncio per disattivare l'inizializzazione dell'adattatore di mediazione.
java-static InitializationStatus?

Restituisce lo stato di inizializzazione dell'SDK.
java-static RequestConfiguration

Recupera il RequestConfiguration globale.
java-static VersionInfo!

Recupera la versione esterna (ad es. 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

Inizializza l'SDK Google Mobile Ads.
java-static Unit

Si apre l'interfaccia utente dello strumento di controllo degli annunci.
java-static Unit
openDebugMenu(context: Context!, adUnitId: String!)

Apre il menu di debug.
java-static 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 CustomTabsClient.CustomTabsSession
java-static Unit

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

Indica se l'audio dell'applicazione è disattivato.
java-static Unit

Imposta il volume audio dell'applicazione.
java-static Unit

Imposta il 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 è deprecata.

Utilizza start o start.

Costanti

ERROR_DOMAIN

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

Nome di dominio predefinito per gli errori dell'SDK Google Mobile Ads.

Funzioni pubbliche

disableMediationAdapterInitialization

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

Esegui la chiamata prima di initialize o della prima richiesta di annuncio per disattivare l'inizializzazione dell'adattatore di mediazione. Questo metodo è un noop una volta che viene attivato initialize o viene effettuata la prima richiesta di annuncio.

Avviso: la chiamata a questo metodo potrebbe 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

Recupera il RequestConfiguration globale.

getVersion

java-static fun getVersion(): VersionInfo!

Recupera la versione esterna (ad es. 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!

Il 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 chiamare al termine dell'inizializzazione.

openAdInspector

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

Si apre l'interfaccia utente 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

boolean true se l'ID proprietario del publisher è attivato, false in caso contrario.
Resi
Boolean

true se la decisione viene mantenuta correttamente. False se non viene eseguito il commit.

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 CustomTabsClient.CustomTabsSession Verrà creata una sola istanza di CustomTabsSession e l'esecuzione di nuovo dell'operazione sostituirà la sessione esistente.

Parametri
context: Context

Il Context in cui è in esecuzione l'SDK.
client: CustomTabsClient

CustomTabsClient utilizzato per creare l'istanza CustomTabsSession.
origin: String

Stringa utilizzata come origine nel link a risorse digitali per la verifica.
callback: CustomTabsCallback?

facoltativo CustomTabsCallback per ricevere chiamate da .
Resi
CustomTabsSession?

CustomTabsSession da utilizzare per l'Intent di Custom Tabs quando apri una pagina di Custom Tabs.

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.WebView

setAppMuted

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

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

Attenzione: 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 audio personalizzato e devi riflettere la decisione di disattivazione audio dell'utente in questa API.

Parametri
muted: Boolean

true se l'app è in modalità silenziosa, false in caso contrario. Il valore predefinito è false.

setAppVolume

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

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

Attenzione: abbassare il 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 valore in virgola mobile compreso tra 0 (audio disattivato) e 1,0 (volume dei contenuti multimediali massimo). Il valore predefinito è 1.0
Lanci
java.lang.IllegalArgumentException

if volume is out of the valid range

setRequestConfiguration

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

Imposta il 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

Avvia il precaricamento degli 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

Il Context in cui è in esecuzione l'SDK.
preloadConfigurations: (Mutable)List<PreloadConfiguration!>

Le configurazioni per precaricare gli annunci.
preloadCallback: PreloadCallback

Un callback da chiamare quando la disponibilità degli annunci cambia per ogni configurazione di precaricamento.