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

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

Класс GADMobileAds предоставляет глобальные настройки для управления определенной информацией, собираемой SDK Google Mobile Ads.

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

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

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

Для форматов рекламы «Открытие приложения», «Баннер», «Межстраничная реклама», «Реклама с вознаграждением» и «Межстраничная реклама с вознаграждением» вы можете передавать относительный объем рекламы в SDK Google Mobile Ads, установив свойство applicationVolume . Допустимые значения объема рекламы находятся в диапазоне от 0.0 (тихая реклама) до 1.0 (текущая громкость устройства). Вот пример того, как передать относительный объем рекламы в SDK:

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  MobileAds.shared.applicationVolume = 0.5
  ...
}

- (void)viewDidLoad {
  [super viewDidLoad];
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance.applicationVolume = 0.5;
  ...
}

Для форматов рекламы «Открытие приложения», «Баннер», «Межстраничная реклама», «Реклама с вознаграждением» и «Межстраничная реклама с вознаграждением» вы можете сообщить Google Mobile Ads SDK о том, что звук в приложении отключен, установив свойство applicationMuted :

MobileAds.shared.applicationMuted = true

GADMobileAds.sharedInstance.applicationMuted = YES;

По умолчанию applicationVolume установлен на 1 (текущая громкость устройства), а applicationMuted — на NO .

Нативная реклама

Инструкции по управлению настройками отключения звука см. в GADVideoOptions . Для нативной рекламы регулировка громкости вручную не поддерживается.

Аудиосессии

Аудиосессии позволяют передать системе ваши намерения относительно звукового поведения вашего приложения. Дополнительную информацию об аудиосессиях можно найти в руководстве Apple по программированию аудиосессий . Управление звуком в Google Mobile Ads SDK осуществляется через свойство audioVideoManager .

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

В менеджере аудио-видео вы можете установить свойство audioSessionIsApplicationManaged в YES , если хотите самостоятельно управлять категорией аудиосессий.

Если вы хотите управлять категорией аудиосессии, вы можете реализовать интерфейс GADAudioVideoManagerDelegate и установить свойство delegate в менеджере аудио- и видео, чтобы получать уведомления о событиях воспроизведения рекламных видеороликов и аудио. Затем вам следует изменить категорию аудиосессии на соответствующую категорию в соответствии с руководством Apple по программированию аудиосессий .

Ниже приведён упрощённый пример кода, демонстрирующий рекомендуемый подход, если ваше приложение воспроизводит музыку с использованием указанных выше API:

func setUp() {
  MobileAds.shared.audioVideoManager.delegate = self
  MobileAds.shared.audioVideoManager.audioSessionIsApplicationManaged = false
}

// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Google Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  MyAppObject.shared.pauseAllMusic()
}

func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Google Mobile Ads SDK is notifying your app that it has stopped playing
  // audio. Depending on your design, you could resume music here.
  MyAppObject.shared.resumeAllMusic()
}

- (void)setUp {
  GADMobileAds.sharedInstance.audioVideoManager.delegate = self;
  GADMobileAds.sharedInstance.audioVideoManager.audioSessionIsApplicationManaged = NO;
}

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // Google Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  [MyAppObject.sharedInstance pauseAllMusic];
}

- (void)audioVideoManagerDidStopPlayingAudio:(GADAudioVideoManager *)audioVideoManager {
    // Google Mobile Ads SDK is notifying your app that it has stopped playing
    // audio. Depending on your design, you could resume music here.
  [MyAppObject.sharedInstance resumeAllMusic];
}

Сообщение о дорожно-транспортных происшествиях

Google Mobile Ads SDK анализирует исключения, возникающие в iOS-приложении, и записывает их, если они вызваны SDK. Затем эти исключения устраняются в будущих версиях SDK.

Функция отслеживания сбоев включена по умолчанию. Если вы не хотите, чтобы регистрировались исключения, связанные с SDK, вы можете отключить эту функцию, вызвав метод disableSDKCrashReporting . Лучше всего вызывать этот метод при запуске приложения:

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    MobileAds.shared.disableSDKCrashReporting()
    return true
  }
}

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

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

Если у вашего приложения есть особые требования, вы можете установить необязательный параметр NSUserDefaults gad_has_consent_for_cookies . Google Mobile Ads SDK включает ограниченную рекламу (LTD), если параметр gad_has_consent_for_cookies установлен на ноль.

UserDefaults.standard.set(0, forKey: "gad_has_consent_for_cookies")

NSUserDefaults.standardUserDefaults().setObject(Int(0),
    forKey: "gad_has_consent_for_cookies");