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
Paramètres de consentement pour les cookies
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");