Ustawienia globalne

Klasa MobileAds zawiera ustawienia globalne pakietu SDK do reklam mobilnych Google.

Zgłaszanie zdarzeń reklamowych w głównym wątku Unity

Pakiet SDK do reklam mobilnych Google przesyła zdarzenia w innym wątku niż w wątku głównym Unity. Jeśli implementujesz zdarzenia reklamowe i korzystasz z obiektów Unity, musisz zsynchronizować zdarzenia pakietu SDK do reklam mobilnych z wątkiem głównym Unity.

Jeśli chcesz, aby pakiet SDK do reklam mobilnych rozwiązał ten problem z wątkami, ustaw MobileAds.RaiseAdEventsOnUnityMainThread na true. Wymusza to raportowanie przez pakiet SDK wszystkich zdarzeń i wywołań zwrotnych w wątku głównym 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;
    }
}

Uwaga: efekt uboczny wywoływania zdarzeń w wątku głównym Unity oznacza, że niektóre zdarzenia, takie jak OnAdFullScreenContentOpened, nie są wywoływane, dopóki użytkownik nie wróci do aplikacji.

Regulacja głośności reklam wideo

Jeśli aplikacja ma własną regulację głośności, np. głośność niestandardowej muzyki lub efektów dźwiękowych, podanie głośności aplikacji w pakiecie SDK do reklam mobilnych Google umożliwi wyświetlanie reklam wideo zgodnie z ustawieniami głośności w aplikacji. Dzięki temu użytkownicy będą widzieć reklamy wideo z oczekiwaną głośnością dźwięku.

Głośność urządzenia, określana za pomocą przycisków 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 regulować głośność w zależności od głośności urządzenia, aby dostosować wrażenia dźwiękowe.

Możesz raportować względną liczbę aplikacji w pakiecie SDK do reklam mobilnych Google, wywołując metodę SetApplicationVolume(). Prawidłowe wartości liczby reklam z zakresu od 0.0 (wyciszone) do 1.0 (aktualna głośność na urządzeniu). Oto przykład, jak zgłosić względną liczbę aplikacji pakietowi SDK:

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

Ostrzeżenie: zmniejszenie głośności dźwięku w aplikacji uniemożliwia wyświetlanie reklam wideo i może zmniejszyć przychody z reklam. Tej metody należy używać tylko wtedy, gdy aplikacja zapewnia użytkownikowi niestandardowe elementy sterujące głośnością, a jego głośność jest odpowiednio odzwierciedlana w aplikacji.

Aby poinformować pakiet SDK o wyciszeniu aplikacji, użyj metody SetApplicationMuted():

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

Domyślnie głośność aplikacji jest ustawiona na 1, a aplikacja nie jest wyciszona, a na urządzeniu jest aktualna głośność.

Ostrzeżenie: wyciszenie aplikacji zmniejsza możliwość wyświetlania reklam wideo i może zmniejszyć przychody z reklam w aplikacji. Tej metody należy używać tylko wtedy, gdy aplikacja zapewnia użytkownikowi niestandardowe elementy sterujące wyciszeniem, a jego decyzja o wyciszeniu jest prawidłowo odzwierciedlana w aplikacji.

Zgoda na pliki cookie

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

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

Minimalizacja Androida

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

1. Włącz niestandardowy plik Proguard

   Wybierz Ustawienia projektu > Odtwarzacz > Android > Ustawienia publikowania > Kompilacja i wybierz:

   • Niestandardowy plik Proguard

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

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