배너 및 MREC 광고 통합

개요

Vungle은 다음 세 가지 배너 크기와 표준 MREC 크기를 지원합니다.

배너 광고 정보

Vungle Banner는 현재 베타 단계에 있습니다. 성공적인 시작을 위해 액세스하려면 계정 관리자에게 직접 문의하시기 바랍니다.

Vungle Unity 플러그인은 Unity용 Vungle SDK v6.7.0.0부터 배너 및 MREC 광고를 지원합니다. 이 광고 형식은 전체 화면이 필요하지 않습니다. 그 대신 퍼블리셔가 앱 내에서 광고 컨테이너의 위치를 정합니다. 하지만 배너 컨테이너의 크기는 320x50, 300x50 또는 728x90(태블릿용)이어야 합니다. 화면 어디에서나 배너 광고를 설정할 수 있으며 사용자는 광고가 재생되는 동안 앱을 계속 사용할 수 있습니다. 다양한 배너 크기가 나열된 열거형은  VungleSDK.h 파일에서 확인할 수 있습니다(아래 목록에도 설명되어 있음).

지정된 시간에 표시할 수 있는 전체 화면이 아닌 광고의 수에는 제한이 없지만 플러그인은 여러 광고가 한 위치에 표시되고 있는지 여부는 확인하지 않습니다. 플러그인에서 제공하는 위치에 대해 하나의 광고를 호출하고 있는지 확인하고 둘 이상의 광고를 표시하는 경우 서로 겹치지 않도록 하십시오.

배너 광고의 플레이스먼트 유형은 Vungle 대시보드에서 '배너' 유형이어야 합니다. 대시보드에서 배너 플레이스먼트를 활성화하려면 Vungle 계정 관리자에게 문의해 주십시오.

MREC 광고 정보

SDK v.6.4.3부터 Vungle은 MREC 동영상 광고를 지원합니다. MREC는 '중간 직사각형' 광고의 약자입니다. 전면 광고와 다르게, MREC 광고는 전체 화면 뷰를 필요로 하지 않습니다. 배너 광고와 유사하게 MREC 동영상 광고는 앱 레이아웃 내 어디에나 위치할 수 있는 직사각형 광고로, 일반적으로 화면 상단 또는 하단에 표시되므로 광고가 재생되는 동안 사용자가 앱과 계속 상호 작용할 수 있습니다. MREC 광고를 렌더링하기 위한 컨테이너 크기는 산업 표준인 300x250입니다.

1단계. 기본 플러그인 통합 완료

Unity 앱에 배너 및 MREC 광고를 통합하려면 먼저 기본 플러그인 통합 문서의 지침을 따릅니다. 이 문서에는 추가 정보가 포함되어 있으며 기본 통합을 완료했다고 가정하고 설명을 진행합니다.

2단계. 이벤트 핸들러 구현(선택 사항)

광고 프레젠테이션 관련 5개의 Vungle SDK 이벤트 모두에 대해 이벤트 핸들러를 설정할 수 있습니다.

• 다음 이벤트는 SDK가 동영상 광고를 재생하기 시작하면 발생합니다. 게임 플레이, 음향 효과, 애니메이션 등을 일시 중지하기에 좋은 위치입니다.
  

  public static event Action onAdStartedEvent;

• 다음 이벤트는 SDK가 동영상 광고를 종료하면 발생합니다. 사용자에게 보상을 제공하고 게임 플레이, 음향 효과, 애니메이션 등을 다시 재생하기에 좋은 위치입니다.
  

  public static event Action<string, AdFinishedEventArgs> onAdFinishedEvent;

  AdFinishedEventArgs 클래스는 광고 재생 결과의 확인을 위한 다음 속성으로 구성되어 있습니다.
  

  public class AdFinishedEventArgs : EventArgs
  {
    //Represents a BOOL whether or not the user clicked the download button.
    public bool WasCallToActionClicked{ get; set;}
  
    //Represents a bool whether or not the video can be considered a completed view.
    public bool IsCompletedView{ get; set;}
  }

• SDK가 광고 가용성 상태를 변경하면 다음 이벤트가 발생합니다. isAdPlayable 부울은 특정 placementID의 새로운 재생 가능성을 나타냅니다.
  

  public static event Action<string, bool> adPlayableEvent;

• SDK가 초기화되면 다음 이벤트가 발생합니다.
  

  public static event Action onInitializeEvent;

샘플 코드:

void initializeEventHandlers()
{
    Vungle.onAdStartedEvent += (placementID) => {
        DebugLog ("Ad " + placementID + " is starting!  Pause your game  animation or sound here.");
    };

    Vungle.onAdFinishedEvent += (placementID, args) => {
        DebugLog ("Ad finished - placementID " + placementID + ", was call to action clicked:" + args.WasCallToActionClicked +  ", is completed view:"
                  + args.IsCompletedView);
    };

    Vungle.adPlayableEvent += (placementID, adPlayable) => {
        DebugLog ("Ad's playable state has been changed! placementID " + placementID + ". Now: " + adPlayable);
    };

    Vungle.onInitializeEvent += () => {
        adInited = true;
        DebugLog ("SDK initialized");
    };
}

3단계. 광고 로드, 재생 및 닫기

광고 로드

전체 화면이 아닌 광고 로드는 전체 화면 광고와 다르게 작동하며 로드에 사용하는 특정 loadBanner API가 있습니다. 로드하려는 전체 화면이 아닌 광고의 크기와 위치를 지정해야 합니다. 그러면 SDK가 대시보드에서 구성한 시간 간격으로 이를 자동 새로 고침합니다. 배너 또는 MREC 광고에 대해 특별히 생성된 플레이스먼트를 사용해야 합니다.

loadBanner 메서드 호출을 통한 전체 화면이 아닌 광고 로드:

Vungle.loadBanner("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner, Vungle.VungleBannerPosition.BottomCenter);

광고 표시

전체 화면이 아닌 광고는 showBanner를 호출할 때 loadBanner 호출 시 지정한 크기의 위치에 표시됩니다.

Vungle.showBanner("PLACEMENT_ID");

광고를 재생하기 전에 광고 가용성을 확인하는 것이 좋으며 isAdvertAvailable을 전체 화면 광고처럼 사용할 수 있습니다. 그러나 전체 화면이 아닌 광고의 경우 VungleBannerSize 및 표시하려는 광고의 플레이스먼트 ID를 제공해야 합니다.

Vungle.isAdvertAvailable("PLACEMENT_ID", Vungle.VungleBannerSize.VungleAdSizeBanner);

광고 닫기

전체 화면이 아닌 광고를 해제하려고 할 때 closeBanner를 호출할 수 있습니다.

Vungle.closeBanner("PLACEMENT_ID");