Genel Ayarlar

GADMobileAds sınıfı, Google Mobile Ads SDK'sı tarafından toplanan belirli bilgileri kontrol etmek için genel ayarlar sağlar.

Video reklam ses kontrolü

Uygulamanızın kendi ses düzeyi denetimleri (ör. özel müzik veya ses efekti ses düzeyleri) varsa uygulama ses düzeyini Google Mobile Ads SDK'sına açıklamak, video reklamların uygulama ses düzeyi ayarlarına uymasını sağlar. Bu sayede kullanıcılar video reklamları beklenen ses düzeyinde alır.

Ses yüksekliği düğmeleri veya işletim sistemi düzeyindeki ses düzeyi kaydırıcısı aracılığıyla kontrol edilen cihaz ses düzeyi, cihaz ses çıkışının ses düzeyini belirler. Ancak uygulamalar, ses deneyimini özelleştirmek için ses seviyelerini cihaz ses düzeyine göre bağımsız olarak ayarlayabilir.

Uygulama açılışı, banner, geçiş, ödüllü ve ödüllü geçiş reklamı biçimleri için applicationVolume özelliğini ayarlayarak göreli uygulama hacmini Google Mobile Ads SDK'sına bildirebilirsiniz. Geçerli reklam ses seviyesi değerleri 0.0 (sessiz) ile 1.0 (mevcut cihaz ses seviyesi) aralığındadır. SDK'ya göreli uygulama hacminin nasıl bildirileceğine dair bir örneği aşağıda bulabilirsiniz:

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

Uygulama açılışı, banner, geçiş, ödüllü ve ödüllü geçiş reklamı biçimleri için applicationMuted özelliğini ayarlayarak uygulama sesinin kapatıldığını Google Mobile Ads SDK'sına bildirebilirsiniz:

MobileAds.shared.applicationMuted = true

GADMobileAds.sharedInstance.applicationMuted = YES;

Varsayılan olarak, applicationVolume, 1 (mevcut cihaz sesi) olarak, applicationMuted ise NO olarak ayarlanır.

Yerel reklamlar

Sesi kapatma ayarlarını kontrol etme talimatları için GADVideoOptions bölümüne bakın. Yerel reklamlar için özel ses düzeyi denetimi desteklenmez.

Ses oturumları

Ses oturumları, uygulamanızın ses davranışıyla ilgili niyetlerinizi sisteme bildirmenize olanak tanır. Ses oturumları hakkında ek bilgiyi Apple'ın Ses Oturumu Programlama Kılavuzu'nda bulabilirsiniz. Google Mobile Ads SDK sesini yönetmek için kullanılabilen seçenekler audioVideoManager özelliği aracılığıyla sunulur.

Uygulamanızda ses kullanmıyorsanız bu API'leri kullanmanız gerekmez. Google Mobile Ads SDK'sı, ses çalarken ses oturumu kategorisini otomatik olarak yönetir. Uygulamanızda ses çalıyorsanız ve Google Mobile Ads SDK'sının sesi nasıl ve ne zaman çalacağı konusunda daha sıkı bir kontrol istiyorsanız bu API'lerden yararlanabilirsiniz.

Ses oturumu kategorisini kendiniz yönetmek istiyorsanız ses video yöneticisinde audioSessionIsApplicationManaged özelliğini YES olarak ayarlayabilirsiniz.

Ses oturumu kategorisini yönetmek istiyorsanız GADAudioVideoManagerDelegate uygulayabilir ve reklam video ve ses oynatma etkinliklerinden haberdar olmak için ses video yöneticisinde delegate özelliğini ayarlayabilirsiniz. Ardından, ses oturumu kategorisini Apple'ın Ses Oturumu Programlama Kılavuzu'na göre ilgili kategoriyle değiştirmeniz gerekir.

Uygulamanızda müzik çalınıyorsa yukarıdaki API'leri kullanarak önerilen yaklaşımı gösteren basitleştirilmiş bir kod örneğini aşağıda bulabilirsiniz:

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

Kilitlenme raporu

Google Mobile Ads SDK'sı, bir iOS uygulamasında oluşan istisnaları inceler ve SDK'dan kaynaklanıyorsa bunları kaydeder. Bu istisnalar daha sonraki SDK sürümlerinde ele alınır.

Kilitlenme bildirme özelliği varsayılan olarak etkindir. SDK ile ilgili istisnaların kaydedilmesini istemiyorsanız disableSDKCrashReporting yöntemini çağırarak bu özelliği devre dışı bırakabilirsiniz. Bu yöntemi çağırmak için en uygun zaman, uygulama başlatıldığında gerçekleşir:

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

Çerez ayarları için izin

Uygulamanızın özel gereksinimleri varsa isteğe bağlı NSUserDefaults gad_has_consent_for_cookies ayarını yapabilirsiniz. Google Mobile Ads SDK'sı, gad_has_consent_for_cookies tercihi sıfır olarak ayarlanırsa sınırlı reklamları (LTD) etkinleştirir.

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

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