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

Выберите платформу: Android iOS Unity

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

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

Если в вашем приложении есть собственные регуляторы громкости, например, пользовательская музыка или звуковые эффекты, предоставление данных о громкости приложения в 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
  ...
}

Objective-C 

- (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

Objective-C 

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()
}

Objective-C 

- (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
  }
}

Objective-C 

@import GoogleMobileAds;

@implementation AppDelegate

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

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

Если у вашего приложения особые требования, вы можете установить необязательный параметр 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")

Objective-C 

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