Impostazioni generali

Seleziona la piattaforma: Android Android iOS Unity

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

Generare eventi di annunci sul thread principale di Unity

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

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

Consigliato: sincronizzare manualmente gli eventi di annunci

Per sincronizzare manualmente gli eventi di annunci, utilizza il metodo ExecuteInUpdate sul thread principale. Devi utilizzare il metodo ExecuteInUpdate quando interagisci con gli oggetti UnityEngine e mentre 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.
    });
};

Importante: il loop Update() di Unity ritarda tutto il codice inserito nel metodo ExecuteInUpdate. Devi inserire tutto il codice sensibile al tempo, come la telemetria o le entrate pubblicitarie a livello di impressione (ILAR) al di fuori del metodo ExecuteInUpdate.

Automatizzare la sincronizzazione degli eventi di annunci

Affinché Google Mobile Ads SDK sincronizzi gli eventi di annunci, imposta MobileAds.RaiseAdEventsOnUnityMainThread proprietà 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;
    }
}

Avviso: quando imposti MobileAds.RaiseAdEventsOnUnityMainThread su un true valore, gli eventi dell'annuncio attivati mentre il gioco è in pausa o in background vengono ritardati fino a quando l'utente non torna al gioco. Se l'utente chiude l'app durante questo periodo, questi eventi dell'annuncio ritardati vengono eliminati completamente. I publisher che hanno impostato MobileAds.RaiseAdEventsOnUnityMainThread su true hanno segnalato una discrepanza fino al 30% nella generazione di report sulle entrate pubblicitarie a livello di impressione. Consiglio:sincronizza manualmente i singoli annunci invece.

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 volumes, la comunicazione 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 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 in modo indipendente i livelli di volume rispetto al volume del dispositivo per personalizzare l'esperienza audio.

Puoi comunicare 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 vanno da 0.0 (silenzioso) a 1.0 (volume del dispositivo corrente). Ecco un esempio di come comunicare il volume relativo dell'app all'SDK:

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

Avviso: la riduzione del volume 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 controlli del volume personalizzati e il volume dell'utente viene visualizzato correttamente nell'app.

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.

**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 di disattivazione dell'audio personalizzato e la decisione dell'utente di disattivare l'audio viene visualizzata correttamente nell'app.

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 :

// Enable limited ads
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 conservare le classi a cui fa riferimento l'SDK.

1. Attiva il 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 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 la segnalazione degli arresti anomali su Android e iOS.

Android

Aggiungi il tag <meta-data> con DISABLE_CRASH_REPORTING impostato su true in 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();
}

Recuperare la versione del plug-in Unity

Per recuperare la versione dell'SDK Unity, esegui questo comando:

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

Recuperare la versione della piattaforma

L'Google Mobile Ads SDK per Unity dipende dagli SDK della piattaforma Android e iOS. Per recuperare la versione dell'SDK della piattaforma, esegui questo comando:

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