배너 광고는 화면 안의 한 지점을 차지하는 직사각형 이미지 또는 텍스트 광고입니다. 사용자가 앱과 상호작용하는 동안 화면에 머무르며 특정 시간이 지나면 자동으로 새로고침할 수 있습니다. 모바일 광고를 처음 시작하는 경우 배너 광고를 이용하는 것이 좋습니다. 우수사례
본 가이드에서는 AdMob의 배너 광고를 Unity 앱에 통합하는 방법을 설명합니다. 코드 스니펫과 안내 외에도 배너 크기 조정에 대한 정보와 추가 리소스로 연결되는 링크가 이 가이드에 포함되어 있습니다.
기본 요건
시작하기의 모든 단계를 완료하세요. Unity 앱에 Google 모바일 광고 Unity 플러그인이 있어야 합니다.
BannerView 만들기
배너를 표시하는 첫 번째 단계는 GameObject
에 첨부된 C# 스크립트에서
BannerView
객체를 만드는 것입니다.
Unity 편집기를 사용하여 보다 쉽게 광고를 통합하려면 새로운 광고 게재위치 베타를 사용해 보세요.
using System;
using UnityEngine;
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
private BannerView bannerView;
...
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize(initStatus => { });
this.RequestBanner();
}
private void RequestBanner()
{
#if UNITY_ANDROID
string adUnitId = "ca-app-pub-3940256099942544/6300978111";
#elif UNITY_IPHONE
string adUnitId = "ca-app-pub-3940256099942544/2934735716";
#else
string adUnitId = "unexpected_platform";
#endif
// Create a 320x50 banner at the top of the screen.
this.bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);
}
}
BannerView
의 생성자에는 다음과 같은 매개변수가 포함됩니다.
adUnitId
:BannerView
가 광고를 로드하는 AdMob 광고 단위 ID입니다.AdSize
: 사용할 AdMob 광고 크기입니다(자세한 내용은 배너 크기 참고).AdPosition
: 배너 광고를 넣을 위치입니다.AdPosition
열거형은 유효한 광고 게재순위 값을 나열합니다.
플랫폼에 따라 각기 다른 광고 단위가 사용됩니다. iOS에서 광고 요청을 하려면 iOS 광고 단위를 사용해야 하고, Android에서 광고 요청을 하려면 Android 광고 단위를 사용해야 합니다.
(선택사항) 맞춤 광고 게재순위
화면에서 BannerView
의 위치를
AdPosition
값보다 더욱 세부적으로 지정하려면 x 좌표 및 y 좌표를 매개변수로 갖는
BannerView
생성자를 사용하세요.
// Create a 320x50 banner ad at coordinate (0,50) on screen.
BannerView bannerView = new BannerView(adUnitId, AdSize.Banner, 0, 50);
BannerView
의 왼쪽 상단 모서리는 생성자에 전달된 x 값 및 y 값에 배치됩니다.
여기에서 원점은 화면의 왼쪽 상단입니다.
(선택사항) 맞춤 광고 크기
AdSize 상수를 사용하는 것 외에도 광고에 맞춤 크기를 지정할 수 있습니다.
AdSize adSize = new AdSize(250, 250);
BannerView bannerView = new BannerView(adUnitId, adSize, AdPosition.Bottom);
항상 테스트 광고로 테스트
위의 샘플 코드에는 광고 단위 ID가 포함되어 있으며, 이를 사용하여 광고를 요청할 수 있습니다. 이 ID는 모든 요청에 대해 실제 광고가 아닌 테스트 광고를 반환하도록 구성되어서 안전하게 사용할 수 있습니다.
그러나 AdMob UI에 앱을 등록하고 앱에서 사용할 광고 단위 ID를 직접 생성한 경우에는 개발 중에 명확하게 기기를 테스트 기기로 설정해야 합니다. 이는 매우 중요합니다. 실제 광고를 사용하여 테스트하면 (탭을 전혀 하지 않아도) AdMob 정책에 위배되므로 계정이 정지될 수 있습니다. 개발할 때 항상 테스트 광고를 받는 방법에 대해 알아보려면 테스트 광고를 참고하세요.
광고 로드
BannerView
가 인스턴스화되었으면 광고를 로드하세요. BannerView
클래스의
loadAd()
메서드를 사용하면 됩니다. 단일 광고 요청에 대한
런타임 정보(예: 타겟팅 정보)가 있는
AdRequest
인수를 사용합니다.
다음은 광고를 로드하는 방법을 보여주는 예입니다.
... private void RequestBanner() { #if UNITY_ANDROID string adUnitId = "ca-app-pub-3940256099942544/6300978111"; #elif UNITY_IPHONE string adUnitId = "ca-app-pub-3940256099942544/2934735716"; #else string adUnitId = "unexpected_platform"; #endif // Create a 320x50 banner at the top of the screen. this.bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top); // Create an empty ad request. AdRequest request = new AdRequest.Builder().Build(); // Load the banner with the request. this.bannerView.LoadAd(request); } ...
이렇게 하면 AdMob 배너 광고를 게재할 수 있습니다.
광고 이벤트
광고의 작동 방식을 추가로 맞춤설정하려는 경우 광고의 수명 주기(예: 로드, 열기, 닫기)에서
여러 이벤트에 연결할 수 있습니다. 아래와 같이
적절한 EventHandler
에 대한 대리자를 등록하여 이러한 이벤트를
수신합니다.
... using System; using UnityEngine; using GoogleMobileAds.Api; ... public class GoogleMobileAdsDemoScript : MonoBehaviour { private BannerView bannerView; public void Start() { this.RequestBanner(); } private void RequestBanner() { #if UNITY_ANDROID string adUnitId = "ca-app-pub-3940256099942544/6300978111"; #elif UNITY_IPHONE string adUnitId = "ca-app-pub-3940256099942544/2934735716"; #else string adUnitId = "unexpected_platform"; #endif this.bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top); // Called when an ad request has successfully loaded. this.bannerView.OnAdLoaded += this.HandleOnAdLoaded; // Called when an ad request failed to load. this.bannerView.OnAdFailedToLoad += this.HandleOnAdFailedToLoad; // Called when an ad is clicked. this.bannerView.OnAdOpening += this.HandleOnAdOpened; // Called when the user returned from the app after an ad click. this.bannerView.OnAdClosed += this.HandleOnAdClosed; // Called when the ad click caused the user to leave the application. this.bannerView.OnAdLeavingApplication += this.HandleOnAdLeavingApplication; // Create an empty ad request. AdRequest request = new AdRequest.Builder().Build(); // Load the banner with the request. this.bannerView.LoadAd(request); } public void HandleOnAdLoaded(object sender, EventArgs args) { MonoBehaviour.print("HandleAdLoaded event received"); } public void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args) { MonoBehaviour.print("HandleFailedToReceiveAd event received with message: " + args.Message); } public void HandleOnAdOpened(object sender, EventArgs args) { MonoBehaviour.print("HandleAdOpened event received"); } public void HandleOnAdClosed(object sender, EventArgs args) { MonoBehaviour.print("HandleAdClosed event received"); } public void HandleOnAdLeavingApplication(object sender, EventArgs args) { MonoBehaviour.print("HandleAdLeavingApplication event received"); } }
OnAdFailedToLoad
이벤트는 특수 이벤트 인수를 제공합니다. 이 인수는
오류를 설명하는 Message
가 포함된 HandleAdFailedToLoadEventArgs
의 인스턴스를
전달합니다.
public void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
MonoBehaviour.print("Banner failed to load: " + args.Message);
// Handle the ad failed to load event.
};
광고 이벤트 | 설명 |
---|---|
OnAdLoaded |
OnAdLoaded 이벤트는 광고 로드가 완료되면
실행됩니다. |
OnAdFailedToLoad |
OnAdFailedToLoad 이벤트는 광고 로드에 실패할 때
호출됩니다. Message 매개변수는 발생한 실패의 유형을
설명합니다. |
OnAdOpening |
이 메서드는 사용자가 광고를 탭하면 호출됩니다. 분석 패키지를 사용해 클릭률을 추적하는 경우 여기에서 기록하면 편리합니다. |
OnAdClosed |
사용자가 광고의 도착 URL을 조회한 후 앱으로 돌아가면 이 메소드가 실행됩니다. 앱에서 이 메서드를 사용해 정지된 활동을 재개하거나 상호작용 준비에 필요한 다른 작업을 처리할 수 있습니다. |
OnAdLeavingApplication |
이 메서드는 현재 앱이 백그라운드에 있는 상태에서
사용자 클릭으로 다른 앱(예: Google Play 스토어)이 열릴 때 onAdOpened 후에
호출됩니다. |
배너 크기
아래의 표에는 표준 배너 크기가 나와 있습니다.
크기(폭x높이) | 설명 | 사용 가능 여부 | AdSize 상수 |
---|---|---|---|
320x50 | 표준 배너 | 휴대전화 및 태블릿 | BANNER |
320x100 | 대형 배너 | 휴대전화 및 태블릿 | LARGE_BANNER |
300x250 | IAB 중간 직사각형 | 휴대전화 및 태블릿 | MEDIUM_RECTANGLE |
468x60 | IAB 전체 크기 배너 | 태블릿 | FULL_BANNER |
728x90 | IAB 리더보드 | 태블릿 | LEADERBOARD |
제공된 폭x적응형 높이 | 적응형 배너 | 휴대전화 및 태블릿 | 해당 사항 없음 |
화면 폭x32|50|90 | 스마트 배너 | 휴대전화 및 태블릿 | SMART_BANNER |
스마트 배너 대신 사용할 수 있는 적응형 배너에 대해 자세히 알아보세요. |
배너 광고 정리
BannerView
지정이 끝나면 참조를 삭제하기 전에
Destroy()
메서드를 호출해야 합니다.
bannerView.Destroy();
이렇게 하면 플러그인이 객체를 더 이상 사용되지 않는 것으로 인식하므로 객체가 점유한 메모리를 복구할 수 있습니다. 이 메서드를 호출하지 않으면 메모리를 낭비하게 됩니다.