Impostazioni globali

La classe MobileAds fornisce le impostazioni globali per l'SDK Google Mobile Ads.

Genera eventi annuncio nel thread principale Unity

L'SDK Google Mobile Ads genera eventi in un thread diverso rispetto al thread principale Unity. Se implementi eventi annuncio e interagisci con gli oggetti Unity, devi sincronizzare gli eventi dell'SDK Mobile Ads con il thread principale Unity.

Se vuoi che l'SDK Mobile Ads gestisca questo problema di thread, imposta MobileAds.RaiseAdEventsOnUnityMainThread su true. Questo obbliga l'SDK a generare tutti gli eventi e i callback sul thread principale Unity.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

Nota: un effetto collaterale dell'aumento di eventi nel thread principale di Unity significa che determinati eventi come OnAdFullScreenContentOpened non vengono generati finché l'utente non torna nell'app.

Controllo del volume degli annunci video

Se la tua app dispone di propri controlli del volume, ad esempio volumi personalizzati di musica o effetti sonori, la comunicazione del volume dell'app all'SDK Google Mobile Ads consente agli annunci video di rispettare le impostazioni di volume delle app. In questo modo, gli utenti ricevono annunci video con il volume audio previsto.

Il volume del dispositivo, controllato tramite i pulsanti del volume o il cursore del volume a livello di sistema operativo, determina il volume dell'output audio del dispositivo. Tuttavia, le app possono regolare in modo indipendente i livelli di volume rispetto al volume del dispositivo per personalizzare l'esperienza audio.

Puoi segnalare il volume relativo dell'app all'SDK Google Mobile Ads chiamando il metodo SetApplicationVolume(). I valori validi del volume di annunci sono compresi tra 0.0 (silenzioso) e 1.0 (volume attuale del dispositivo). Ecco un esempio di come segnalare il volume relativo dell'app all'SDK:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

Avviso: abbassare il volume audio dell'app riduce l'idoneità degli annunci video e potrebbe ridurre le entrate pubblicitarie dell'app. Dovresti utilizzare questo metodo solo se la tua app fornisce controlli del volume personalizzati all'utente e il volume dell'utente è rispecchiato correttamente nell'app.

Per comunicare all'SDK che il volume dell'app è stato disattivato, utilizza il metodo SetApplicationMuted():

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

Per impostazione predefinita, il volume delle app è impostato su 1, il volume attuale del dispositivo e l'audio dell'app non sono disattivati.

Avviso: la disattivazione dell'app riduce l'idoneità degli annunci video e potrebbe ridurre le entrate pubblicitarie dell'app. Dovresti utilizzare questo metodo solo se la tua app fornisce all'utente un controllo di disattivazione personalizzato e la decisione di disattivazione dell'utente si riflette correttamente nell'app.

Consenso per i cookie

Se la tua app ha requisiti speciali, puoi impostare la chiave ApplicationPreferencesgad_has_consent_for_cookies facoltativa su zero per attivare gli annunci con limitazioni (LTD):

// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Minimizzazione Android

Questa opzione di pubblicazione Unity consente di attivare la minimizzazione del codice Java. Se abiliti la minimizzazione, dovrai anche creare un file ProGuard personalizzato per mantenere le classi a cui fa riferimento l'SDK.

1. Attiva file Proguard personalizzato

   Vai a Impostazioni progetto > Player > Android > Impostazioni di pubblicazione > Build e seleziona:

   • File ProGuard personalizzato

2. Apri /Assets/Plugins/Android/proguard-user.txt e aggiungi quanto segue:

-keep class com.google.** { public *; }