Globale Einstellungen

Die Klasse GADMobileAds bietet globale Einstellungen zur Steuerung bestimmter Informationen, die vom Mobile Ads SDK erfasst werden.

Lautstärkeregelung für Videoanzeigen

Hinweis: Die Lautstärkeregelung für Videos gilt nur für Google-Anzeigen und wird nicht an Vermittlungsnetzwerke weitergeleitet.

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 Lautstärke des Geräts, 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 ein Beispiel dafür, wie Sie das relative App-Volume 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;
  ...
}

Warnung :Wenn Sie die Audiolautstärke Ihrer App verringern, sinkt die Eignung für Videoanzeigen und möglicherweise auch der Werbeumsatz Ihrer App. Sie sollten diese API nur verwenden, wenn Ihre App benutzerdefinierte Lautstärkeregler bietet und die Lautstärke des Nutzers in der API korrekt widergespiegelt wird.

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.

Warnung :Wenn Sie die Audiowiedergabe Ihrer App stummschalten, können keine Videoanzeigen ausgeliefert werden und die Werbeeinnahmen Ihrer App sinken möglicherweise. Sie sollten diese API nur verwenden, wenn Ihre App eine benutzerdefinierte Stummschaltungssteuerung bietet und die Stummschaltungsentscheidung des Nutzers in der API korrekt berücksichtigt wird.

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 findest du im Programmierungsleitfaden für Audiositzungen von Apple. Die verfügbaren Optionen zum Verwalten von Google Mobile Ads SDK-Audio sind über die Property audioVideoManager verfügbar.

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 können Sie die Property audioSessionIsApplicationManaged auf YES festlegen, wenn Sie die Kategorie „Audiositzung“ selbst verwalten möchten.

Wenn Sie die Kategorie „Audiositzung“ verwalten möchten, können Sie GADAudioVideoManagerDelegate implementieren und die Property delegate im Audio-Video-Manager so festlegen, dass Sie über Video- und Audiowiedergabeereignisse von Anzeigen benachrichtigt werden. Ändern Sie dann die Audiositzungskategorie gemäß dem Programmierungsleitfaden für Audiositzungen von Apple in die entsprechende Kategorie.

Wichtiger Hinweis: Standardmäßig legt das SDK die Audiositzungskategorie auf AVAudioSessionCategoryAmbient fest, wenn Anzeigen stummgeschaltet werden. Wenn Sie möchten, dass Ihre App in diesem Szenario AVAudioSessionCategoryOptionDuckOthers verwendet, müssen Sie das GADAudioVideoManagerDelegate-Protokoll implementieren und den Audio-Video-Manager audioSessionIsApplicationManaged auf YES setzen.

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 berücksichtigt.

Die Absturzberichte sind 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. 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 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 (LTD), 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");