Globale Einstellungen

Plattform auswählen: Android Neu Android iOS Unity

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 wird sichergestellt, dass Nutzern Videoanzeigen mit der erwarteten Lautstärke präsentiert werden.

Die Gerätelautstärke, 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.

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 melden, indem Sie die Eigenschaft 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 melden:

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 stumm geschaltet wurde. Dazu legen Sie die applicationMuted Eigenschaft fest:

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 nutzen. 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 festlegen, wenn Sie die Kategorie der Audiositzung selbst verwalten möchten.

Wenn Sie die Kategorie der Audiositzung verwalten möchten, können Sie GADAudioVideoManagerDelegate implementieren und die delegate Eigenschaft im Audio-Video-Manager festlegen, um über Ereignisse bei der 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 sehen Sie 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 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 erfasst 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 festgelegt 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");