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

پلتفرم مورد نظر: اندروید، iOS و یونیتی

کلاس MobileAds تنظیمات سراسری برای SDK تبلیغات موبایلی گوگل (Google Mobile Ads SDK) را ارائه می‌دهد.

کنترل صدای تبلیغات ویدیویی

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

میزان صدای دستگاه که از طریق دکمه‌های صدا یا اسلایدر صدای سطح سیستم عامل کنترل می‌شود، میزان صدای خروجی صدای دستگاه را تعیین می‌کند. با این حال، برنامه‌ها می‌توانند به طور مستقل سطح صدا را نسبت به صدای دستگاه تنظیم کنند تا تجربه صوتی را متناسب کنند. برای قالب‌های تبلیغات بینابینی، بنری، بینابینی، پاداشی و پاداشی بینابینی، می‌توانید میزان صدای نسبی برنامه را از طریق متد static 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 (میزان صدای فعلی دستگاه) تنظیم شده است و برنامه بی‌صدا نیست.

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

تبلیغات بومی

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

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

اگر برنامه شما الزامات خاصی دارد، می‌توانید تنظیمات اختیاری SharedPreferences gad_has_consent_for_cookies تنظیم کنید. SDK زمانی که تنظیمات gad_has_consent_for_cookies روی صفر تنظیم شود ، تبلیغات محدود (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();