Глобальные настройки

Класс MobileAds предоставляет глобальные настройки для Google Mobile Ads SDK.

Вызов рекламных событий в главном потоке Unity

Google Mobile Ads SDK генерирует события в другом потоке, отличном от основного потока Unity. Если вы реализуете рекламные события и взаимодействуете с объектами Unity, вам необходимо синхронизировать события Mobile Ads SDK с основным потоком Unity.

Если вы хотите, чтобы Mobile Ads SDK решил эту проблему за вас, установите для MobileAds.RaiseAdEventsOnUnityMainThread значение true . Это заставляет SDK вызывать все события и обратные вызовы в основном потоке 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;
    }
}

Примечание. Побочный эффект возникновения событий в основном потоке Unity означает, что определенные события, такие как OnAdFullScreenContentOpened не вызываются до тех пор, пока пользователь не вернется в приложение.

Регулятор громкости видеорекламы

Если в вашем приложении есть собственные элементы управления громкостью, например громкость музыки или звуковых эффектов, раскрытие громкости приложения Google Mobile Ads SDK позволяет видеорекламе учитывать настройки громкости приложения. Это гарантирует, что пользователи будут получать видеорекламу с ожидаемой громкостью звука.

Громкость устройства, управляемая с помощью кнопок громкости или ползунка громкости на уровне ОС, определяет громкость вывода звука устройства. Однако приложения могут независимо регулировать уровни громкости относительно громкости устройства, чтобы адаптировать качество звука.

Вы можете сообщить об относительном объеме приложений в Google Mobile Ads SDK, вызвав метод SetApplicationVolume() . Допустимые значения громкости рекламы варьируются от 0.0 (без звука) до 1.0 (громкость текущего устройства). Вот пример того, как сообщить об относительном объеме приложения в SDK:

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

Предупреждение. Уменьшение громкости звука в вашем приложении снижает возможность показа видеорекламы и может снизить доход от рекламы вашего приложения. Вам следует использовать этот метод только в том случае, если ваше приложение предоставляет пользователю настраиваемые элементы управления громкостью, и громкость пользователя правильно отражена в приложении.

Чтобы сообщить SDK, что громкость приложения отключена, используйте метод SetApplicationMuted() :

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

По умолчанию для громкости приложения установлено значение 1 , громкость текущего устройства, и звук в приложении не отключен.

Предупреждение. Отключение звука в вашем приложении снижает возможность показа видеорекламы и может снизить доход от рекламы вашего приложения. Вам следует использовать этот метод только в том случае, если ваше приложение предоставляет пользователю настраиваемый элемент управления отключением звука, и решение пользователя об отключении звука правильно отражено в приложении.

Согласие на использование файлов cookie

Если у вашего приложения есть особые требования, вы можете установить для дополнительного ключа ApplicationPreferences gad_has_consent_for_cookies значение 0, чтобы включить ограниченную рекламу (LTD) :

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

Минимизация Android

Этот вариант публикации Unity позволяет включить минификацию Java-кода . Если вы включите минификацию, вам также потребуется создать собственный файл proguard для хранения классов, на которые ссылается SDK.

1. Включить пользовательский файл Proguard

   Перейдите в «Настройки проекта» > «Плеер» > «Android» > «Настройки публикации» > «Сборка» и выберите:

   • Пользовательский файл Proguard

2. Откройте /Assets/Plugins/Android/proguard-user.txt и добавьте следующее:

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

Отключить отчеты о сбоях

Google Mobile Ads SDK собирает отчеты о сбоях для целей отладки и анализа. Вы можете отключить отчет о сбоях с помощью следующего кода. В следующих разделах описано, как отключить отчеты о сбоях на Android и iOS.

Андроид

Добавьте тег <meta-data> со true DISABLE_CRASH_REPORTING в файл AndroidManifest.xml вашего приложения:

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

iOS

Вызовите метод DisableSDKCrashReporting , чтобы отключить отчеты о сбоях в iOS:

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