Setelan Global

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

Kontrol volume iklan video

Jika aplikasi Anda memiliki kontrol volume sendiri, seperti volume kustom untuk musik atau efek suara, pengungkapan volume aplikasi ke Google Mobile Ads SDK memungkinkan iklan video 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 output audio perangkat. Namun, aplikasi dapat menyesuaikan tingkat volume secara independen relatif terhadap volume perangkat untuk menyesuaikan pengalaman audio.

Untuk format iklan Buka Aplikasi, Banner, Interstisial, Reward, dan Interstisial Reward, 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) hingga 1.0 (volume perangkat saat ini). Berikut adalah contoh cara melaporkan volume aplikasi relatif ke 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;
  ...
}

Untuk format iklan Buka Aplikasi, Banner, Interstisial, Reward, dan Interstisial Reward, Anda dapat memberi tahu Google Mobile Ads SDK bahwa volume aplikasi telah disetel ke senyap dengan menyetel properti applicationMuted:

MobileAds.shared.applicationMuted = true

GADMobileAds.sharedInstance.applicationMuted = YES;

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

Iklan native

Lihat GADVideoOptions untuk mengetahui petunjuk tentang cara mengontrol setelan senyap. Untuk iklan native, tidak ada dukungan untuk kontrol volume kustom.

Sesi audio

Sesi audio memungkinkan Anda menyatakan maksud Anda kepada sistem terkait perilaku audio aplikasi Anda. Informasi tambahan tentang sesi audio dapat ditemukan di Panduan Pemrograman Sesi Audio Apple. Opsi yang tersedia untuk mengelola audio Google Mobile Ads SDK adalah melalui properti audioVideoManager.

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

Di pengelola video audio, Anda dapat menyetel properti audioSessionIsApplicationManaged ke YES jika ingin bertanggung jawab mengelola kategori sesi audio sendiri.

Jika ingin mengelola kategori sesi audio, Anda dapat menerapkan GADAudioVideoManagerDelegate dan menetapkan properti delegate di pengelola video audio agar diberi tahu tentang peristiwa pemutaran video dan audio iklan. Kemudian, Anda harus mengubah kategori sesi audio ke kategori yang relevan sesuai dengan Panduan Pemrograman Sesi Audio Apple.

Berikut adalah contoh kode yang disederhanakan yang menunjukkan pendekatan yang direkomendasikan jika aplikasi Anda memutar musik, menggunakan API di atas:

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

Pelaporan error

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

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

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

Setelan izin untuk cookie

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

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

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