Impostazioni globali

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

Genera eventi pubblicitari sul thread principale di Unity

L'SDK Google Mobile Ads genera eventi su un thread diverso da quello principale di Unity. Se implementi eventi annuncio e interagisci con gli oggetti Unity, devi sincronizzare gli eventi dell'SDK Mobile Ads con il thread principale di Unity.

Sincronizza gli eventi annuncio con il thread principale di Unity manualmente o automaticamente, consentendo all'SDK Google Mobile Ads di gestire la sincronizzazione.

Sincronizzare manualmente gli eventi pubblicitari

Per sincronizzare gli eventi annuncio, utilizza manualmente il metodo ExecuteInUpdate sul thread principale. Devi utilizzare il metodo quando la proprietà RaiseAdEventsOnUnityMainThread è disattivata e interagisce con gli oggetti UnityEngine.

L'esempio seguente registra un thread in background ed esegue un'azione per interagire con gli oggetti UnityEngine:

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
    });
};

Automatizzare la sincronizzazione degli eventi pubblicitari

Affinché l'SDK Google Mobile Ads sincronizzi gli eventi annuncio, imposta la proprietà MobileAds.RaiseAdEventsOnUnityMainThread su true:

...
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;
    }
}

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 riceveranno annunci video con il volume audio previsto.

Il volume del dispositivo, controllato tramite i tasti 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 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() prima di caricare l'annuncio. I valori validi del volume dell'annuncio sono compresi tra 0.0 (silenzioso) e 1.0 (volume del dispositivo attuale). 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);

Per comunicare all'SDK che il volume dell'app è stato disattivato, chiama il metodo SetApplicationMuted() prima di caricare l'annuncio:

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

Per impostazione predefinita, il volume dell'app è impostato su 1, il volume del dispositivo corrente, e l'audio dell'app non è disattivato.

Consenso all'uso dei cookie

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

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

Riduzione delle dimensioni di Android

Questa opzione di pubblicazione di Unity ti consente di attivare la riduzione del codice Java. Se abiliti la minificazione, devi anche creare un file Proguard personalizzato per conservare le classi a cui fa riferimento l'SDK.

1. Attiva file Proguard personalizzato

   Vai a Project Settings > Player > Android > Publishing Settings > Build (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 a scopo di debug e analisi. Puoi disattivare la segnalazione degli arresti anomali con il seguente codice. Le seguenti sezioni descrivono come disattivare i report sugli arresti anomali su Android e iOS.

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

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

Recupero versione del plug-in Unity

Per ottenere la versione dell'SDK Unity, esegui questo 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 della piattaforma Android e iOS. Per ottenere la versione dell'SDK della piattaforma, esegui il comando seguente:

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