PIP 모드 광고 구현 (베타)

플랫폼 선택: Android iOS

PIP 모드

PIP 모드 광고는 기사, 피드, 게임플레이와 같은 화면의 콘텐츠 위에 표시되는 플로팅 창에 표시됩니다. 이 형식을 사용하면 광고가 표시된 상태에서 사용자가 앱과 상호작용할 수 있습니다. 전체 화면을 차지하지 않는 광고를 표시하려면 이 형식을 선택하세요. PIP 광고에 대해 자세히 알아보세요.

이 가이드에서는 Google Mobile Ads SDK를 사용하여 앱에서 PIP 광고를 요청하고 표시하는 방법을 설명합니다.

시작하기 전에

계속하기 전에 다음을 수행하세요.

광고 로드

GADPictureInPictureAd 객체를 로드하려면 광고 요청을 만들고 load 메서드를 호출하세요.

Swift

private func loadPictureInPictureAd() async {
  do {
    // Capture the PictureInPictureAd reference for later use.
    pipAd = try await PictureInPictureAd.load(
      with: adUnitID, request: Request())
    // Set the delegate to be notified of ad events.
    pipAd?.delegate = self
  } catch {
    print(
      "Picture-in-Picture ad failed to load: \(error.localizedDescription)")
  }
}

adUnitID를 광고 단위 ID로 바꿉니다.

Objective-C

- (void)loadPictureInPictureAd {
  GADRequest *request = [GADRequest request];

  [GADPictureInPictureAd
       loadWithAdUnitID:kAdUnitID
                request:request
      completionHandler:^(GADPictureInPictureAd *_Nullable ad, NSError *_Nullable error) {
        if (error) {
          NSLog(@"Picture-in-Picture ad failed to load: %@", error);
          return;
        }
        // Capture the PictureInPictureAd reference for later use.
        self.pipAd = ad;
        // Set the delegate to be notified of ad events.
        self.pipAd.delegate = self;
      }];
}

kAdUnitID를 광고 단위 ID로 바꿉니다.

광고 게재

화면에 PIP 광고를 표시하려면 PIP 옵션을 구성하고 show 메서드를 호출합니다. 다음 예에서는 광고의 기본 위치와 프레젠테이션 범위를 화면으로 설정합니다.

Swift

private func showPictureInPictureAd() {
  // Use the loaded PictureInPictureAd instance.
  guard let pipAd else {
    print("No ad to show.")
    return
  }
  let options = PictureInPictureAdOptions()
  // Uses the Google Mobile Ads SDK's default screen position.
  options.position = .default
  // Binds the ad lifecycle to the host screen.
  options.presentationScope = .screen

  pipAd.show(with: options)
}

Objective-C

- (void)showPictureInPictureAd {
  // Use the loaded PictureInPictureAd instance.
  if (!self.pipAd) {
    NSLog(@"No ad to show.");
    return;
  }
  GADPictureInPictureAdOptions *options =
      [[GADPictureInPictureAdOptions alloc] init];
  // Uses the Google Mobile Ads SDK's default screen position.
  options.position = GADPictureInPictureAdPositionDefault;
  // Binds the ad lifecycle to the host screen.
  options.presentationScope = GADPictureInPictureAdPresentationScopeScreen;

  [self.pipAd showWithOptions:options];
}

위치 설정

기본적으로 Google Mobile Ads SDK는 처음 표시될 때 화면의 오른쪽 하단에 PIP 광고를 표시하거나 이전에 표시된 경우 마지막으로 알려진 위치에 표시합니다. 광고가 표시되는 위치를 맞춤설정하려면 PIP 옵션에서 위치를 설정하세요. 다음 예에서는 화면 왼쪽 상단의 콘텐츠 위에 위치를 설정합니다.

Swift

private func createTopLeftPositionOptions() -> PictureInPictureAdOptions {
  let options = PictureInPictureAdOptions()
  // Sets the ad position to the top-left corner of the screen.
  options.position = .topLeft
  return options
}

Objective-C

- (GADPictureInPictureAdOptions *)createTopLeftPositionOptions {
  GADPictureInPictureAdOptions *options =
      [[GADPictureInPictureAdOptions alloc] init];
  // Sets the ad position to the top-left corner of the screen.
  options.position = GADPictureInPictureAdPositionTopLeft;
  return options;
}

지원 가능한 모든 직책은 GADPictureInPictureAdPosition을 참고하세요.

프레젠테이션 범위 설정

기본적으로 Google Mobile Ads SDK는 PIP 광고를 현재 호스트 화면에 바인딩합니다. 호스트 화면의 뷰 계층 구조가 더 이상 메모리에 없으면 Google Mobile Ads SDK가 광고를 닫습니다. 호스트 화면이 메모리에서 삭제된 후에도 광고가 계속 표시되도록 하려면 프레젠테이션 범위를 애플리케이션으로 설정하세요.

Swift

