تنظیمات جهانی

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

کنترل حجم تبلیغات ویدیویی

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

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

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

سویفت

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance().applicationVolume = 0.5
  ...
}

هدف-C

- (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 اطلاع دهید که حجم برنامه بی‌صدا شده است:

سویفت

GADMobileAds.sharedInstance().applicationMuted = true

هدف-C

GADMobileAds.sharedInstance.applicationMuted = YES;

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

تبلیغات بومی

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

جلسات صوتی

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

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

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

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

در اینجا یک نمونه کد ساده آمده است که اگر برنامه شما با استفاده از APIهای بالا موسیقی پخش می کند، رویکرد توصیه شده را نشان می دهد:

سویفت

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()
}

هدف-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];
}

گزارش خرابی

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

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

سویفت

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.disableSDKCrashReporting()
    return true
  }
}

هدف-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

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

سویفت

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

هدف-C

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