Genel Ayarlar

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

Video reklam ses düzeyi kontrolü

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

Cihaz ses çıkışının ses düzeyi, ses düğmeleri veya işletim sistemi düzeyindeki ses düzeyi kaydırma çubuğu aracılığıyla kontrol edilen cihaz ses düzeyiyle belirlenir. Ancak uygulamalar, ses deneyimini özelleştirmek için ses düzeylerini cihaz sesine göre bağımsız olarak ayarlayabilir.

Uygulama açma, banner, geçiş reklamı, ödüllü reklam ve ödüllü geçiş reklamı reklam biçimleri için applicationVolume mülkünü ayarlayarak Google Mobile Ads SDK'sına göreli uygulama hacmini bildirebilirsiniz. Geçerli reklam hacmi değerleri 0.0 (sessiz) ile 1.0 (mevcut cihaz ses seviyesi) aralığındadır. SDK'ya göreli uygulama hacmini nasıl bildireceğinize dair bir örnek aşağıda verilmiştir:

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

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

Swift

GADMobileAds.sharedInstance().applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

Varsayılan olarak applicationVolume, 1 (mevcut cihaz ses düzeyi) ve applicationMuted, NO olarak ayarlanmıştır.

Yerel reklamlar

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

Ses oturumları

Ses oturumları, uygulamanızın ses davranışıyla ilgili niyetlerinizi sisteme ifade etmenize olanak tanır. Ses oturumları hakkında daha fazla bilgiyi Apple'ın Ses Oturumları Programlama Kılavuzu'nda bulabilirsiniz. Google Mobile Ads SDK'sı sesini yönetmek için kullanılabilen seçenekler audioVideoManager mülkü üzerinden kullanılabilir.

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 nasıl ve ne zaman ses çaldığı konusunda daha fazla kontrole sahip olmak istiyorsanız bu API'lerden yararlanabilirsiniz.

Ses oturumu kategorisini yönetme sorumluluğunu kendiniz üstlenmek istiyorsanız ses video yöneticisinde audioSessionIsApplicationManaged mülkünü YES olarak ayarlayabilirsiniz.

Ses oturumu kategorisini yönetmek istiyorsanız GADAudioVideoManagerDelegate'u uygulayabilir ve reklam video ve ses oynatma etkinlikleri hakkında bildirim almak için işitsel video yöneticisinde delegate mülkünü ayarlayabilirsiniz. Ardından, Apple'ın Ses Oturumu Programlama Kılavuzu'na göre ses oturumu kategorisini ilgili kategoriyle değiştirmeniz gerekir.

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

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

Kilitlenme raporu

Google Mobile Ads SDK'sı, iOS uygulamasında oluşan istisnaları inceler ve SDK'dan kaynaklanan istisnaları kaydeder. Bu istisnalar daha sonra gelecekteki SDK sürümlerinde ele alınır.

Kilitlenme bildirme 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ğırmanın en iyi zamanı uygulamanın başlatıldığı zamandır:

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

Uygulamanızın özel gereksinimleri varsa isteğe bağlı NSUserDefaults gad_has_consent_for_cookies seçeneğini belirleyebilirsiniz. Google Mobile Ads SDK'sı, gad_has_consent_for_cookies tercihi sıfır olarak ayarlanmışsa sınırlı reklamları (LTD) etkinleştirir.

Swift

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

Objective-C

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