배너 뷰는 화면 안의 한 지점을 차지하는 직사각형 이미지 또는 텍스트 광고입니다. 사용자가 앱과 상호작용하는 동안 화면에 표시되며 일정 시간이 지나면 자동으로 새로고침됩니다. 배너 뷰는 모바일 광고를 처음 시작할 때 사용하기 좋은 광고입니다. 우수사례
본 가이드에서는 배너 뷰를 Unity 앱에 통합하는 방법을 설명합니다. 코드 스니펫과 안내 외에도 배너 크기를 올바르게 조정하는 방법과 추가 리소스로 연결되는 링크가 이 가이드에 포함되어 있습니다.
기본 요건
- 시작 가이드에 따라 필요한 과정을 완료합니다.
항상 테스트 광고로 테스트합니다
아래 샘플 코드에는 테스트 광고 요청에 사용할 수 있는 광고 단위 ID가 포함되어 있습니다. 이 ID는 모든 요청에 대해 실제 광고가 아닌 테스트 광고를 반환하도록 구성되어서 안전하게 사용할 수 있습니다.
그러나 AdMob 웹 인터페이스에 앱을 등록하고 앱에서 사용할 광고 단위 ID를 직접 생성한 후에는 개발 중에 명확하게 기기를 테스트 기기로 설정하세요.
Android
ca-app-pub-3940256099942544/6300978111
iOS
ca-app-pub-3940256099942544/2934735716
모바일 광고 SDK 초기화
광고를 로드하기 전에 앱에서 MobileAds.Initialize()
를 호출하여 Google 모바일 광고 SDK를 초기화합니다. 이 작업은 앱 실행 시 한 번만 처리하면 됩니다.
using GoogleMobileAds;
using GoogleMobileAds.Api;
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize Google Mobile Ads SDK.
MobileAds.Initialize((InitializationStatus initStatus) =>
{
// This callback is called once the MobileAds SDK is initialized.
});
}
}
미디에이션을 사용하는 경우 광고 로드 전에 콜백이 발생할 때까지 기다려야 모든 미디에이션 어댑터가 초기화됩니다.
BannerView 예
다음 샘플 코드에는 배너 보기를 사용하는 방법이 자세히 나와 있습니다. 이 예에서는 배너 뷰의 인스턴스를 만들고, AdRequest
를 이용해 광고를 배너 뷰에 로드한 다음, 수명 주기 이벤트를 처리하여 기능을 확장합니다.
배너 뷰 만들기
배너 뷰를 사용하려면 가장 먼저 배너 뷰의 인스턴스를 만들어야 합니다.
AD_UNIT_ID를 광고 단위 ID로 바꿉니다.
BannerView
의 생성자에는 다음과 같은 파라미터가 포함됩니다.
adUnitId
: 로드할 배너 광고의 광고 단위 ID입니다.AdSize
: 사용할 배너 크기입니다.AdPosition
: 배너 뷰를 게재할 위치입니다.
(선택사항) 맞춤 위치로 배너 뷰 만들기
화면에서 배너 뷰의 위치를 AdPosition
의 값보다 더욱 세부적으로 지정하려면 x 좌표 및 y 좌표를 파라미터로 갖는 생성자를 사용하세요.
배너 뷰의 왼쪽 상단 모서리는 생성자에 전달된 x값 및 y값에 배치됩니다. 여기에서 원점은 화면의 왼쪽 상단입니다.
(선택사항) 맞춤 크기로 배너 뷰 만들기
AdSize
상수를 사용하는 것 외에도 광고에 맞춤 크기를 지정할 수 있습니다.
배너 광고 로드
광고를 로드하려면 AdRequest
를 만들고 LoadAd()
메서드에 전달합니다.
// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
배너 뷰 이벤트 수신 대기
광고의 작동 방식을 맞춤설정하려는 경우 광고의 수명 주기에서 여러 이벤트(예: 로드, 열기, 닫기)에 연결하면 됩니다. 이러한 이벤트를 수신 대기하려면 대리자를 등록하세요.
bannerView.OnBannerAdLoaded += () =>
{
// Raised when an ad is loaded into the banner view.
};
bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
// Raised when an ad fails to load into the banner view.
};
bannerView.OnAdPaid += (AdValue adValue) =>
{
// Raised when the ad is estimated to have earned money.
};
bannerView.OnAdImpressionRecorded += () =>
{
// Raised when an impression is recorded for an ad.
};
bannerView.OnAdClicked += () =>
{
// Raised when a click is recorded for an ad.
};
bannerView.OnAdFullScreenContentOpened += () =>
{
// Raised when an ad opened full screen content.
};
bannerView.OnAdFullScreenContentClosed += () =>
{
// Raised when the ad closed full screen content.
};
배너 뷰 소멸
배너 뷰 사용을 마치면 Destroy()
를 호출하여 리소스를 해제하세요.
if (bannerView != null)
{
// Always destroy the banner view when no longer needed.
bannerView.Destroy();
bannerView = null;
}
이렇게 하면 앱에서 배너 광고를 게재할 수 있습니다.
광고 새로고침
광고 단위가 새로고침되도록 설정한 경우 광고 로드에 실패했을 때 다른 광고를 요청하지 않아도 됩니다. Google 모바일 광고 SDK는 AdMob UI에 지정된 새로고침 빈도를 따릅니다. 새로고침을 사용 설정하지 않았다면 새로 요청하세요. 배너 광고에 자동 새로고침 사용에서 새로고침 빈도 설정과 같은 광고 단위 새로고침에 대한 자세한 내용을 참고하세요.
배너 크기
다음 표에는 표준 배너 크기가 나와 있습니다.
dp 단위의 크기(폭x높이) | 설명 | 사용 가능 기기 | AdSize 상수 |
---|---|---|---|
320x50 | 표준 배너 | 휴대전화 및 태블릿 | BANNER |
320x100 | 대형 배너 | 휴대전화 및 태블릿 | LARGE_BANNER |
300x250 | IAB 중간 직사각형 | 휴대전화 및 태블릿 | MEDIUM_RECTANGLE |
468x60 | IAB 원본 크기 배너 | 태블릿 | FULL_BANNER |
728x90 | IAB 리더보드 | 태블릿 | LEADERBOARD |
제공된 너비x조정 가능한 높이 | 적응형 배너 | 휴대전화 및 태블릿 | 해당 사항 없음 |
화면 너비x32|50|90 | 스마트 배너 | 휴대전화 및 태블릿 | SMART_BANNER |
스마트 배너 대신 사용할 수 있는 적응형 배너에 대해 자세히 알아보세요. |
추가 리소스
- HelloWorld 예시: 모든 광고 형식의 최소 구현입니다.