Impostazioni generali

Seleziona la piattaforma: Android Android iOS Unity

La classe GADMobileAds fornisce impostazioni globali per controllare determinate informazioni raccolte da Google Mobile Ads SDK.

Controllo del volume degli annunci video

Nota: i controlli del volume dei video si applicano solo agli annunci Google e non vengono inoltrati alle reti di mediazione.

Se la tua app ha i propri controlli del volume, ad esempio volume personalizzato di musica o effetti sonori, la comunicazione del volume dell'app a Google Mobile Ads SDK consente agli annunci video di rispettare le impostazioni di volume dell'app. In questo modo, gli utenti ricevono annunci video con il volume audio previsto.

Il volume del dispositivo, controllato tramite i pulsanti del volume o il cursore del volume a livello di sistema operativo, determina il volume dell'uscita audio del dispositivo. Tuttavia, le app possono regolare in modo indipendente i livelli di volume rispetto al volume del dispositivo per personalizzare l'esperienza audio.

Per i formati degli annunci apertura app, banner, interstitial, con premio e interstitial con premio, puoi comunicare il volume relativo dell'app a Google Mobile Ads SDK impostando la proprietà applicationVolume. I valori validi del volume degli annunci vanno da 0.0 (silenzioso) a 1.0 (volume del dispositivo corrente). Ecco un esempio di come comunicare il volume relativo dell'app all'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;
  ...
}

Avviso:la riduzione del volume audio dell'app riduce l'idoneità degli annunci video e potrebbe ridurre le entrate pubblicitarie dell'app. Devi utilizzare questa API solo se la tua app fornisce controlli del volume personalizzati all'utente e il volume dell'utente viene riflesso correttamente nell'API.

Per i formati degli annunci apertura app, banner, interstitial, con premio e interstitial con premio, puoi comunicare a Google Mobile Ads SDK che il volume dell'app è stato disattivato impostando la proprietà applicationMuted:

Swift

MobileAds.shared.applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

Per impostazione predefinita, applicationVolume è impostato su 1 (il volume del dispositivo corrente) e applicationMuted è impostato su NO.

**Avviso:** la disattivazione dell'audio dell'app riduce l'idoneità degli annunci video e potrebbe ridurre le entrate pubblicitarie dell' app. Devi utilizzare questa API solo se la tua app fornisce un controllo di disattivazione dell'audio personalizzato all'utente e la decisione di disattivare l'audio dell'utente viene riflessa correttamente nell'API.

Annunci nativi

Consulta GADVideoOptions per istruzioni su come controllare le impostazioni di disattivazione dell'audio. Per gli annunci nativi, non è previsto il supporto per il controllo del volume personalizzato.

Sessioni audio

Le sessioni audio ti consentono di comunicare al sistema le tue intenzioni per il comportamento audio della tua app. Ulteriori informazioni sulle sessioni audio sono disponibili nella Guida alla programmazione delle sessioni audio di Apple. Le opzioni disponibili per la gestione dell'audio Google Mobile Ads SDK sono disponibili tramite la audioVideoManager proprietà.

Se non utilizzi l'audio nella tua app, non devi utilizzare queste API. Google Mobile Ads SDK gestisce automaticamente la categoria della sessione audio quando riproduce l'audio. Se riproduci l'audio nella tua app e vuoi un controllo più preciso su come e quando Google Mobile Ads SDK riproduce l'audio, puoi utilizzare queste API.

Nel gestore audio/video, puoi impostare la audioSessionIsApplicationManaged proprietà su YES se vuoi assumerti la responsabilità di gestire autonomamente la categoria della sessione audio.

Se vuoi gestire la categoria della sessione audio, puoi implementare GADAudioVideoManagerDelegate e impostare la proprietà delegate nel gestore audio/video per ricevere una notifica degli eventi di riproduzione audio e video degli annunci. Dopodiché, devi modificare la categoria della sessione audio nella categoria pertinente in base alla Guida alla programmazione delle sessioni audio di Apple.

Punto chiave: per impostazione predefinita, l'SDK imposta la categoria della sessione audio su AVAudioSessionCategoryAmbient quando riproduce gli annunci con l'audio disattivato. Se preferisci che la tua app utilizzi AVAudioSessionCategoryOptionDuckOthers in questo scenario, devi implementare il protocollo GADAudioVideoManagerDelegate e impostare audioSessionIsApplicationManaged del gestore audio/video su YES.

Ecco un esempio di codice semplificato che mostra l'approccio consigliato se la tua app riproduce musica, utilizzando le API sopra indicate:

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

Report sugli arresti anomali

Google Mobile Ads SDK esamina le eccezioni che si verificano in un'app iOS e le registra se sono state causate dall'SDK. Queste eccezioni vengono poi risolte nelle versioni future dell'SDK.

La segnalazione degli arresti anomali è attiva per impostazione predefinita. Se non vuoi che vengano registrate le eccezioni correlate all'SDK, puoi disattivare questa funzionalità chiamando il metodo disableSDKCrashReporting. Il momento migliore per chiamare questo metodo è all'avvio dell'app:

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

Consenso per le impostazioni dei cookie

Se la tua app ha requisiti speciali, puoi impostare l'opzione NSUserDefaults gad_has_consent_for_cookies. Google Mobile Ads SDK attiva gli annunci con limitazioni (LTD) se la preferenza gad_has_consent_for_cookies è impostata su 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");