배너 광고

배너 광고는 화면 안의 한 지점을 차지하는 직사각형 이미지 또는 텍스트 광고입니다. 사용자가 앱과 상호작용하는 동안 화면에 머무르며 특정 시간이 지나면 자동으로 새로고침할 수 있습니다. 모바일 광고를 처음 시작하는 경우 배너 광고를 이용하는 것이 좋습니다. 우수사례

본 가이드에서는 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;

        // 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.LoadAdError.GetMessage());
    }

    public void HandleOnAdOpened(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdOpened event received");
    }

    public void HandleOnAdClosed(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdClosed 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을 조회한 후 앱으로 돌아가면 이 메서드가 호출됩니다. 앱에서 이 메서드를 사용해 정지된 활동을 재개하거나 상호작용 준비에 필요한 다른 작업을 처리할 수 있습니다.

배너 크기

아래 표에는 표준 배너 크기가 나와 있습니다.

크기(폭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();

이렇게 하면 플러그인이 객체를 더 이상 사용되지 않는 것으로 인식하므로 객체가 점유한 메모리를 복구할 수 있습니다. 이 메서드를 호출하지 않으면 메모리를 낭비하게 됩니다.