Globale Einstellungen

Die Klasse GADMobileAds bietet globale Einstellungen zum Steuern bestimmter Informationen, die vom Google 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 werden Nutzern Videoanzeigen in der erwarteten Lautstärke präsentiert.

Die Lautstärke des Geräts, die über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene gesteuert wird, bestimmt die Lautstärke für die Audioausgabe des Geräts. Apps können die Lautstärke jedoch unabhängig von der Gerätelautstärke anpassen, um das Audioerlebnis zu optimieren.

Für die Anzeigenformate „App Open“, „Banner“, „Interstitial“, „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 sehen Sie ein Beispiel dafür, wie Sie das relative App-Volumen an das SDK melden:

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  MobileAds.shared.applicationVolume = 0.5
  ...
}

- (void)viewDidLoad {
  [super viewDidLoad];
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance.applicationVolume = 0.5;
  ...
}

Bei den Anzeigenformaten „App Open“, „Banner“, „Interstitial“, „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, indem Sie die applicationMuted-Eigenschaft festlegen:

MobileAds.shared.applicationMuted = true

GADMobileAds.sharedInstance.applicationMuted = YES;

Standardmäßig ist applicationVolume auf 1 (die aktuelle Lautstärke des Geräts) und applicationMuted auf NO festgelegt.

Native Anzeigen

Eine Anleitung zum Steuern 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 verfügbaren Optionen zum Verwalten von Audioinhalten im Google Mobile Ads SDK sind über die Eigenschaft audioVideoManager verfügbar.

Wenn Sie in Ihrer App keine Audioinhalte verwenden, müssen Sie diese APIs nicht verwenden. Das Google Mobile Ads SDK verwaltet die Audiokategorie automatisch, wenn Audio wiedergegeben wird. Wenn Sie Audioinhalte in Ihrer App wiedergeben und genauer steuern möchten, wie und wann das Google Mobile Ads SDK Audioinhalte wiedergibt, können Sie diese APIs verwenden.

Im Audio-Video-Manager können Sie die Eigenschaft audioSessionIsApplicationManaged auf YES setzen, wenn Sie die Audiokategorie der Sitzung selbst verwalten möchten.

Wenn Sie die Audiokategorie verwalten möchten, können Sie GADAudioVideoManagerDelegate implementieren und die Eigenschaft delegate im Audio-Video-Manager festlegen, um Benachrichtigungen zu Wiedergabeereignissen für Video- und Audioanzeigen zu erhalten. Ändern Sie dann die Kategorie der Audiositzung in die relevante Kategorie gemäß dem Apple Audio Session Programming Guide.

Hier ist ein vereinfachtes Codebeispiel, das den empfohlenen Ansatz zeigt, wenn Ihre App Musik wiedergibt und die oben genannten APIs verwendet:

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

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

Absturzberichte

Das Google Mobile Ads SDK untersucht Ausnahmen, die in einer iOS-App auftreten, und erfasst sie, wenn sie durch das SDK verursacht wurden. Diese Ausnahmen werden dann in zukünftigen SDK-Versionen behoben.

Die Absturzberichtsfunktion ist standardmäßig aktiviert. Wenn Sie nicht möchten, dass SDK-bezogene Ausnahmen aufgezeichnet werden, können Sie diese Funktion deaktivieren, indem Sie die Methode disableSDKCrashReporting aufrufen. Diese Methode sollte am besten beim Start der App aufgerufen werden:

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    MobileAds.shared.disableSDKCrashReporting()
    return true
  }
}

@import GoogleMobileAds;

@implementation AppDelegate

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

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

Einwilligung für Cookie-Einstellungen

Wenn Ihre App spezielle Anforderungen hat, können Sie die optionale NSUserDefaults-gad_has_consent_for_cookies festlegen. Das Google Mobile Ads SDK ermöglicht eingeschränkte Anzeigen, wenn die gad_has_consent_for_cookies-Einstellung auf null gesetzt ist.

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

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