Globale Einstellungen

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

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");