Questa pagina è stata tradotta dall'API Cloud Translation.

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 al suo interno vengono utilizzati per l'inizializzazione.

Riepilogo

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

Metodi pubblici
`static void`	`disableMediationAdapterInitialization(Context context)` Esegui la chiamata 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()` Recupera `RequestConfiguration` globale.
`static VersionInfo`	`getVersion()` Recupera la versione esterna (ad es. 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 l'interfaccia utente 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 il `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 )` Avvia il precaricamento degli annunci per le configurazioni specificate.

Costanti

ERROR_DOMAIN

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

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

Metodi pubblici

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

public static @Nullable InitializationStatus getInitializationStatus()

Restituisce lo stato di inizializzazione dell'SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Recupera RequestConfiguration globale.

getVersion

public static VersionInfo getVersion()

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

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

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

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 l'esecuzione di nuovo dell'operazione sostituirà la sessione esistente.

Parametri
`@NonNull Context context`	Il `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 link a risorse digitali per la verifica.
`@Nullable CustomTabsCallback callback`	facoltativo `CustomTabsCallback` per ricevere chiamate da .

Resi
`@Nullable CustomTabsSession`	Un'istanza `CustomTabsSession` da utilizzare per l'intent di Custom Tabs quando si apre una pagina di Custom Tabs.

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

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

setAppVolume

public static void setAppVolume(float volume)

Imposta il volume audio dell'applicazione. Modifica i volumi audio di tutti gli annunci rispetto all'altro 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
`float volume`	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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

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
`@NonNull Context context`	Il `Context` in cui è in esecuzione l'SDK.
`@NonNull List<PreloadConfiguration> preloadConfigurations`	Le configurazioni per precaricare gli annunci.
`@NonNull PreloadCallback preloadCallback`	Un callback da chiamare quando la disponibilità degli annunci cambia per ogni configurazione di precaricamento.