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

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

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

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

میزان صدای دستگاه که از طریق دکمه های صدا یا نوار لغزنده سطح سیستم عامل کنترل می شود، میزان صدا را برای خروجی صدای دستگاه تعیین می کند. با این حال، برنامه‌ها می‌توانند به‌طور مستقل سطح صدا را نسبت به میزان صدای دستگاه تنظیم کنند تا تجربه صوتی را متناسب کنند. برای قالب‌های تبلیغاتی باز، بنر، بینابینی، با پاداش و پاداش، می‌توانید حجم نسبی برنامه را از طریق روش ثابت setUserControlledAppVolume() به 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 (beta) on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      InitializationConfig.Builder("SAMPLE_APP_ID").build()
    ) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setUserControlledAppVolume(0.5f)
  }
}

جاوا

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

  new Thread(
          () -> {
            // Initialize Google Mobile Ads SDK (beta) on a background thread.
            MobileAds.initialize(
                this,
                // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                new InitializationConfig.Builder("SAMPLE_APP_ID")
                    .build(),
                initializationStatus -> {
                });
            
            // Set app volume to be half of current device volume.
            MobileAds.setUserControlledAppVolume(0.5f);
          })
      .start();
}

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

کاتلین

MobileAds.setUserMutedApp(true)

جاوا

MobileAds.setUserMutedApp(true);

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

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

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

اگر برنامه شما شرایط خاصی دارد، می توانید 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();