Ustawienia globalne

Wybierz platformę: Android Android iOS Unity

Klasa MobileAds zawiera ustawienia globalne wtyczki Google Mobile Ads Unity Plugin.

Wywoływanie zdarzeń reklamowych w głównym wątku Unity

Google Mobile Ads Unity Plugin wywołuje zdarzenia w innym wątku niż główny wątek Unity. Jeśli implementujesz zdarzenia reklamowe i wchodzisz w interakcję z obiektami Unity, musisz zsynchronizować zdarzenia Google Mobile Ads Unity Plugin z głównym wątkiem Unity.

Zdarzenia reklamowe możesz synchronizować z głównym wątkiem Unity ręcznie lub automatycznie, pozwalając Google Mobile Ads Unity Plugin na obsługę synchronizacji.

Zalecane: ręczne synchronizowanie zdarzeń reklamowych

Aby ręcznie zsynchronizować zdarzenia reklamowe, użyj metody ExecuteInUpdate w głównym wątku. Musisz użyć metody ExecuteInUpdate podczas interakcji z obiektami UnityEngine i gdy właściwość RaiseAdEventsOnUnityMainThread jest wyłączona.

W tym przykładzie rejestrowany jest wątek w tle i wykonywane jest działanie w celu interakcji z obiektami 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.
    });
};

Automatyzowanie synchronizacji zdarzeń reklamowych

Aby Google Mobile Ads Unity Plugin synchronizował zdarzenia reklamowe, ustaw MobileAds.RaiseAdEventsOnUnityMainThread właściwość na 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;
    }
}

Kontrolowanie głośności reklam wideo

Jeśli aplikacja ma własne elementy sterujące głośnością, np. głośność niestandardowej muzyki lub efektów dźwiękowych, ujawnienie głośności aplikacji wtyczce Google Mobile Ads Unity umożliwia reklamom wideo dostosowanie się do ustawień głośności aplikacji.Google Mobile Ads Unity Plugin Dzięki temu użytkownicy będą otrzymywać reklamy wideo z oczekiwaną głośnością.

Głośność urządzenia, kontrolowana za pomocą przycisków głośności lub suwaka głośności na poziomie systemu operacyjnego, określa głośność wyjścia audio urządzenia. Aplikacje mogą jednak niezależnie dostosowywać poziom głośności względem głośności urządzenia, aby dostosować wrażenia dźwiękowe.

Możesz zgłosić względną głośność aplikacji wtyczce Google Mobile Ads Unity Plugin, wywołując metodę SetApplicationVolume() przed wczytaniem reklamy. Prawidłowe wartości głośności reklamy mieszczą się w zakresie od 0.0 (cisza) do 1.0 (bieżąca głośność urządzenia). Oto przykład, jak zgłosić względną głośność aplikacji w pakiecie SDK:

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

Aby poinformować pakiet SDK, że głośność aplikacji została wyciszona, wywołaj metodę SetApplicationMuted() przed wczytaniem reklamy:

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

Domyślnie głośność aplikacji jest ustawiona na 1 (bieżąca głośność urządzenia), a aplikacja nie jest wyciszona.

Zgoda na pliki cookie

Jeśli Twoja aplikacja ma specjalne wymagania, możesz ustawić opcjonalny ApplicationPreferences klucz gad_has_consent_for_cookies na zero, aby włączyć ograniczone wyświetlanie reklam :

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

Minimalizacja kodu na Androidzie

Ta opcja publikowania w Unity umożliwia włączenie minimalizacji kodu Java. Jeśli włączysz minimalizację, musisz też utworzyć niestandardowy plik ProGuard, aby zachować klasy, do których odwołuje się pakiet SDK.

1. Włącz niestandardowy plik ProGuard

   Otwórz kolejno Ustawienia projektu > Odtwarzacz > Android > Ustawienia publikowania > Kompilacja, i wybierz:

   • Niestandardowy plik ProGuard

2. Otwórz plik /Assets/Plugins/Android/proguard-user.txt i dodaj te wiersze:

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

Wyłączanie zgłaszania błędów

Google Mobile Ads Unity Plugin zbiera raporty o awariach na potrzeby debugowania i analizy celów. Możesz wyłączyć zgłaszanie błędów za pomocą tego kodu. W kolejnych sekcjach opisujemy, jak wyłączyć zgłaszanie błędów na Androidzie i 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();
}

Pobieranie wersji wtyczki Unity

Aby pobrać wersję pakietu SDK Unity, uruchom to polecenie:

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

Pobieranie wersji platformy

Google Mobile Ads Unity Plugin dla Unity zależy od pakietów SDK platform Android i iOS. Aby pobrać wersję pakietu SDK platformy, uruchom to polecenie:

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