Impostazioni globali

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

Generare eventi correlati agli annunci nel thread principale di Unity

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

Se vuoi che sia l'SDK Mobile Ads a gestire questo problema di threading, imposta MobileAds.RaiseAdEventsOnUnityMainThread su true. In questo modo, l'SDK è costretto a generare tutti gli eventi e i callback nel thread principale di 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'attivazione di eventi nel thread principale di Unity è che alcuni eventi, come OnAdFullScreenContentOpened, non vengono attivati finché l'utente non torna nell'app.

Controllo del volume degli annunci video

Se la tua app ha i propri controlli del volume, ad esempio volume personalizzato di musica o effetti sonori, la divulgazione del volume dell'app all'SDK Google Mobile Ads consente agli annunci video di rispettare le impostazioni di volume dell'app. In questo modo, gli utenti vedranno gli 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'uscita audio del dispositivo. Tuttavia, le app possono regolare autonomamente i livelli di volume rispetto al volume del dispositivo per personalizzare l'esperienza audio.

Puoi segnalare il volume relativo delle app all'SDK Google Mobile Ads chiamando il metodo SetApplicationVolume(). I valori validi del volume dell'annuncio vanno da 0.0 (disattivato) a 1.0 (volume del dispositivo corrente). Ecco un esempio di come segnalare il volume relativo delle 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à agli annunci video e potrebbe ridurre le entrate pubblicitarie dell'app. Devi utilizzare questo metodo solo se la tua app fornisce all'utente controlli del volume personalizzati e il volume dell'utente è correttamente riportato nell'app.

Per informare l'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 dell'app è impostato su 1, il volume corrente del dispositivo, e l'audio dell'app non è disattivato.

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

Consenso per i cookie

Se la tua app presenta requisiti speciali, puoi impostare la chiave facoltativaApplicationPreferences gad_has_consent_for_cookies 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 di Unity ti consente di attivare la minimizzazione del codice Java. Se attivi 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 *; }

Disattivare la segnalazione degli arresti anomali

L'SDK Google Mobile Ads raccoglie i report sugli arresti anomali per scopi di debug e analisi. Puoi disattivare questa segnalazione degli arresti anomali con il seguente codice. Le seguenti sezioni descrivono come disattivare i report sugli arresti anomali su Android e iOS.

Android

Aggiungi il tag <meta-data> con DISABLE_CRASH_REPORTING impostato su true nel file AndroidManifest.xml della tua app:

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

iOS

Chiama il metodo DisableSDKCrashReporting per disattivare i report sugli arresti anomali su iOS:

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}

Recupera la versione del plug-in Unity

Per ottenere la versione dell'SDK Unity, esegui il seguente comando:

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

Recupera la versione della piattaforma

L'SDK Google Mobile Ads per Unity dipende dagli SDK delle piattaforme Android e iOS. Per ottenere la versione dell'SDK della piattaforma, esegui quanto segue:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());