Configurações globais

A classe GADMobileAds fornece configurações globais para controlar determinadas informações coletadas pelo SDK dos anúncios para dispositivos móveis.

Controle de volume do anúncio em vídeo

Se o app tiver controles de volume próprios, como ajustes personalizados de música ou efeitos sonoros, a divulgação do volume do app ao SDK dos anúncios para dispositivos móveis do Google permite que os anúncios em vídeo respeitem as configurações de volume do app. Isso garante que os usuários recebam anúncios em vídeo com o volume de áudio esperado.

O volume do dispositivo, controlado por botões de volume ou pelo controle deslizante de volume no nível do SO, determina o volume da saída de áudio do dispositivo. No entanto, os apps podem ajustar de forma independente os níveis de volume em relação ao volume do dispositivo para personalizar a experiência de áudio.

Para formatos de anúncio de abertura do app, banner, intersticial, premiado e intersticial premiado, é possível informar o volume relativo do app ao SDK dos anúncios para dispositivos móveis do Google definindo a propriedade applicationVolume. Os valores válidos de volume do anúncio variam de 0.0 (silêncio) a 1.0 (volume atual do dispositivo). Confira um exemplo de como relatar o volume relativo do app ao SDK:

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

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

Para formatos de anúncio de abertura de app, banner, intersticial, premiado e intersticial premiado, é possível informar ao SDK dos anúncios para dispositivos móveis do Google que o volume do app foi desativado definindo a propriedade applicationMuted:

GADMobileAds.sharedInstance().applicationMuted = true

GADMobileAds.sharedInstance.applicationMuted = YES;

Por padrão, applicationVolume é definido como 1 (o volume atual do dispositivo) e applicationMuted é definido como NO.

Anúncios nativos

Consulte GADVideoOptions para instruções sobre como controlar as configurações de silenciamento. Os anúncios nativos não têm suporte para controle de volume personalizado.

Sessões de áudio

As sessões de áudio permitem que você expresse ao sistema suas intenções para o comportamento de áudio do app. Confira mais informações sobre sessões de áudio no Guia de programação de sessões de áudio da Apple. As opções disponíveis para gerenciar o áudio do SDK dos anúncios para dispositivos móveis do Google estão na propriedade audioVideoManager.

Se você não usa áudio no app, não precisa usar essas APIs. O SDK dos anúncios para dispositivos móveis do Google gerencia automaticamente a categoria de sessão de áudio quando reproduz áudio. Se você reproduz áudio no seu app e quer controlar melhor como e quando o SDK dos anúncios para dispositivos móveis do Google reproduz áudio, use essas APIs.

No gerenciador de áudio e vídeo, é possível definir a propriedade audioSessionIsApplicationManaged como YES se você quiser assumir a responsabilidade de gerenciar a categoria de sessão de áudio.

Se você quiser gerenciar a categoria de sessão de áudio, implemente GADAudioVideoManagerDelegate e defina a propriedade delegate no gerenciador de áudio e vídeo para receber notificações sobre eventos de reprodução de vídeo e áudio de anúncios. Em seguida, mude a categoria da sessão de áudio para a relevante de acordo com o guia de programação de sessões de áudio da Apple.

Confira um exemplo de código simplificado que mostra a abordagem recomendada se o app toca música usando as APIs acima:

func setUp() {
  GADMobileAds.sharedInstance().audioVideoManager.delegate = self
  GADMobileAds.sharedInstance().audioVideoManager.audioSessionIsApplicationManaged = false
}

// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The 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()
}

func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The 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()
}

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

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // The 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 {
    // The 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];
}

Crash reporting

O SDK dos anúncios para dispositivos móveis do Google inspeciona exceções que ocorrem em um app para iOS e as registra se elas foram causadas pelo SDK. Essas exceções são tratadas em versões futuras do SDK.

O relatório de erros é ativado por padrão. Se você não quiser que as exceções relacionadas ao SDK sejam gravadas, desative esse recurso chamando o método disableSDKCrashReporting. O melhor momento para chamar esse método é quando o app é iniciado:

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    GADMobileAds.disableSDKCrashReporting()
    return true
  }
}

@import GoogleMobileAds;

@implementation AppDelegate

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

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

Concessão de consentimento para as configurações de cookies

Se o app tiver requisitos especiais, defina o NSUserDefaults gad_has_consent_for_cookies opcional. O SDK dos anúncios para dispositivos móveis do Google ativa anúncios limitados (LTD, na sigla em inglês) se a preferência gad_has_consent_for_cookies for definida como zero.

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

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