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

คลาส GADMobileAds มีการตั้งค่าส่วนกลางสำหรับการควบคุมข้อมูลบางอย่างที่เก็บรวบรวมโดย SDK โฆษณาในอุปกรณ์เคลื่อนที่

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

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

ระดับเสียงของอุปกรณ์ซึ่งควบคุมผ่านปุ่มปรับระดับเสียงหรือแถบเลื่อนปรับระดับเสียงในระดับระบบปฏิบัติการจะเป็นตัวกำหนดระดับเสียงสำหรับเอาต์พุตเสียงของอุปกรณ์ อย่างไรก็ตาม แอปสามารถปรับระดับเสียงตามระดับเสียงของอุปกรณ์เพื่อปรับแต่งประสบการณ์เสียงได้

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

Swift

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance().applicationVolume = 0.5
  ...
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance.applicationVolume = 0.5;
  ...
}

สําหรับรูปแบบโฆษณาเพื่อเปิดแอป แบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล คุณสามารถแจ้งให้ Google Mobile Ads SDK ทราบว่าเสียงของแอปถูกปิดอยู่โดยการตั้งค่าพร็อพเพอร์ตี้ applicationMuted ดังนี้

Swift

GADMobileAds.sharedInstance().applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

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

โฆษณาเนทีฟ

ดูวิธีการควบคุมการตั้งค่าการปิดเสียงได้ที่ GADVideoOptions สําหรับโฆษณาเนทีฟ ระบบไม่รองรับการควบคุมระดับเสียงที่กําหนดเอง

เซสชันเสียง

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

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

ในเครื่องมือจัดการวิดีโอและเสียง คุณสามารถตั้งค่าพร็อพเพอร์ตี้ audioSessionIsApplicationManaged เป็น YES ได้หากต้องการรับผิดชอบในการจัดการหมวดหมู่เซสชันเสียงด้วยตนเอง

หากต้องการจัดการหมวดหมู่เซสชันเสียง ให้ใช้ GADAudioVideoManagerDelegate และตั้งค่าพร็อพเพอร์ตี้ delegate ในเครื่องมือจัดการวิดีโอเสียงเพื่อรับการแจ้งเตือนเกี่ยวกับเหตุการณ์การเล่นวิดีโอและเสียงของโฆษณา จากนั้นคุณควรเปลี่ยนหมวดหมู่เซสชันเสียงเป็นหมวดหมู่ที่เกี่ยวข้องตามคู่มือการเขียนโปรแกรมเซสชันเสียงของ Apple

ตัวอย่างโค้ดที่เรียบง่ายซึ่งแสดงแนวทางที่แนะนำหากแอปเล่นเพลงโดยใช้ API ข้างต้นมีดังนี้

Swift

func setUp() {
  GADMobileAds.sharedInstance().audioVideoManager.delegate = self
  GADMobileAds.sharedInstance().audioVideoManager.audioSessionIsApplicationManaged = false
}

// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  MyAppObject.sharedInstance().pauseAllMusic()
}

func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Mobile Ads SDK is notifying your app that it has stopped playing
  // audio. Depending on your design, you could resume music here.
  MyAppObject.sharedInstance().resumeAllMusic()
}

Objective-C

- (void)setUp {
  GADMobileAds.sharedInstance.audioVideoManager.delegate = self;
  GADMobileAds.sharedInstance.audioVideoManager.audioSessionIsApplicationManaged = NO;
}

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // The Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  [MyAppObject.sharedInstance pauseAllMusic];
}

- (void)audioVideoManagerDidStopPlayingAudio:(GADAudioVideoManager *)audioVideoManager {
    // The Mobile Ads SDK is notifying your app that it has stopped playing
    // audio. Depending on your design, you could resume music here.
  [MyAppObject.sharedInstance resumeAllMusic];
}

รายงานข้อขัดข้อง

SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะตรวจสอบข้อยกเว้นที่เกิดขึ้นในแอป iOS และบันทึกไว้หากเกิดจาก SDK จากนั้นเราจะแก้ไขข้อยกเว้นเหล่านี้ใน SDK เวอร์ชันในอนาคต

การรายงานข้อขัดข้องจะเปิดใช้โดยค่าเริ่มต้น หากไม่ต้องการให้บันทึกข้อยกเว้นที่เกี่ยวข้องกับ SDK คุณสามารถปิดใช้ฟีเจอร์นี้ได้โดยเรียกใช้เมธอด disableSDKCrashReporting เวลาที่ดีที่สุดในการเรียกใช้เมธอดนี้คือเมื่อแอปเปิดขึ้น

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.disableSDKCrashReporting()
    return true
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

หากแอปมีข้อกำหนดพิเศษ คุณสามารถตั้งค่าตัวเลือก NSUserDefaults gad_has_consent_for_cookies SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google จะเปิดใช้ โฆษณาแบบจํากัด (LTD) หากตั้งค่าค่ากําหนด gad_has_consent_for_cookies เป็น 0

Swift

UserDefaults.standard.set(0, forKey: "gad_has_consent_for_cookies")

Objective-C

NSUserDefaults.standardUserDefaults().setObject(Int(0),
    forKey: "gad_has_consent_for_cookies");