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

توفّر فئة 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);
    
    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {}
    });
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f);
    ...
}

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    MobileAds.initialize(this) {}
    
    // 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()