Genel Ayarlar

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

Video reklam ses seviyesi kontrolü

Uygulamanızın, özel müzik veya ses efekti gibi kendi ses seviyesi kontrolleri varsa uygulama ses düzeyini Google Mobile Ads SDK'sıyla paylaşmanız, video reklamların uygulama ses seviyesi ayarlarına uymasını sağlar. Bu, kullanıcıların beklenen ses düzeyine sahip video reklamlar almasını sağlar.

Cihazın ses düzeyi, ses düğmeleriyle veya işletim sistemi seviyesindeki ses kaydırma çubuğuyla kontrol edilir ve cihaz ses çıkışının ses düzeyini belirler. Ancak uygulamalar, ses deneyimini özelleştirmek için cihazın ses düzeyine göre ses düzeylerini 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 hacmi değerleri, 0.0 (sessiz) ile 1.0 (geçerli cihaz hacmi) aralığındadır. Aşağıda, göreli uygulama hacminin SDK'ya nasıl bildirileceğine dair bir örnek 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çılışı, Banner, Geçiş Reklamı, Ödüllü ve Ödüllü Geçiş reklamı biçimleri için applicationMuted özelliğini ayarlayarak Google Mobile Ads SDK'sına uygulama hacminin kapatıldığını bildirebilirsiniz:

Swift

GADMobileAds.sharedInstance().applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

Varsayılan olarak applicationVolume ayarı 1 (mevcut cihaz ses seviyesi) ve applicationMuted ise NO olarak ayarlandı.

Yerel reklamlar

Sesi kapatma ayarlarını kontrol etmeyle ilgili talimatlar için GADVideoOptions sayfasını inceleyin. Doğal reklamlarda özel ses kontrolü için destek sunulmaz.

Sesli oturumlar

Sesli oturumlar, sisteme uygulamanızın ses davranışıyla ilgili niyetinizi ifade etmenizi sağlar. Ses oturumlarıyla ilgili daha fazla bilgiyi Apple'ın Ses Oturumu Programlama Kılavuzu'nda bulabilirsiniz. Google Mobile Ads SDK'sı sesini yönetmek için kullanılabilen seçenekler audioVideoManager mülkü aracılığıyladır.

Uygulamanızda ses kullanmıyorsanız bu API'leri kullanmanız gerekmez. Google Mobile Ads SDK'sı, ses çaldığında ses oturumu kategorisini otomatik olarak yönetir. Uygulamanızda ses çalıyorsanız ve Google Mobile Ads SDK'sının ses çalmasını ve ne zaman çalacağını daha iyi kontrol etmek istiyorsanız bu API'lerden yararlanabilirsiniz.

Ses oturumu kategorisini kendiniz yönetme sorumluluğunu almak istiyorsanız audioSessionIsApplicationManaged özelliğini YES olarak ayarlayabilirsiniz.

Ses oturumu kategorisini yönetmek istiyorsanız GADAudioVideoManagerDelegate öğesini uygulayıp ses video yöneticisinde delegate özelliğini reklam videosu ve ses oynatma etkinlikleri hakkında bilgilendirilecek şekilde ayarlayabilirsiniz. Daha sonra ses oturumu kategorisini Apple'ın Ses Oturumu Programlama Kılavuzu'na göre ilgili kategoriyle değiştirmeniz gerekir.

Uygulamanız yukarıdaki API'leri kullanarak müzik çaldığında önerilen yaklaşımı gösteren basitleştirilmiş bir kod örneğini burada 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 kaynaklanıyorsa bunları kaydeder. Daha sonra bu istisnalar gelecekteki SDK sürümlerinde ele alınır.

Kilitlenme raporu 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 iyi zaman uygulamanın kullanıma sunulduğu 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 değerini ayarlayabilirsiniz. Google Mobile Ads SDK'sı, gad_has_consent_for_cookies tercihi sıfır olarak ayarlanırsa 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");