Ustawienia globalne

Klasa GADMobileAds udostępnia globalne ustawienia, które umożliwiają kontrolowanie niektórych informacji zbieranych przez pakiet SDK do reklam mobilnych Google.

Kontrolowanie głośności reklam wideo

Jeśli aplikacja ma własną regulację głośności, np. głośność niestandardowej muzyki lub efektów dźwiękowych, przekazywanie informacji o głośności aplikacji do pakietu SDK do reklam mobilnych Google umożliwia reklamom wideo dostosowanie się do ustawień głośności aplikacji. Dzięki temu użytkownicy będą widzieć reklamy wideo z oczekiwanym poziomem głośności.

Głośność urządzenia kontrolowana za pomocą przycisków głośności lub suwaka głośności na poziomie systemu operacyjnego określa głośność wyjścia audio urządzenia. Aplikacje mogą jednak niezależnie dostosowywać poziomy głośności względem głośności urządzenia, aby dopasować dźwięk do potrzeb użytkownika.

W przypadku formatów reklam otwierających aplikację, banerowych, pełnoekranowych, z nagrodą i pełnoekranowych z nagrodą możesz zgłaszać względną liczbę wyświetleń aplikacji do pakietu SDK do reklam mobilnych Google, ustawiając właściwość applicationVolume. Prawidłowe wartości głośności reklamy mieszczą się w zakresie od 0.0 (cisza) do 1.0 (bieżąca głośność urządzenia). Oto przykład sposobu raportowania względnej liczby aplikacji do pakietu SDK:

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  MobileAds.shared.applicationVolume = 0.5
  ...
}

- (void)viewDidLoad {
  [super viewDidLoad];
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance.applicationVolume = 0.5;
  ...
}

W przypadku formatów reklam otwierających aplikację, banerowych, pełnoekranowych, z nagrodą i pełnoekranowych z nagrodą możesz poinformować pakiet SDK do reklam mobilnych Google, że głośność aplikacji została wyciszona, ustawiając właściwość applicationMuted:

MobileAds.shared.applicationMuted = true

GADMobileAds.sharedInstance.applicationMuted = YES;

Domyślnie applicationVolume jest ustawione na 1 (bieżąca głośność urządzenia), a applicationMuted na NO.

Reklamy natywne

Instrukcje dotyczące sterowania ustawieniami wyciszania znajdziesz w sekcji GADVideoOptions. W przypadku reklam natywnych nie ma obsługi niestandardowego sterowania głośnością.

Sesje audio

Sesje audio pozwalają określić systemowi, jak ma się zachowywać dźwięk w aplikacji. Dodatkowe informacje o sesjach audio znajdziesz w przewodniku po programowaniu sesji audio firmy Apple. Dostępne opcje zarządzania dźwiękiem w pakiecie SDK do reklam mobilnych Google są dostępne za pomocą właściwości audioVideoManager.

Jeśli w aplikacji nie używasz dźwięku, nie musisz korzystać z tych interfejsów API. Pakiet SDK do reklam mobilnych Google automatycznie zarządza kategorią sesji audio, gdy odtwarza dźwięk. Jeśli odtwarzasz w aplikacji dźwięk i chcesz mieć większą kontrolę nad tym, jak i kiedy pakiet SDK do reklam mobilnych Google odtwarza dźwięk, możesz skorzystać z tych interfejsów API.

W menedżerze audio i wideo możesz ustawić właściwość audioSessionIsApplicationManaged na YES, jeśli chcesz samodzielnie zarządzać kategorią sesji audio.

Jeśli chcesz zarządzać kategorią sesji audio, możesz wdrożyć GADAudioVideoManagerDelegate i ustawić właściwość delegate w menedżerze audio i wideo, aby otrzymywać powiadomienia o zdarzeniach odtwarzania reklam wideo i audio. Następnie zmień kategorię sesji audio na odpowiednią kategorię zgodnie z przewodnikiem Apple dotyczącym programowania sesji audio.

Oto uproszczony przykładowy kod, który pokazuje zalecane podejście, jeśli aplikacja odtwarza muzykę, z użyciem powyższych interfejsów API:

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

- (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];
}

Zgłaszanie awarii

Pakiet SDK do reklam mobilnych Google sprawdza wyjątki występujące w aplikacji na iOS i rejestruje je, jeśli zostały spowodowane przez ten pakiet. Te wyjątki zostaną uwzględnione w przyszłych wersjach pakietu SDK.

Funkcja zgłaszania awarii jest domyślnie włączona. Jeśli nie chcesz rejestrować wyjątków związanych z pakietem SDK, możesz wyłączyć tę funkcję, wywołując metodę disableSDKCrashReporting. Najlepszy czas na wywołanie tej metody to moment uruchomienia aplikacji:

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    MobileAds.shared.disableSDKCrashReporting()
    return true
  }
}

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

Ustawienia zgody na stosowanie plików cookie

Jeśli Twoja aplikacja ma specjalne wymagania, możesz ustawić opcjonalny element NSUserDefaults gad_has_consent_for_cookies. Pakiet SDK do reklam mobilnych Google włącza reklamy ograniczone, jeśli wartość parametru gad_has_consent_for_cookies jest ustawiona na zero.

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

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