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

کلاس MobileAds تنظیمات کلی را برای Google Mobile Ads SDK ارائه می دهد.

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

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

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

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(this@MainActivity) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
  }
}

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize Google Mobile Ads SDK on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

برای اطلاع دادن به SDK مبنی بر بی صدا شدن حجم برنامه، از متد setAppMuted() استفاده کنید:

MobileAds.setAppMuted(true)

MobileAds.setAppMuted(true);

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

تبلیغات بومی

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

رضایت برای کوکی ها

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

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();