Globale Einstellungen

Die Klasse GADMobileAds bietet globale Einstellungen zur Steuerung bestimmter Daten, die mit dem Mobile Ads SDK erfasst werden.

Lautstärkeregelung für Videoanzeigen

Hinweis :Die Lautstärkeregler für Videos gelten nur für Google Anzeigen und werden nicht weitergeleitet an Vermittlungsnetzwerke.

Wenn Ihre App eigene Lautstärkeregler hat, z. B. eigene Musik- oder Soundeffekte Durch die Offenlegung des App-Volumens für das Google Mobile Ads SDK werden Videoanzeigen ermöglicht. um die App-Lautstärkeeinstellungen zu übernehmen. So erhalten Nutzer Videoanzeigen mit der erwartete Audiolautstärke.

über die Lautstärketasten oder den Lautstärkeregler des Betriebssystems legt die Lautstärke der Audioausgabe des Geräts fest. Apps können jedoch unabhängig voneinander Lautstärke relativ zur Gerätelautstärke anpassen, um den Ton anzupassen Nutzererfahrung.

Für App-Start-Anzeigen, Banner, Interstitial-Anzeigen, Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie Formate verwenden, können Sie das relative App-Volumen an das Google Mobile Ads SDK melden, und legen das Attribut applicationVolume fest. Gültige Werte für das Anzeigenvolumen reichen von 0.0 (laut) bis 1.0 (aktuelle Gerätelautstärke). Hier ist ein Beispiel, wie Sie dem SDK das relative App-Volumen 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, sind Videoanzeigen möglicherweise nicht mehr für den Werbeumsatz Ihrer App reduzieren. Sie sollten diese API nur verwenden, wenn Ihre App bietet dem Nutzer benutzerdefinierte Lautstärkeregler und die Lautstärke ist richtig eingestellt. in der API berücksichtigt.

Für App-Start-Anzeigen, Banner, Interstitial-Anzeigen, Anzeigen mit Prämie und Interstitial-Anzeigen mit Prämie können Sie dem Google Mobile Ads SDK mitteilen, dass das App-Volumen wird durch Festlegen der Eigenschaft applicationMuted ignoriert:

Swift

GADMobileAds.sharedInstance().applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

Standardmäßig ist applicationVolume auf 1 eingestellt (die aktuelle Gerätelautstärke). und applicationMuted ist auf NO eingestellt.

Warnung :Wenn Sie Ihre App stummschalten, sind Videoanzeigen weniger geeignet. auf die Werbeeinnahmen der App. Sie sollten diese API nur verwenden, wenn Ihre App eine wird eine benutzerdefinierte Stummschaltung angezeigt und die Entscheidung des Nutzers ist korrekt. in der API berücksichtigt.

Native Anzeigen

Weitere Informationen finden Sie unter GADVideoOptions . Bei nativen Anzeigen gibt es Unterstützung für eine benutzerdefinierte Lautstärkeregelung.

Audiositzungen

Mit Audiositzungen können Sie dem System Ihre Absichten für die App Audioverhalten. Weitere Informationen zu Audiositzungen finden Sie hier: Apples Audio Session Programming Leitfaden. Für die Verwaltung von Audioanzeigen des Google Mobile Ads SDK sind folgende Optionen verfügbar: die audioVideoManager Property.

Wenn Sie in Ihrer App kein Audio verwenden, sind diese APIs auch nicht erforderlich. Die Google Über das Mobile Ads SDK wird die Kategorie der Audiositzung automatisch verwaltet, spielt Audio ab. Wenn Sie Audioinhalte in Ihrer App wiedergeben und mehr Kontrolle über wie und wann mit dem Google Mobile Ads SDK Audio wiedergegeben wird, können Sie diese APIs verwenden.

Im Audio-Video-Manager kannst du die audioSessionIsApplicationManaged die Property auf YES, wenn du die Verantwortung für die Audioverwaltung übernehmen möchtest. die Sitzungskategorie selbst.

Wenn Sie die Kategorie der Audiositzung verwalten möchten, können Sie GADAudioVideoManagerDelegate und lege delegate fest. im Audio-Video-Manager, um über Video- und Audioanzeigen informiert zu werden Wiedergabe-Ereignisse. Ändern Sie dann die Audiositzungskategorie in die Kategorie entsprechend der Apple Audio Session Programming Leitfaden.

Wichtiger Hinweis :Standardmäßig legt das SDK die Audiositzungskategorie auf AVAudioSessionCategoryAmbient beim Abspielen von Anzeigen stummgeschaltet. Wenn Sie eine App-Nutzung AVAudioSessionCategoryOptionDuckOthers müssen Sie das GADAudioVideoManagerDelegate-Protokoll implementieren, und setze den Audio-Video-Manager audioSessionIsApplicationManaged auf YES.

Das folgende vereinfachte Codebeispiel zeigt die empfohlene Vorgehensweise, wenn Ihre App spielt Musik mit den oben genannten APIs ab:

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 in einer iOS-App und wenn sie durch das SDK verursacht wurden. Diese Ausnahmen werden dann für zukünftige SDK-Versionen.

Absturzberichte sind standardmäßig aktiviert. Wenn Sie keine SDK-bezogenen Ausnahmen wünschen aufgezeichnet werden soll, können Sie diese Funktion deaktivieren, indem Sie die disableSDKCrashReporting-Methode. Der beste Zeitpunkt für den Aufruf dieser Methode ist, die App gestartet wird:

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 zur Verwendung von Cookies

Wenn Ihre App besondere Anforderungen hat, können Sie die optionale Einstellung NSUserDefaults gad_has_consent_for_cookies. Mit dem Google Mobile Ads SDK Eingeschränkte Anzeigenausrichtung Die Einstellung gad_has_consent_for_cookies ist auf null gesetzt.

Swift

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

Objective-C

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