Impostazioni globali

La classe GADMobileAds fornisce impostazioni globali per il controllo di alcune Informazioni raccolte dall'SDK Mobile Ads.

Controllo del volume degli annunci video

Se la tua app ha i propri controlli del volume, ad esempio musica personalizzata o effetti sonori volumi, la comunicazione del volume dell'app all'SDK Google Mobile Ads consente per rispettare le impostazioni del volume delle app. In questo modo ti assicuri che gli utenti ricevano annunci video con 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 gestire autonomamente Regolare i livelli del volume in base al volume del dispositivo per personalizzare l'audio un'esperienza senza intervento manuale.

Per annunci apertura app, banner, interstitial, con premio e interstitial con premio formati è possibile segnalare il relativo volume di app all'SDK Google Mobile Ads impostare la proprietà applicationVolume. I valori del volume di annunci validi sono compresi tra Da 0.0 (silenziose) a 1.0 (volume attuale del dispositivo). Ecco un esempio di come segnala il volume dell'app relativo all'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;
  ...
}

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

GADMobileAds.sharedInstance().applicationMuted = true

GADMobileAds.sharedInstance.applicationMuted = YES;

Per impostazione predefinita, l'opzione applicationVolume è impostata su 1 (il volume attuale del dispositivo) e applicationMuted è impostato su NO.

Annunci nativi

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

Sessioni audio

Le sessioni audio ti consentono di esprimere al sistema le tue intenzioni per l'app comportamento audio. Per ulteriori informazioni sulle sessioni audio, consulta la Audio Session Programming di Apple Google Cloud. Le opzioni disponibili per la gestione dell'audio dell'SDK Google Mobile Ads sono tramite il audioVideoManager proprietà.

Se non usi l'audio nella tua app, non hai bisogno di usare queste API. Il team di L'SDK Mobile Ads gestisce automaticamente la categoria della sessione audio quando viene riproduce l'audio. Se riproduci contenuti audio nell'app e vuoi controllare meglio come e quando l'SDK Google Mobile Ads riproduce l'audio, puoi utilizzare queste API.

In Gestione video audio puoi impostare audioSessionIsApplicationManaged in YES se vuoi assumerti la responsabilità della gestione dell'audio della tua sessione.

Se vuoi gestire la categoria della sessione audio, puoi implementare GADAudioVideoManagerDelegate e imposta delegate in Gestione video audio per ricevere notifiche sugli annunci video e audio eventi di riproduzione. Dovresti poi modificare la categoria della sessione audio in pertinente in base alla Audio Session Programming di Apple Google Cloud.

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

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

Report sugli arresti anomali

L'SDK Google Mobile Ads controlla le eccezioni che si verificano in un'app per iOS e li registra se sono stati causati dall'SDK. Queste eccezioni sono quindi nelle versioni future dell'SDK.

I report sugli arresti anomali sono abilitati per impostazione predefinita. Se non vuoi eccezioni relative all'SDK la registrazione, puoi disabilitare questa funzione richiamando il metodo disableSDKCrashReporting. Il momento migliore per chiamare questo metodo è quando viene avviata l'app:

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

Consenso per le impostazioni dei cookie

Se la tua app ha requisiti speciali, puoi impostare il campo NSUserDefaults gad_has_consent_for_cookies. L'SDK Google Mobile Ads abilita annunci con limitazioni (LTD) se la preferenza gad_has_consent_for_cookies è impostata su zero.

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

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