Globale Einstellungen

Plattform auswählen: Android iOS Unity Android (Legacy)

Die Klasse GADMobileAds enthält globale Einstellungen zum Steuern bestimmter Informationen, die von 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. Dazu müssen Sie die App-Lautstärke an Google Mobile Ads SDK weitergeben, damit Videoanzeigen die App-Lautstärkeeinstellungen berücksichtigen. So sehen Nutzer Videoanzeigen in der erwarteten Lautstärke.

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

Bei den Anzeigenformaten App-Start-Anzeigen, Banner- und Interstitial-Anzeigen sowie Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie die relative App-Lautstärke an Google Mobile Ads SDK weitergeben, indem Sie die applicationVolume festlegen. Gültige Werte für die Anzeigenlautstärke liegen zwischen 0.0 (stumm) und 1.0 (aktuelle Gerätelautstärke). Hier ein Beispiel dafür, wie Sie die relative App-Lautstärke an das SDK weitergeben:

Swift

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  MobileAds.shared.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-Start-Anzeigen, Banner- und Interstitial-Anzeigen sowie Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie Google Mobile Ads SDK darüber informieren, dass die App-Lautstärke stummgeschaltet wurde, indem Sie die applicationMuted Eigenschaft festlegen:

Swift

MobileAds.shared.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

Siehe GADVideoOptions für Anweisungen zum Steuern der Stummschaltungseinstellungen. Bei nativen Anzeigen wird die benutzerdefinierte Lautstärkeregelung nicht 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 in Apple's Audio Session Programming Guide. Die verfügbaren Optionen zum Verwalten von Google Mobile Ads SDK Audio finden Sie in der audioVideoManager Eigenschaft.

Wenn Sie in Ihrer App kein Audio verwenden, müssen Sie diese APIs nicht verwenden. Google Mobile Ads SDK verwaltet die Kategorie der Audiositzung automatisch, wenn es Audio wiedergibt. Wenn Sie Audio in Ihrer App wiedergeben und genauer steuern möchten, wie und wann Google Mobile Ads SDK Audio wiedergibt, können Sie diese APIs verwenden.

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

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 zur Video- und Audio wiedergabe von Anzeigen benachrichtigt zu werden. Anschließend müssen Sie die Kategorie der Audiositzung in die entsprechende Kategorie gemäß dem Audio Session Programming Guide von Apple ändern.

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

Swift

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

Objective-C

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

Google Mobile Ads SDK untersucht Ausnahmen, die in einer iOS-App auftreten, und zeichnet sie auf, 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. 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 {

    MobileAds.shared.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. Google Mobile Ads SDK aktiviert eingeschränktes Anzeigen-Targeting 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");