Die Klasse GADMobileAds
bietet globale Einstellungen zur Steuerung bestimmter Informationen, die vom Mobile Ads SDK erfasst werden.
Lautstärkeregelung für Videoanzeigen
Wenn in Ihrer App die Lautstärke separat eingestellt werden kann, z. B. für Musik oder Toneffekte, können Sie festlegen, dass Videoanzeigen an die jeweils gewählte Lautstärke angepasst werden. So sehen Nutzer Videoanzeigen in der erwarteten Lautstärke.
Die Gerätelautstärke, die über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene gesteuert wird, bestimmt die Lautstärke der Audioausgabe des Geräts. Apps können die Lautstärke jedoch unabhängig von der Gerätelautstärke anpassen, um die Audioqualität zu optimieren.
Für die Anzeigenformate „App-Öffnung“, „Banner“, „Interstitial“, „Anzeigen mit Prämie“ und „Interstitial mit Prämie“ können Sie das relative App-Volumen an das Google Mobile Ads SDK melden, indem Sie die Property applicationVolume
festlegen. Gültige Werte für die Lautstärke von Anzeigen reichen von 0.0
(stumm) bis 1.0
(aktuelle Gerätelautstärke). Hier ist ein Beispiel dafür, wie Sie das relative App-Volumen an das SDK melden:
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;
...
}
Bei den Anzeigenformaten „App-Öffnung“, „Banner“, „Interstitial“, „Anzeigen mit Prämie“ und „Interstitial mit Prämie“ können Sie das Google Mobile Ads SDK darüber informieren, dass die Lautstärke der App stummgeschaltet wurde. Dazu müssen Sie die Property applicationMuted
festlegen:
Swift
GADMobileAds.sharedInstance().applicationMuted = true
Objective-C
GADMobileAds.sharedInstance.applicationMuted = YES;
Standardmäßig ist applicationVolume
auf 1
(die aktuelle Gerätelautstärke) und applicationMuted
auf NO
festgelegt.
Native Anzeigen
Eine Anleitung zum Festlegen der Stummschaltungseinstellungen finden Sie unter GADVideoOptions
. Bei nativen Anzeigen wird keine benutzerdefinierte Lautstärkeregelung unterstützt.
Audiositzungen
Mit Audiositzungen können Sie dem System Ihre Absichten für das Audioverhalten Ihrer App mitteilen. Weitere Informationen zu Audiositzungen finden Sie im Audio Session Programming Guide von Apple.
Die Audioverwaltung des Google Mobile Ads SDK steht über die Property audioVideoManager
zur Verfügung.
Wenn Sie in Ihrer App keine Audioinhalte verwenden, müssen Sie diese APIs auch nicht verwenden. Das Google Mobile Ads SDK verwaltet die Audiositzungskategorie automatisch, wenn Audio wiedergegeben wird. Wenn Sie Audioinhalte in Ihrer App wiedergeben und genauer festlegen möchten, wie und wann das Google Mobile Ads SDK Audioinhalte wiedergibt, können Sie diese APIs verwenden.
Im Audio-Video-Manager kannst du das Attribut audioSessionIsApplicationManaged
auf YES
festlegen, wenn du die Verantwortung für die Verwaltung der Audiositzungskategorie übernehmen möchtest.
Wenn Sie die Kategorie der Audiositzung verwalten möchten, können Sie GADAudioVideoManagerDelegate
implementieren und die Eigenschaft delegate
im Audio-Video-Manager festlegen, um über Ereignisse bei der Video- und Audiowiedergabe von Anzeigen informiert zu werden. Ändern Sie dann die Audiositzungskategorie gemäß dem Programmierungsleitfaden für Audiositzungen von Apple in die entsprechende Kategorie.
Im folgenden vereinfachten Codebeispiel wird der empfohlene Ansatz für die Verwendung der oben genannten APIs in einer App gezeigt, in der Musik abgespielt wird:
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];
}
Absturzberichte
Das Google Mobile Ads SDK prüft Ausnahmen, die in einer iOS-App auftreten, und zeichnet sie auf, wenn sie vom SDK verursacht wurden. Diese Ausnahmen werden dann in zukünftigen SDK-Versionen behoben.
Die Absturzberichte sind standardmäßig aktiviert. Wenn keine SDK-bezogenen Ausnahmen aufgezeichnet werden sollen, können Sie diese Funktion durch Aufrufen der Methode disableSDKCrashReporting
deaktivieren. Am besten rufen Sie diese Methode beim Starten der App auf:
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
Einwilligung zur Verwendung von Cookies
Wenn Ihre App spezielle Anforderungen hat, können Sie die optionale NSUserDefaults
gad_has_consent_for_cookies
festlegen. Mit dem Google Mobile Ads SDK können
eingeschränkte Anzeigen (LTD)
aktiviert werden, wenn die Einstellung gad_has_consent_for_cookies
auf null gesetzt ist.
Swift
UserDefaults.standard.set(0, forKey: "gad_has_consent_for_cookies")
Objective-C
NSUserDefaults.standardUserDefaults().setObject(Int(0),
forKey: "gad_has_consent_for_cookies");