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

คลาส MobileAds มีการตั้งค่าส่วนกลางสำหรับ Google Mobile Ads SDK (เบต้า)

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

หากแอปของคุณมีการควบคุมระดับเสียงในตัว (เช่น ระดับเสียงเพลงหรือเอฟเฟกต์เสียงที่กำหนดเอง) การเปิดเผยระดับเสียงของแอปต่อ Google Mobile Ads 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 Google Mobile Ads SDK (beta) on a background thread.
    MobileAds.initialize(
      this@MainActivity,
      // Sample AdMob 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)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize Google Mobile Ads SDK (beta) on a background thread.
            MobileAds.initialize(
                this,
                // Sample AdMob 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)

Java

MobileAds.setUserMutedApp(true);

โดยค่าเริ่มต้น ระบบจะตั้งระดับเสียงของแอปเป็น 1 (ระดับเสียงปัจจุบันของอุปกรณ์) และ แอปจะไม่ปิดเสียง

หมายเหตุ: โฆษณาวิดีโอที่ไม่มีสิทธิ์แสดงพร้อมเสียงที่ปิดอยู่จะไม่ แสดงสําหรับคําขอโฆษณาที่ทําเมื่อมีการรายงานระดับเสียงของแอปว่าปิดเสียงอยู่หรือตั้งค่าเป็น ค่า 0 ซึ่งอาจจำกัดไม่ให้โฆษณาวิดีโอกลุ่มย่อยจากกลุ่มโฆษณาวิดีโอที่กว้างขึ้น

แสดง

ความยินยอมในการใช้คุกกี้

หากแอปมีข้อกำหนดพิเศษ คุณสามารถตั้งค่า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();