إعدادات عمومية

توفّر فئة MobileAds إعدادات عامة لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

التحكّم في مستوى صوت إعلانات الفيديو

إذا كان تطبيقك يتضمّن عناصر تحكّم في مستوى الصوت (مثل مستويات مخصّصة للموسيقى أو المؤثرات الصوتية)، يؤدي الإفصاح عن مستوى صوت التطبيق لحزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى السماح لإعلانات الفيديو بمراعاة إعدادات مستوى الصوت في التطبيق. يضمن ذلك ظهور إعلانات فيديو للمستخدمين بمستوى الصوت المتوقّع.

يحدِّد مستوى صوت الجهاز، الذي يتم التحكّم به من خلال أزرار التحكّم بمستوى الصوت أو شريط تمرير مستوى الصوت على مستوى نظام التشغيل، مستوى صوت إخراج الصوت في الجهاز. ومع ذلك، يمكن للتطبيقات تعديل مستويات الصوت بشكل مستقل مقارنةً بمستوى صوت الجهاز من أجل تخصيص تجربة الصوت. بالنسبة إلى أشكال الإعلانات على شاشة فتح التطبيق وإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات البينية التي تضم مكافأة، يمكنك الإبلاغ عن حجم التطبيق النسبي لحزمة تطوير البرامج (SDK) من خلال الطريقة الثابتة setAppVolume(). تتراوح القيم الصالحة لمستوى صوت الإعلانات بين 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 (مستوى الصوت الحالي للجهاز)، ولا يتم كتم صوت التطبيق.

إعلانات مدمجة مع المحتوى

اطّلِع على VideoOptions للحصول على تعليمات حول كيفية التحكّم في إعدادات كتم الصوت. لا تتوفّر ميزة التحكّم المخصّص بمستوى الصوت للإعلانات المدمجة.

الموافقة على ملفات تعريف الارتباط

إذا كان تطبيقك يتضمّن متطلبات خاصة، يمكنك ضبط الرمز الاختياري SharedPreferences gad_has_consent_for_cookies. وستسمح حزمة تطوير البرامج (SDK) بعرض الإعلانات المحدودة (LTD) عند ضبط الإعدادات المفضّلة gad_has_consent_for_cookies على صفر.

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