Creative Preview 및 게재 검사기

이 가이드에서는 인앱 미리보기 및 게재 검사기를 사용하여 광고 게재를 디버그하는 방법을 설명합니다.

인앱 미리보기를 사용하면 모바일 앱 내에서 렌더링된 나만의 광고 소재를 확인할 수 있습니다. 이 미리보기는 앱과 상호작용하는 광고 소재가 있거나, 고유한 동작이 있거나, 일부 렌더링 (네이티브 광고 소재 및 MRAID 포함)에 앱을 사용하는 게시자에게 특히 유용합니다.

게재 검사기는 어떤 광고가 게재되었는지에 관한 정보를 제공합니다. 예상치 못한 광고가 게재되는 경우 게재 검사기를 사용하여 이유를 알아보세요.

기본 요건

  • Google 모바일 광고 SDK 버전 7.13.1 이상
  • Google Ad Manager 계정에 액세스하기
  • 시작하기를 전체적으로 읽어보세요.

앱 준비

디버깅을 하려면 SDK의 디버그 옵션 메뉴와 상호작용해야 합니다. 메뉴를 열 때 권장되는 방법은 아래 함수를 앱에 포함하고 사용자 작업에 따라 트리거하는 것입니다.

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

Ad Manager 계정의 유효한 광고 단위이면 디버그 옵션 메뉴를 열 수 있습니다.

디버그 메뉴가 닫힐 때 알림 받기

프로그래매틱 방식으로 디버그 옵션 메뉴를 열 때는 GADDebugOptionsViewControllerDelegate를 구현하여 뷰 컨트롤러가 닫힐 때 알림을 받도록 선택할 수 있습니다. 이렇게 하려면 클래스가 대리자를 준수하도록 합니다.

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

@import GoogleMobileAds;
 
@interface ViewController : UIViewController <GADDebugOptionsViewControllerDelegate> {
}
 
@end

GADDebugOptionsViewController에서 위임을 설정합니다.

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  debugOptionsViewController.delegate = self
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  debugOptionsViewController.delegate = self;
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

마지막으로 대리자를 구현합니다.

Swift

func debugOptionsViewControllerDidDismiss(controller: GADDebugOptionsViewController) {
  print("Debug options view controller dismissed.")
}

Objective-C 

- (void)debugOptionsViewControllerDidDismiss:(GADDebugOptionsViewController *)controller {
  NSLog(@"Debug options view controller dismissed.");
}

디버그 옵션 메뉴를 여는 기능을 추가한 후 앱을 실행하고 위 함수를 트리거합니다. 다음 메뉴가 열립니다.

Creative Preview를 선택하여 기기를 연결합니다. 브라우저가 열리고 자동으로 브라우저로 이동하여 Ad Manager에 로그인됩니다. 로그인에 성공한 후 Ad Manager 계정에 등록할 기기 이름을 지정하고 확인을 클릭합니다.

기기가 연결되었습니다. 이 시점에서 Ad Manager 프런트엔드에 연결된 기기를 확인할 수 있습니다. 다른 사용자가 기기에 액세스하도록 허용할 수도 있습니다.

인앱 미리보기

단계에 따라 연결된 기기로 광고 소재를 푸시합니다. 푸시된 광고 소재가 광고 소재를 표시하려는 광고 슬롯에 타겟팅된 활성 광고 항목의 일부인지 확인합니다.

프런트엔드에서 광고 소재를 푸시한 후에는 기기에서 디버그 옵션 메뉴를 다시 트리거하고 Creative Preview를 다시 선택합니다. 이 단계를 통해 SDK는 Ad Manager를 다시 검사하여 기기 연결이 성공했는지 확인하고 푸시한 광고 소재에 관한 정보를 가져올 수 있습니다. 이전에 기기 연결에 성공하면 디버그 메뉴가 즉시 닫힙니다. 연결되지 않은 경우 계정을 다시 연결하라는 메시지가 표시됩니다.

마지막으로 미리 보려는 슬롯의 광고를 로드하여 광고 소재를 확인합니다.

게재 검사기

앱 문제 해결 시작 단계에 따라 앱 문제를 해결합니다. 단계를 성공적으로 완료하면 Ad Manager 프런트엔드에 요청이 표시되고 게재된 광고에 대한 자세한 정보를 볼 수 있습니다.