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

اختيار النظام الأساسي: Android (إصدار تجريبي) Android iOS Unity

يوفر الصف MobileAds إعدادات عامة لـ GMA Next-Gen SDK.

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

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

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

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize GMA Next-Gen SDK on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample Ad Manager 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 GMA Next-Gen SDK on a background thread.
            MobileAds.initialize(
                this,
                // Sample Ad Manager 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() التالية:

Kotlin

MobileAds.setUserMutedApp(true)

جافا

MobileAds.setUserMutedApp(true);

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

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

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

إذا كان تطبيقك يتضمّن متطلبات خاصة، يمكنك ضبط 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()

جافا

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