تنظیمات سراسری

کلاس GADMobileAds تنظیمات سراسری برای کنترل برخی‌از اطلاعات جمع‌آوری‌شده توسط Google Mobile Ads SDK را ارائه می‌دهد.

کنترل میزان صدای آگهی ویدیویی

اگر برنامه شما کنترل‌های میزان صدای خود را دارد، مانند میزان صدای موسیقی سفارشی یا جلوه‌های صوتی، آشکار کردن میزان صدای برنامه برای Google Mobile Ads SDK باعث می‌شود تبلیغات ویدیویی تنظیمات میزان صدای برنامه را رعایت کنند. این کار تضمین می‌کند که کاربران آگهی‌های ویدیویی را با حجم صدای موردانتظار دریافت کنند.

میزان صدای دستگاه که ازطریق دکمه‌های صدا یا لغزنده صدای سطح سیستم‌عامل کنترل می‌شود، میزان صدای خروجی صوتی دستگاه را تعیین می‌کند. بااین‌حال، برنامه‌ها می‌توانند به‌طور مستقل سطوح صدا را نسبت به صدای دستگاه تنظیم کنند تا تجربه صوتی را سفارشی کنند.

برای قالب‌های آگهی «باز کردن برنامه»، «برنما»، «بینابینی»، «پاداش‌دار»، و «بینابینی پاداش‌دار»، می‌توانید حجم نسبی برنامه را با تنظیم کردن دارایی applicationVolume به Google Mobile Ads SDK گزارش کنید. مقادیر معتبر حجم آگهی از 0.0 (بی‌صدا) تا 1.0 (حجم فعلی دستگاه) متغیر است. در اینجا مثالی از نحوه گزارش حجم نسبی برنامه به کیت توسعه نرم‌افزار آورده شده است:

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

برای قالب‌های تبلیغ «باز کردن برنامه»، «برنمایی»، «بینابینی»، «پاداش‌دار»، و «بینابینی پاداش‌دار»، می‌توانید با تنظیم کردن دارایی applicationMuted به Google Mobile Ads SDK اطلاع دهید که صدای برنامه بی‌صدا شده است:

MobileAds.shared.applicationMuted = true

GADMobileAds.sharedInstance.applicationMuted = YES;

به‌طور پیش‌فرض، applicationVolume روی 1 (حجم دستگاه فعلی) تنظیم شده است و applicationMuted روی NO تنظیم شده است.

آگهی‌های بومی

برای دستورالعمل‌های کنترل تنظیمات بی‌صدا کردن، GADVideoOptions را ببینید. برای آگهی‌های بومی، پشتیبانی از کنترل صدای سفارشی وجود ندارد.

جلسات صوتی

جلسه‌های صوتی به شما امکان می‌دهند اهداف خود را برای عملکرد صوتی برنامه‌تان به سیستم اعلام کنید. اطلاعات تکمیلی درباره جلسات صوتی را می‌توانید در راهنمای برنامه‌نویسی جلسه صوتی Apple پیدا کنید. گزینه‌های دردسترس برای مدیریت صدای Google Mobile Ads SDK ازطریق دارایی audioVideoManager است.

اگر در برنامه‌تان از صدا استفاده نمی‌کنید، نیازی به استفاده از این میاناهای برنامه‌سازی کاربردی ندارید. وقتی Google Mobile Ads SDK صدا پخش می‌کند، دسته جلسه صوتی را به‌طور خودکار مدیریت می‌کند. اگر در برنامه‌تان صدا پخش می‌کنید و می‌خواهید کنترل بیشتری روی نحوه و زمان پخش صدا توسط Google Mobile Ads SDK داشته باشید، می‌توانید از این میاناهای برنامه‌سازی کاربردی استفاده کنید.

در مدیر ویدیو صوتی، می‌توانید audioSessionIsApplicationManaged دارایی را روی YES تنظیم کنید اگر می‌خواهید خودتان مسئولیت مدیریت دسته جلسه صوتی را برعهده بگیرید.

اگر می‌خواهید دسته جلسه صوتی را مدیریت کنید، می‌توانید GADAudioVideoManagerDelegate را پیاده‌سازی کنید و دارایی delegate را در مدیر ویدیو صوتی تنظیم کنید تا از رویدادهای بازپخش ویدیو و صدای آگهی مطلع شوید. سپس باید دسته جلسه صوتی را به دسته مربوطه طبق راهنمای برنامه‌نویسی جلسه صوتی Apple تغییر دهید.

در اینجا نمونه کد ساده‌شده‌ای ارائه شده است که رویکرد توصیه‌شده را درصورتی‌که برنامه شما بااستفاده از میاناهای برنامه‌سازی کاربردی بالا موسیقی پخش می‌کند نشان می‌دهد:

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

گزارش خرابی

‫Google Mobile Ads SDK استثناهایی را که در برنامه iOS رخ می‌دهد بازرسی می‌کند و اگر این استثناها ناشی از کیت توسعه نرم‌افزار باشد، آن‌ها را ثبت می‌کند. این استثناها سپس در نسخه‌های بعدی کیت توسعه نرم‌افزار رسیدگی می‌شوند.

گزارش خرابی به‌طور پیش‌فرض فعال است. اگر نمی‌خواهید استثناهای مربوط به کیت توسعه نرم‌افزار ضبط شود، می‌توانید این ویژگی را با فراخوانی روش disableSDKCrashReporting غیرفعال کنید. بهترین زمان برای فراخوانی این روش هنگام راه‌اندازی برنامه است:

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

موافقت با تنظیمات کوکی‌ها

اگر برنامه شما الزامات ویژه‌ای دارد، می‌توانید NSUserDefaults gad_has_consent_for_cookies اختیاری را تنظیم کنید. اگر اولویت gad_has_consent_for_cookies روی صفر تنظیم شده باشد، Google Mobile Ads SDK آگهی‌های محدود (LTD) را فعال می‌کند.

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

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