private func createApplicationScopedOptions() -> PictureInPictureAdOptions {
  let options = PictureInPictureAdOptions()
  // Keeps the ad visible beyond the host screen's lifecycle.
  options.presentationScope = .application
  return options
}

Objective-C

- (GADPictureInPictureAdOptions *)createApplicationScopedOptions {
  GADPictureInPictureAdOptions *options =
      [[GADPictureInPictureAdOptions alloc] init];
  // Keeps the ad visible beyond the host screen's lifecycle.
  options.presentationScope = GADPictureInPictureAdPresentationScopeApplication;
  return options;
}

자세한 내용은 여러 화면에서 광고가 표시되도록 유지하기를 참고하세요.

광고 이벤트 콜백 설정

PIP 광고 수명 주기 이벤트를 처리하려면 광고를 표시하기 전에 광고에 이벤트 콜백을 설정하세요. 이 콜백은 클릭, 노출과 같은 표준 이벤트를 보고합니다. 이 콜백은 광고가 표시되거나 숨겨지는 경우와 같은 PIP 관련 이벤트도 보고합니다.

Swift

func pictureInPictureAdDidShow(_ pictureInPictureAd: PictureInPictureAd) {
  print("Picture-in-Picture ad shown.")
}

func pictureInPictureAdDidHide(_ pictureInPictureAd: PictureInPictureAd) {
  print("Picture-in-Picture ad hidden.")
}

func pictureInPictureAdDidFailToShow(
  _ pictureInPictureAd: PictureInPictureAd, error: Error
) {
  print("Picture-in-Picture ad failed to show: \(error.localizedDescription)")
}

func pictureInPictureAdDidRecordImpression(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad recorded an impression.")
}

func pictureInPictureAdDidRecordClick(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad recorded a click.")
}

func pictureInPictureAdWillPresentScreen(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad will present screen.")
}

func pictureInPictureAdWillDismissScreen(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad will dismiss screen.")
}

func pictureInPictureAdDidDismissScreen(
  _ pictureInPictureAd: PictureInPictureAd
) {
  print("Picture-in-Picture ad dismissed screen.")
}

Objective-C

- (void)pictureInPictureAdDidShow:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad shown.");
}

- (void)pictureInPictureAdDidHide:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad hidden.");
}

- (void)pictureInPictureAdDidFailToShow:(GADPictureInPictureAd *)pictureInPictureAd
                              withError:(NSError *)error {
  NSLog(@"Picture-in-Picture ad failed to show: %@", error);
}

- (void)pictureInPictureAdDidRecordImpression:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad recorded an impression.");
}

- (void)pictureInPictureAdDidRecordClick:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad recorded a click.");
}

- (void)pictureInPictureAdWillPresentScreen:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad will present screen.");
}

- (void)pictureInPictureAdWillDismissScreen:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad will dismiss screen.");
}

- (void)pictureInPictureAdDidDismissScreen:(GADPictureInPictureAd *)pictureInPictureAd {
  NSLog(@"Picture-in-Picture ad dismissed screen.");
}

광고 숨기기

화면에서 플로팅 광고를 삭제하려면 hide 메서드를 호출합니다. 이 메서드는 광고 숨김 이벤트 콜백을 호출합니다.

Swift

private func hidePictureInPictureAd() {
  // Use the loaded PictureInPictureAd instance.
  guard let pipAd else {
    print("No ad to hide.")
    return
  }
  pipAd.hide()
}

Objective-C

- (void)hidePictureInPictureAd {
  // Use the loaded PictureInPictureAd instance.
  if (!self.pipAd) {
    NSLog(@"No ad to hide.");
    return;
  }
  [self.pipAd hide];
}

광고 리소스 정리

메모리 누수를 방지하려면 앱에서 광고 사용을 완료할 때 광고 객체에 대한 참조를 삭제하세요. 예를 들어 앱이 더 이상 광고를 표시하거나 광고와 다시 상호작용하지 않는 경우입니다. 화면 범위 광고의 경우 앱이 메모리에서 호스트 화면을 삭제할 때 참조를 삭제합니다. 앱 범위 광고의 경우 사용자가 화면 간에 이동하는 동안 광고 참조를 유지하고 사용자가 광고를 닫으면 참조를 삭제합니다.

Swift

private func cleanUpPictureInPictureAd() {
  pipAd?.hide()
  pipAd = nil
}

Objective-C

- (void)cleanUpPictureInPictureAd {
  [self.pipAd hide];
  self.pipAd = nil;
}

여러 화면에서 광고가 표시되도록 유지

프레젠테이션 범위를 애플리케이션으로 설정하면 앱이 호스팅 화면을 메모리에서 삭제해도 PIP 광고가 계속 표시됩니다. 사용자가 호스트 화면에서 벗어날 때 광고와 상호작용하거나 광고를 닫으려면 앱이 PIP 광고에 대한 액세스 권한을 유지해야 합니다. 단일 화면의 인스턴스 변수보다는 앱 수준 싱글톤 또는 공유 상태 관리자에 광고를 보유하는 것이 좋습니다.