Paramètres généraux

Sélectionnez une plate-forme : Android Nouveau Android iOS Unity

La classe GADMobileAds fournit des paramètres globaux permettant de contrôler certaines informations collectées par Google Mobile Ads SDK.

Contrôle du volume des annonces vidéo

Si votre application dispose de ses propres commandes de contrôle du volume (telles que des volumes de musique ou d'effet audio personnalisés), la divulgation du volume de l'application au Google Mobile Ads SDK permet aux annonces vidéo de respecter les paramètres de volume de l'application. Les utilisateurs reçoivent ainsi des annonces vidéo avec le volume audio attendu.

Le volume de l'appareil, contrôlé via les boutons de volume ou le 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 indépendamment les niveaux de volume par rapport au volume de l'appareil pour personnaliser l'expérience audio.

Pour les formats d'annonce à l'ouverture, bannière, interstitiel, avec récompense et interstitiel avec récompense, vous pouvez signaler le volume relatif de l'application au Google Mobile Ads SDK en définissant la propriété applicationVolume. Les valeurs de volume d'annonce valides sont comprises entre 0.0 (silencieux) et 1.0 (volume actuel de l'appareil). Voici un exemple de signalement du volume relatif de l'application au 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;
  ...
}

Pour les formats d'annonce à l'ouverture, bannière, interstitiel, avec récompense et interstitiel avec récompense , vous pouvez informer Google Mobile Ads SDK que le volume de l'application a été coupé en définissant la propriété applicationMuted :

Swift

MobileAds.shared.applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

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

Annonces natives

Consultez GADVideoOptions pour obtenir des instructions sur le contrôle des paramètres de désactivation du son. Pour les annonces natives, le contrôle personnalisé du volume n'est pas pris en charge.

Sessions audio

Les sessions audio vous permettent d'exprimer au système vos intentions concernant le comportement audio de votre application. Pour en savoir plus sur les sessions audio, consultez le guide de programmation des sessions audio d'Apple. Les options disponibles pour gérer Google Mobile Ads SDK audio sont accessibles via la audioVideoManager propriété.

Si vous n'utilisez pas d'audio dans votre application, vous n'avez pas besoin d'utiliser ces API. Google Mobile Ads SDK gère automatiquement la catégorie de session audio lorsqu'il lit de l'audio. Si vous lisez de l'audio dans votre application et que vous souhaitez mieux contrôler comment et quand Google Mobile Ads SDK lit de l'audio, vous pouvez utiliser ces API.

Dans le gestionnaire audio/vidéo, vous pouvez définir la audioSessionIsApplicationManaged propriété sur YES si vous souhaitez gérer vous-même la catégorie de session audio.

Si vous souhaitez gérer la catégorie de session audio, vous pouvez implémenter GADAudioVideoManagerDelegate et définir la delegate propriété sur le gestionnaire audio/vidéo pour être informé des événements de lecture audio et vidéo des annonces. Vous devez ensuite modifier la catégorie de session audio en fonction de la catégorie appropriée, conformément au guide de programmation des sessions audio d'Apple Guide.

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

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

Création de rapports d'erreur

Google Mobile Ads SDK inspecte les exceptions qui se produisent dans une application iOS et les enregistre si elles ont été causées par le SDK. Ces exceptions sont ensuite traitées dans les futures versions du SDK.

La création de rapports d'erreur est activée par défaut. Si vous ne souhaitez pas que les exceptions liées au SDK soient enregistrées, vous pouvez désactiver cette fonctionnalité en appelant la méthode disableSDKCrashReporting. Le meilleur moment pour appeler cette méthode est le lancement de l'application :

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

Si votre application a des exigences particulières, vous pouvez définir le facultatif NSUserDefaults gad_has_consent_for_cookies. Google Mobile Ads SDK active les annonces limitées (LMT) 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");