전체 설정

플랫폼 선택: Android Android iOS Unity

GADMobileAds 클래스는 Google Mobile Ads SDK에서 수집하는 특정 정보를 제어하기 위한 전역 설정을 제공합니다.

동영상 광고 볼륨 제어

참고: 동영상 볼륨 컨트롤은 Google 광고에만 적용되며 미디에이션 네트워크로 전달되지 않습니다.

앱에 맞춤 음악 또는 음향 효과 볼륨과 같은 자체 볼륨 컨트롤이 있는 경우 앱 볼륨을 Google Mobile Ads SDK에 공개하면 동영상 광고에서 앱 볼륨 설정을 준수할 수 있습니다. 이렇게 하면 사용자에게 예상되는 오디오 볼륨으로 동영상 광고가 제공됩니다.

볼륨 버튼 또는 OS 수준 볼륨 슬라이더를 통해 조절되는 기기 볼륨은 기기 오디오 출력 볼륨을 결정합니다. 그러나 앱의 경우 기기 볼륨에 대한 비율로 정의되는 자체 볼륨을 조절해 오디오 환경을 맞춤설정할 수 있습니다.

앱 오프닝 광고, 배너 광고, 전면 광고, 보상형 광고, 보상형 전면 광고 형식의 경우 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.
  MobileAds.shared.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;
  ...
}

경고:앱의 오디오 볼륨을 낮추면 동영상 광고 게재자격이 줄어들고 앱의 광고 수익이 감소할 수 있습니다. 이 API는 앱에서 사용자에게 맞춤 볼륨 컨트롤을 제공하고 사용자의 볼륨이 API에 올바르게 반영되는 경우에만 사용해야 합니다.

앱 오프닝 광고, 배너 광고, 전면 광고, 보상형 광고, 보상형 전면 광고 형식의 경우 Google Mobile Ads SDK에 앱 볼륨이 음소거되었음을 알릴 수 있습니다. applicationMuted 속성을 설정합니다.

Swift

MobileAds.shared.applicationMuted = true

Objective-C

GADMobileAds.sharedInstance.applicationMuted = YES;

기본적으로 applicationVolume은 1 (현재 기기 볼륨)로 설정되고 applicationMuted는 NO로 설정됩니다.

경고: 앱을 음소거하면 동영상 광고 게재자격이 줄어들고 앱의 광고 수익이 감소할 수 있습니다. 이 API는 앱에서 사용자에게 맞춤 음소거 컨트롤을 제공하고 사용자의 음소거 결정이 API에 올바르게 반영되는 경우에만 사용해야 합니다.

네이티브 광고

음소거 설정을 제어하는 방법에 관한 안내는 GADVideoOptions 를 참고하세요. 네이티브 광고의 경우 맞춤 볼륨 컨트롤이 지원되지 않습니다.

오디오 세션

오디오 세션을 통해 앱의 오디오 동작에 대한 개발자의 의도를 시스템에 반영할 수 있습니다. 오디오 세션에 대한 자세한 내용은 Apple의 오디오 세션 프로그래밍 가이드를 참고하세요. 오디오를 관리하는 데 사용할 수 있는 옵션은 audioVideoManager 속성을 사용하는 것입니다.Google Mobile Ads SDK

앱에서 오디오를 사용하지 않는 경우 이러한 API를 사용할 필요가 없습니다. Google Mobile Ads SDK는 오디오를 재생할 때 오디오 세션 카테고리를 자동으로 관리합니다. 앱에서 오디오를 재생하고 에서 오디오를 재생하는 방법과 시기를 더 엄격하게 제어하려면 이러한 API를 사용하면 됩니다.Google Mobile Ads SDK

오디오 동영상 관리자에서 오디오 세션 카테고리를 직접 관리하려면 audioSessionIsApplicationManaged 속성을 YES로 설정하면 됩니다.

오디오 세션 카테고리를 관리하려면 GADAudioVideoManagerDelegate 를 구현하고 오디오 동영상 관리자에서 delegate 속성을 설정하여 광고 동영상 및 오디오 재생 이벤트에 대한 알림을 받으면 됩니다. 그런 다음 Apple의 오디오 세션 프로그래밍 가이드에 따라 오디오 세션 카테고리를 관련 카테고리로 변경해야 합니다.

핵심 사항: 기본적으로 SDK는 음소거된 광고를 재생할 때 오디오 세션 카테고리를 AVAudioSessionCategoryAmbient로 설정합니다. 이 시나리오에서 앱이 AVAudioSessionCategoryOptionDuckOthers 를 사용하도록 하려면 GADAudioVideoManagerDelegate 프로토콜 을 구현하고 오디오 동영상 관리자 audioSessionIsApplicationManaged를 YES로 설정해야 합니다.

다음은 앱에서 음악을 재생하는 경우 위의 API를 사용하여 권장되는 접근 방식을 보여주는 간단한 코드 샘플입니다.

Swift

func setUp() {
  MobileAds.shared.audioVideoManager.delegate = self
  MobileAds.shared.audioVideoManager.audioSessionIsApplicationManaged = false
}

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

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

Objective-C

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

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // Google 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 {
    // Google 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];
}

비정상 종료 보고

Google Mobile Ads SDK는 iOS 앱에서 발생하는 예외를 검사하고 SDK로 인해 발생한 경우 이를 기록합니다. 이러한 예외는 향후 SDK 버전에서 해결됩니다.

비정상 종료 보고는 기본적으로 사용 설정되어 있습니다. SDK 관련 예외를 기록하지 않으려면 disableSDKCrashReporting 메서드를 호출하여 이 기능을 사용 중지하면 됩니다. 이 메서드를 호출하기 가장 좋은 시기는 앱이 실행될 때입니다.

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    MobileAds.shared.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를 설정할 수 있습니다. Google Mobile Ads SDK는 제한적인 광고 (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");