Ustawienia globalne

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

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

Pakiet SDK do reklam mobilnych Google generuje zdarzenia w innym wątku niż główny wątek Unity. Jeśli implementujesz zdarzenia reklamy i nawiązujesz interakcję z obiektmi Unity, musisz zsynchronizować zdarzenia pakietu SDK do reklam mobilnych z głównym wątkiem Unity.

Jeśli chcesz, aby pakiet SDK do reklam mobilnych rozwiązał ten problem z wątkami, ustaw wartość parametru MobileAds.RaiseAdEventsOnUnityMainThread na true. Wymusza to na SDK zgłaszanie wszystkich zdarzeń i wyzwań zwrotnych na głównym wątku 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: wywoływanie zdarzeń w głównym wątku Unity powoduje, że niektóre zdarzenia, np. OnAdFullScreenContentOpened, nie są wywoływane, dopóki użytkownik nie wróci do aplikacji.

Kontrolowanie 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, ujawnienie głośności aplikacji pakietowi SDK do reklam mobilnych Google umożliwia reklamom wideo dostosowanie się do ustawień głośności aplikacji. Dzięki temu użytkownicy będą oglądać reklamy wideo z zamierzonym poziomem głośności.

Głośność wyjścia audio 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ć poziomy głośności w zależności od głośności urządzenia, aby dostosować jakość dźwięku.

W pakiecie SDK do reklam mobilnych Google możesz zgłaszać względną liczbę aplikacji, wywołując metodę SetApplicationVolume(). Prawidłowe wartości głośności reklam mieszczą się w zakresie od 0.0 (wyciszanie) do 1.0 (bieżąca głośność urządzenia). Oto przykład raportowania względnej liczby aplikacji do pakietu SDK:

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

Ostrzeżenie: obniżenie głośności dźwięku w aplikacji zmniejsza kwalifikowalność reklam wideo i może obniżyć przychody z reklam w aplikacji. Z tej metody należy korzystać tylko wtedy, gdy aplikacja zapewnia użytkownikowi możliwość sterowania głośnością i poziom głośności jest prawidłowo odzwierciedlany w aplikacji.

Aby poinformować pakiet SDK, że dźwięk w aplikacji został wyciszony, użyj metody SetApplicationMuted():

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

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

Ostrzeżenie: wyciszenie aplikacji zmniejsza zgodność z wymaganiami dotyczącymi reklam wideo i może zmniejszyć przychody z reklam w aplikacji. Z tej metody należy korzystać tylko wtedy, gdy aplikacja umożliwia użytkownikowi stosowanie niestandardowego wyciszenia i jego decyzja w tej sprawie jest odpowiednio odzwierciedlana w aplikacji.

Zgoda na pliki cookie

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

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

Kompilacja na Androida

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

1. Włączanie niestandardowego pliku Proguard

   Kliknij Ustawienia projektu > Odtwarzacz > Android > Ustawienia publikacji > Kompilacja i wybierz:

   • Niestandardowy plik Proguard

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

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

Wyłączanie zgłaszania awarii

Pakiet SDK do reklam mobilnych Google zbiera raporty o awariach na potrzeby debugowania i analizy. Możesz wyłączyć raportowanie awarii za pomocą tego kodu. W tych sekcjach dowiesz się, jak wyłączyć zgłaszanie awarii na Androidzie i iOS.

Android

Dodaj tag <meta-data>, w którym parametr DISABLE_CRASH_REPORTING ma wartość true, w pliku AndroidManifest.xml aplikacji:

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

iOS

Aby wyłączyć raporty o awariach na iOS, wywołaj metodę DisableSDKCrashReporting:

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