Configurações globais

Selecione a plataforma: Android Android iOS Unity

A classe GADMobileAds oferece configurações globais para controlar determinadas informações coletadas por Google Mobile Ads SDK.

Controle de volume do anúncio em vídeo

Observação: os controles de volume de vídeo se aplicam apenas aos anúncios do Google e não são encaminhados para redes de mediação.

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 para Google Mobile Ads SDK 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 pelos 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 os níveis de volume de forma independente em relação ao volume do dispositivo para personalizar a experiência de áudio.

Para os formatos de anúncio de abertura do app, de banner, intersticial, premiado e intersticial premiado, é possível informar o volume relativo do app ao Google Mobile Ads SDK definindo a propriedade applicationVolume. Os valores válidos de volume de anúncios variam de 0.0 (silencioso) a 1.0 (volume atual do dispositivo). Confira um exemplo de como informar o volume relativo do app ao SDK:

Swift

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;
  ...
}

Aviso:diminuir o volume de áudio do app reduz a qualificação do anúncio em vídeo e pode reduzir a receita de anúncios do app. Use essa API apenas se o app fornecer controles de volume personalizados ao usuário e o volume do usuário for refletido corretamente na API.

Para os formatos de anúncio de abertura do app, de banner, intersticial, premiado e anúncio intersticial premiado , é possível informar ao Google Mobile Ads SDK que o volume do app foi silenciado definindo a propriedade applicationMuted:

Swift

MobileAds.shared.applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

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

Aviso:silenciar o app reduz a qualificação do anúncio em vídeo e pode reduzir a receita de anúncios do app. Use essa API apenas se o app fornecer um controle de silêncio personalizado ao usuário e a decisão de silenciar do usuário for refletida corretamente na API.

Anúncios nativos

Consulte GADVideoOptions para instruções sobre como controlar as configurações de silêncio. Para anúncios nativos, não há 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. Mais informações sobre sessões de áudio podem ser encontradas no Guia de programação de sessões de áudio da Apple. As opções disponíveis para gerenciar Google Mobile Ads SDK áudio estão disponíveis na propriedade.audioVideoManager

Se você não usa áudio no app, não precisa usar essas APIs. Google Mobile Ads SDK gerencia automaticamente a categoria de sessão de áudio quando reproduz áudio. Se você reproduzir áudio no app e quiser um controle mais rígido de como e quando Google Mobile Ads SDK reproduz áudio, use essas APIs.

No gerenciador de áudio e vídeo, defina a audioSessionIsApplicationManaged propriedade como YES se 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 delegate propriedade no gerenciador de áudio e vídeo para receber notificações de eventos de reprodução de vídeo e áudio. Em seguida, mude a categoria de sessão de áudio para a categoria relevante de acordo com o Guia de programação de sessões de áudio da Apple.

Ponto-chave: Por padrão, o SDK define a categoria de sessão de áudio como AVAudioSessionCategoryAmbient ao reproduzir anúncios silenciados. Se você preferir que seu app use AVAudioSessionCategoryOptionDuckOthers nesse cenário, implemente o protocolo GADAudioVideoManagerDelegate e defina o gerenciador de áudio e vídeo audioSessionIsApplicationManaged como YES.

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

Swift

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];
}

Crash reporting

Google Mobile Ads SDK inspeciona as exceções que ocorrem em um app 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 está ativado por padrão. Se você não quiser que as exceções relacionadas ao SDK sejam registradas, desative esse recurso chamando o método disableSDKCrashReporting. O melhor momento para chamar esse método é quando o app é iniciado:

Swift

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

Consentimento para configurações de cookies

Se o app tiver requisitos especiais, defina o opcional NSUserDefaults gad_has_consent_for_cookies. Google Mobile Ads SDK ativa anúncios limitados (LTDs) se a preferência gad_has_consent_for_cookies estiver definida como zero.

Swift

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

Objective-C

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