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

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

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

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

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

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_my);

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

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.activity_main)

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

لإعلام حزمة SDK بأنّه تم كتم صوت التطبيق، استخدِم الطريقة setAppMuted():

Java

MobileAds.setAppMuted(true);

Kotlin

MobileAds.setAppMuted(true)

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

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

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

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

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

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

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()