Setelan Global

Class GADMobileAds menyediakan setelan global untuk mengontrol informasi yang dikumpulkan oleh Mobile Ads SDK.

Kontrol volume iklan video

Jika aplikasi Anda memiliki kontrol volume sendiri, seperti musik kustom atau efek suara volume, mengungkapkan volume aplikasi ke Google Mobile Ads SDK akan mengaktifkan iklan video untuk mematuhi setelan volume aplikasi. Hal ini memastikan pengguna menerima iklan video dengan volume audio yang diharapkan.

Volume perangkat, yang dikontrol melalui tombol volume atau penggeser volume tingkat OS, menentukan volume untuk output audio perangkat. Namun, aplikasi dapat secara independen sesuaikan tingkat volume relatif dengan volume perangkat untuk menyesuaikan audio pengalaman yang lancar bagi developer.

Untuk iklan Layar Pembuka Aplikasi, Banner, Interstisial, Reward, dan Interstisial Reward format yang berbeda, Anda dapat melaporkan volume aplikasi relatif ke Google Mobile Ads SDK dengan menetapkan properti applicationVolume. Nilai volume iklan yang valid berkisar dari 0.0 (senyap) ke 1.0 (volume perangkat saat ini). Berikut adalah contoh melaporkan volume aplikasi relatif ke SDK:

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;
  ...
}

Untuk iklan Layar Pembuka Aplikasi, Banner, Interstisial, Reward, dan Interstisial Reward format baru, Anda dapat memberi tahu Google Mobile Ads SDK bahwa volume aplikasi dinonaktifkan dengan menetapkan properti applicationMuted:

Swift

GADMobileAds.sharedInstance().applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

Secara default, applicationVolume disetel ke 1 (volume perangkat saat ini) dan applicationMuted disetel ke NO.

Iklan native

Lihat GADVideoOptions untuk mendapatkan petunjuk tentang cara mengontrol setelan bisukan audio. Untuk iklan native, mendukung kontrol volume kustom.

Sesi audio

Sesi audio memungkinkan Anda mengekspresikan maksud aplikasi Anda ke sistem perilaku audio. Informasi tambahan tentang sesi audio dapat ditemukan di Pemrograman Sesi Audio Apple Panduan. Opsi yang tersedia untuk mengelola audio Google Mobile Ads SDK adalah melalui tindakan audioVideoManager saat ini.

Jika tidak menggunakan audio di aplikasi, Anda tidak perlu menggunakan API ini. Layanan Mobile Ads SDK secara otomatis mengelola kategori sesi audio saat memutar audio. Jika Anda memutar audio di aplikasi dan menginginkan kontrol yang lebih ketat atas bagaimana dan kapan Google Mobile Ads SDK memutar audio, Anda dapat menggunakan API ini.

Di pengelola video audio, Anda dapat menyetel audioSessionIsApplicationManaged kepada YES jika Anda ingin bertanggung jawab atas pengelolaan audio kategori sesi sendiri.

Jika ingin mengelola kategori sesi audio, Anda dapat menerapkan GADAudioVideoManagerDelegate dan setel delegate di pengelola video audio untuk menerima notifikasi tentang iklan, video dan audio peristiwa pemutaran. Kemudian Anda harus mengubah kategori sesi audio ke kategori yang relevan menurut Audio Session Programming Apple Panduan.

Berikut adalah contoh kode sederhana yang menunjukkan pendekatan yang disarankan jika aplikasi memutar musik, menggunakan API di atas:

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

Pelaporan error

Google Mobile Ads SDK memeriksa pengecualian yang terjadi di aplikasi iOS dan mencatatnya jika disebabkan oleh SDK. Pengecualian ini kemudian dalam versi SDK mendatang.

Pelaporan error diaktifkan secara default. Jika Anda tidak menginginkan pengecualian terkait SDK direkam, Anda dapat menonaktifkan fitur ini dengan memanggil Metode disableSDKCrashReporting. Waktu terbaik untuk memanggil metode ini adalah ketika aplikasi diluncurkan:

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

Jika aplikasi Anda memiliki persyaratan khusus, Anda dapat menyetel NSUserDefaults gad_has_consent_for_cookies. Google Mobile Ads SDK memungkinkan iklan terbatas (LTD) jika preferensi gad_has_consent_for_cookies disetel ke nol.

Swift

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

Objective-C

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