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

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

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

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

يحدِّد مستوى صوت الجهاز، الذي يتم التحكّم فيه من خلال أزرار التحكّم في مستوى الصوت أو شريط التمرير الخاص بمستوى الصوت على مستوى نظام التشغيل، مستوى صوت إخراج الصوت من الجهاز. ومع ذلك، يمكن للتطبيقات تعديل مستويات الصوت بشكل مستقل مقارنةً بمستوى صوت الجهاز من أجل تخصيص تجربة الصوت. بالنسبة إلى أشكال الإعلانات على شاشة فتح التطبيق وإعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات البينية التي تضم مكافأة، يمكنك الإبلاغ عن حجم التطبيق النسبي لحزمة تطوير البرامج (SDK) من خلال الطريقة الثابتة setAppVolume(). تتراوح القيم الصالحة لمستوى صوت الإعلانات بين 0.0 (صامت) و1.0 (مستوى صوت الجهاز الحالي). في ما يلي مثال على كيفية الإبلاغ عن حجم التطبيقات النسبي لحزمة تطوير البرامج (SDK):

Kotlin

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)
  }
}

Java

@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() الطريقة التالية:

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

يتم ضبط مستوى صوت التطبيق تلقائيًا على 1 (مستوى صوت الجهاز الحالي)، ولا يتم كتم صوت التطبيق.

ملاحظة: لا يتم عرض إعلانات الفيديو غير المؤهَّلة للعرض مع كتم الصوت في طلبات الإعلانات التي يتم إجراؤها عندما يتم الإبلاغ عن مستوى صوت التطبيق على أنّه مكتوم أو تم ضبطه على قيمة 0. وقد يؤدي ذلك إلى منع عرض مجموعة فرعية من مجموعة إعلانات الفيديو الأوسع نطاقًا.

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

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

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

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

Kotlin

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

Java

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