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

کلاس 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 the 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 the 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 تنظیم شده است (حجم فعلی دستگاه)، و برنامه بی صدا نیست.

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

تبلیغات بومی

برای دستورالعمل‌هایی در مورد نحوه کنترل تنظیمات بی‌صدا، به 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();