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ärkeeinstellungen für Videos gelten nur für Google Anzeigen und werden nicht an Vermittlungsnetzwerke weitergeleitet.

Falls Ihre App über eigene Lautstärkeregler verfügt, z. B. für benutzerdefinierte Lautstärken für Musik oder Soundeffekte, können die Einstellungen für die App-Lautstärke bei Videoanzeigen berücksichtigt werden, wenn Sie die App-Lautstärke im Google Mobile Ads SDK angeben. So wird sichergestellt, dass die Nutzer Videoanzeigen mit der erwarteten Audiolautstärke erhalten.

Die Gerätelautstärke wird über die Lautstärketasten oder den Lautstärkeregler auf Betriebssystemebene festgelegt. Sie 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 die Audioqualität anzupassen.

Für die Formate „App-Start“, „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 Eigenschaft applicationVolume festlegen. Gültige Werte für die Anzeigenlautstärke reichen von 0.0 (Lautlos) bis 1.0 (aktuelle Gerätelautstärke). Hier ist ein Beispiel dafür, wie das relative App-Volumen an das SDK gemeldet wird:

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, kommen Videoanzeigen weniger gut zur Geltung. Dies kann sich auch auf den Werbeumsatz Ihrer App auswirken. Sie sollten diese API nur verwenden, wenn Ihre App dem Nutzer benutzerdefinierte Lautstärkeregler zur Verfügung stellt und die Lautstärke des Nutzers in der API korrekt wiedergegeben wird.

Für die Formate App-Start-, Banner-, Interstitial- und Interstitial-Anzeigen mit Prämie können Sie dem Google Mobile Ads SDK mitteilen, dass das App-Volumen stummgeschaltet wurde. Dazu legen Sie die Eigenschaft applicationMuted fest:

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 eingestellt.

Warnung :Wenn Sie Ihre App ignorieren, sind Videoanzeigen weniger geeignet und der Anzeigenumsatz Ihrer App kann sinken. Sie sollten diese API nur verwenden, wenn Ihre App dem Nutzer ein benutzerdefiniertes Steuerelement zur Stummschaltung bietet und seine Entscheidung zum Stummschalten in der API korrekt widergespiegelt wird.

Native Anzeigen

Eine Anleitung zum Festlegen der Einstellungen für die Stummschaltung finden Sie unter GADVideoOptions. Bei nativen Anzeigen wird keine benutzerdefinierte Lautstärkeregelung unterstützt.

Audiositzungen

Mit Audiositzungen können Sie dem System Ihre Absichten in Bezug auf das Audioverhalten Ihrer App zum Ausdruck bringen. Weitere Informationen zu Audiositzungen finden Sie im Audio Session Programming Guide von Apple. Sie können die Audiofunktionen des Google Mobile Ads SDK über die Property audioVideoManager verwalten.

Wenn Sie in Ihrer App keine Audioinhalte verwenden, müssen Sie diese APIs nicht verwenden. Mit dem Google Mobile Ads SDK wird die Kategorie der Audiositzung bei der Audiowiedergabe automatisch verwaltet. Wenn Sie in Ihrer App Audioinhalte wiedergeben und mehr Kontrolle darüber haben möchten, wie und wann das Google Mobile Ads SDK Audioinhalte wiedergibt, können Sie diese APIs verwenden.

Im Audiovideo-Manager kannst du die Property audioSessionIsApplicationManaged auf YES setzen, wenn du die Verantwortung für die Verwaltung der Kategorie der Audiositzung selbst übernehmen möchtest.

Wenn Sie die Kategorie der Audiositzung verwalten möchten, können Sie GADAudioVideoManagerDelegate implementieren und die Property delegate im Audiovideo-Manager so festlegen, dass Sie über Video- und Audiowiedergabeereignisse von Anzeigen benachrichtigt werden. Ändern Sie die Kategorie der Audiositzung dann entsprechend dem Audio Session Programming Guide von Apple in die entsprechende Kategorie.

Wichtiger Hinweis :Im SDK wird die Audiositzungskategorie bei der Wiedergabe stummgeschalteter Anzeigen standardmäßig auf AVAudioSessionCategoryAmbient festgelegt. Wenn deine App in diesem Szenario lieber AVAudioSessionCategoryOptionDuckOthers verwenden soll, musst du das GADAudioVideoManagerDelegate-Protokoll implementieren und den Audio-Video-Manager audioSessionIsApplicationManaged auf YES setzen.

Hier ist ein vereinfachtes Codebeispiel, das den empfohlenen Ansatz zeigt, wenn in Ihrer App Musik mithilfe der oben genannten APIs 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

Mit dem Google Mobile Ads SDK werden Ausnahmen in iOS-Apps geprüft und erfasst, wenn sie vom SDK verursacht wurden. Diese Ausnahmen werden dann in zukünftigen SDK-Versionen berücksichtigt.

Absturzberichte sind standardmäßig aktiviert. Wenn SDK-bezogene Ausnahmen nicht aufgezeichnet werden sollen, können Sie diese Funktion durch Aufrufen der Methode disableSDKCrashReporting deaktivieren. Der beste Zeitpunkt für den Aufruf dieser Methode ist beim Start der App:

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 zu Cookie-Einstellungen

Wenn deine App besondere Anforderungen hat, kannst du den optionalen NSUserDefaults gad_has_consent_for_cookies festlegen. Das Google Mobile Ads SDK aktiviert die eingeschränkte Anzeigenausrichtung wenn die gad_has_consent_for_cookies-Einstellung 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");