Paramètres globaux

La classe GADMobileAds fournit des paramètres généraux permettant de contrôler certains les informations collectées par le SDK Mobile Ads.

Contrôle du volume des annonces vidéo

Si votre application dispose de ses propres commandes de volume, telles que la musique ou les effets sonores personnalisés le volume d'applications, le fait de communiquer le volume d'applications au SDK Google Mobile Ads active les annonces vidéo pour respecter les paramètres de volume de l'application. Ainsi, les utilisateurs voient des annonces vidéo avec le le volume sonore attendu.

le volume de l'appareil, contrôlé à l'aide des boutons de volume ou du curseur de volume au niveau du système d'exploitation ; détermine le volume de la sortie audio de l'appareil. Toutefois, les applications peuvent ajuster les niveaux de volume par rapport au volume de l'appareil pour adapter l'audio expérience.

Pour les annonces à l'ouverture, les bannières, les annonces interstitielles, les annonces avec récompense et les annonces interstitielles avec récompense vous pouvez signaler le volume relatif d'applications au SDK Google Mobile Ads en définissant la propriété applicationVolume. Les valeurs valides pour le volume d'annonces sont comprises entre 0.0 (silencieux) sur 1.0 (volume actuel de l'appareil). Voici un exemple de la façon signaler le volume relatif de l'application au SDK:

Swift

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance().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;
  ...
}

Pour les annonces à l'ouverture, les bannières, les annonces interstitielles, les annonces avec récompense et les annonces interstitielles avec récompense vous pouvez informer le SDK Google Mobile Ads que le volume en définissant la propriété applicationMuted:

Swift

GADMobileAds.sharedInstance().applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

Par défaut, applicationVolume est défini sur 1 (le volume actuel de l'appareil) et applicationMuted est défini sur NO.

Annonces natives

Voir GADVideoOptions pour obtenir des instructions sur les paramètres de désactivation du son. Pour les annonces natives, il n'est pas possible la prise en charge du réglage personnalisé du volume.

Sessions audio

Les sessions audio vous permettent d'exprimer au système vos intentions concernant comportement audio. Vous trouverez des informations supplémentaires sur les sessions audio dans Programmation de sessions audio d'Apple Guide de démarrage. Les options disponibles pour gérer l'audio du SDK Google Mobile Ads sont la audioVideoManager .

Si vous n'utilisez pas l'audio dans votre application, vous n'avez pas besoin d'utiliser ces API. La console Google Le SDK Mobile Ads gère automatiquement la catégorie de session audio lorsqu'elle lit l'audio. Si vous lisez du contenu audio dans votre application et souhaitez quand et comment le SDK Google Mobile Ads lit l'audio, vous pouvez utiliser ces API.

Dans le gestionnaire audio et vidéo, vous pouvez définir audioSessionIsApplicationManaged sur YES si vous souhaitez être responsable de la gestion de l'audio catégorie de session.

Si vous souhaitez gérer la catégorie de session audio, vous pouvez implémenter GADAudioVideoManagerDelegate et définissez delegate dans le Gestionnaire de vidéos audio afin d'être averti des annonces vidéo et audio les événements de lecture. Vous devez ensuite remplacer la catégorie de la session audio par catégorie pertinente d'après la programmation de session audio d'Apple Guide de démarrage.

Voici un exemple de code simplifié illustrant l'approche recommandée si votre lit de la musique à l'aide des API ci-dessus:

Swift

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

Objective-C

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

Création de rapports d'erreur

Le SDK Google Mobile Ads inspecte les exceptions qui se produisent dans une application iOS et les enregistre s'ils sont causés par le SDK. Ces exceptions sont alors traités dans les futures versions du SDK.

Les rapports d'erreur sont activés par défaut. Si vous ne voulez pas d'exceptions liées aux SDK vous pouvez désactiver cette fonctionnalité en appelant la méthode disableSDKCrashReporting. Le meilleur moment pour appeler cette méthode est le moment l'application se lance:

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    GADMobileAds.disableSDKCrashReporting()
    return true
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

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

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

Si votre application a des exigences particulières, vous pouvez définir le paramètre NSUserDefaults gad_has_consent_for_cookies Le SDK Google Mobile Ads permet Annonces limitées (LTD) si la préférence gad_has_consent_for_cookies est définie sur zéro.

Swift

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

Objective-C

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