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

Выберите платформу: Android (бета-версия) Android iOS Unity

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

Размещайте рекламные объявления в основной ветке обсуждения Unity.

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

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

Рекомендуется: синхронизировать рекламные события вручную.

Для синхронизации рекламных событий вручную используйте метод ExecuteInUpdate в основном потоке. Метод ExecuteInUpdate необходимо использовать при взаимодействии с объектами UnityEngine и при отключенном свойстве RaiseAdEventsOnUnityMainThread .

В следующем примере запускается фоновый поток, который затем выполняет действие для взаимодействия с объектами 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.
    });
};

Автоматическая синхронизация по рекламным событиям

Для синхронизации событий рекламы с помощью Google Mobile Ads SDK установите свойство MobileAds.RaiseAdEventsOnUnityMainThread в 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;
    }
}

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

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

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

Вы можете передать относительный уровень громкости приложения в SDK Google Mobile Ads, вызвав метод 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 в значение ноль, чтобы включить показ ограниченного количества рекламы :

// Enable limited ads
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.

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

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

Получить версию плагина Unity

Чтобы получить версию Unity SDK, выполните следующую команду:

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

Получить версию платформы

SDK Google Mobile Ads для Unity зависит от SDK платформ Android и iOS. Чтобы узнать версию SDK для конкретной платформы, выполните следующую команду:

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