Impostazioni globali

Seleziona la piattaforma: Android (beta) Nuovo Android iOS Unity

Il corso MobileAds fornisce impostazioni globali per Google Mobile Ads SDK.

Generare eventi pubblicitari sul thread principale di Unity

Google Mobile Ads SDK genera eventi su un thread diverso dal thread principale di Unity. Se implementi eventi pubblicitari e interagisci con gli oggetti Unity, devi sincronizzare gli eventi Google Mobile Ads SDK con il thread principale di Unity.

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

Consigliato: sincronizza manualmente gli eventi annuncio

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

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.
    // Place all time-sensitive code outside of ExecuteInUpdate().
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
        // This method is delayed, don't put time sensitive code here.
    });
};

Automatizzare la sincronizzazione degli eventi pubblicitari

Per sincronizzare gli eventi pubblicitari per Google Mobile Ads SDK, 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 a Google Mobile Ads SDK 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 a Google Mobile Ads SDK 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 corrente). 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.

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 :

// Enable limited ads
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 minimizzazione, 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, 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

Google Mobile Ads SDK raccoglie 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.

Android

Aggiungi il tag <meta-data> con DISABLE_CRASH_REPORTING impostato su true nel file AndroidManifest.xml dell'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();
}

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

Google Mobile Ads SDK per Unity dipende dagli SDK per le piattaforme 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());