การตั้งค่าส่วนกลาง

คลาส MobileAds มีการกําหนดค่าส่วนกลางสําหรับ Google Mobile Ads SDK

การควบคุมระดับเสียงของโฆษณาวิดีโอ

หากแอปของคุณมีการควบคุมระดับเสียงในตัว (เช่น ระดับเสียงเพลงหรือเอฟเฟกต์เสียงที่กำหนดเอง) การเปิดเผยระดับเสียงของแอปต่อ Google Mobile Ads SDK จะช่วยให้โฆษณาวิดีโอเล่นตามการตั้งค่าระดับเสียงในแอปได้ ซึ่งจะช่วยให้ผู้ใช้ได้ยินเสียงโฆษณาวิดีโออย่างที่ควรจะเป็น

ระดับเสียงของอุปกรณ์ซึ่งควบคุมผ่านปุ่มปรับระดับเสียงหรือแถบเลื่อนปรับระดับเสียงในระดับระบบปฏิบัติการจะเป็นตัวกำหนดระดับเสียงสำหรับเอาต์พุตเสียงของอุปกรณ์ อย่างไรก็ตาม แอปสามารถปรับระดับเสียงตามระดับเสียงของอุปกรณ์เพื่อปรับแต่งประสบการณ์เสียงได้ สําหรับรูปแบบโฆษณาเปิดแอป แบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล คุณสามารถรายงานปริมาณแอปที่เกี่ยวข้องไปยัง 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 เป็น 0

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