비디오 믹스 광고

다양한 형태의 비디오 타입 + 전면 광고를 혼합하여 제공하는 광고 타입입니다. v1.1.0 플러그인부터 제공됩니다.

1. 비디오 믹스 광고 인스턴스 설정

아래 코드를 추가하여 비디오 믹스 광고 인스턴스를 생성합니다.

C#
using AdPopcornSSP.VideoMix;

public class AdPopcornSSPSampleScene : MonoBehaviour{
private AdPopcornSSPVideoMix videoMixAd = null;
	
void Start(){
	videoMixAd = new AdPopcornSSPVideoMix();
}

2. 비디오 믹스 광고 Placement ID 설정

아래 코드를 추가하여 비디오 믹스 광고 PLACEMENT ID 를 설정합니다. 비디오 믹스 광고 PLACEMENT ID 는 애드팝콘 SSP 콘솔에서 생성이 가능합니다.

C#
videoMixAd.setPlacementId(“PlacementId”);

3. 비디오 믹스 광고 요청

비디오 믹스 광고 노출을 원하는 시점에 loadAd()API를 호출하여 서버에 광고를 요청 합니다.

C#
videoMixAd.loadAd();

4. 비디오 믹스 광고 노출

광고 노출 시점에 showAd() API를 추가하여 광고를 재생 합니다.

C#
videoMixAd.showAd();

5. 리워드 비디오 광고 델리게이트 설정

비디오믹스 광고 요청 및 노출에 대한/성공, 실패, 완료 대한 델리게이트를 제공합니다. 제공되는 델리게이트와 구현 예시는 다음과 같습니다.

C#
videoMixAd.setVideoMixEventCallbackListener();
delegate
설명

OnVideoMixAdLoaded()

광고 로딩 성공

OnVideoMixAdLoadFailed(ErrorResult)

광고 로딩 실패. 에러코드 값

OnVideoMixAdOpened()

광고 노출 성공

OnVideoMixAdOpenFalied()

광고 노출 실패

OnVideoMixAdClosed(CampaignType campaignType)

광고 닫힘

ㄴ campaignType

2: 전면, 4: 리워드 비디오, 6 : 전면 비디오

OnVideoMixPlayCompleted(RewardInfo rewardInfo)

비디오 믹스 광고 중, 리워드 비디오 광고 재생 완료

OnVideoMixAdClicked()

비디오 광고 클릭(일부 미디에이션 광고는 지원 안함)

C#
//델리게이트 등록
void Start(){	
	if(videoMixAd!= null)	
	{
	    videoMixAd.setVideoMixEventCallbackListener();	
	    videoMixAd.OnVideoMixAdLoaded += OnVideoMixAdLoaded;
            videoMixAd.OnVideoMixAdLoadFailed += OnVideoMixAdLoadFailed;
            videoMixAd.OnVideoMixAdOpened += OnVideoMixAdOpened;
            videoMixAd.OnVideoMixAdOpenFailed += OnVideoMixAdOpenFailed;
            videoMixAd.OnVideoMixAdClosed += OnVideoMixAdClosed;
            videoMixAd.OnVideoMixPlayCompleted += OnVideoMixPlayCompleted;
            videoMixAd.OnVideoMixAdClicked += OnVideoMixAdClicked;
	}
}

//델리게이트 구현
public void OnVideoMixAdLoaded(object sender, System.EventArgs args)
{
}

public void OnVideoMixAdLoadFailed(object sender, ErrorResult errorResult)
{
   Debug.Log("errorCode : " + errorResult.errorCode + ", erroMessage : " + errorResult.errorMessage);
}

public void OnVideoMixAdOpened(object sender, System.EventArgs args)
{
   
}

public void OnVideoMixAdOpenFailed(object sender, System.EventArgs args)
{
   
}

public void OnVideoMixAdClosed(object sender, CampaignType campaignType)
{
   Debug.Log("OnVideoMixAdClosed event received : " + campaignType);
}

public void OnVideoMixPlayCompleted(object sender, RewardInfo rewardInfo)
{
   Debug.Log("adNetworkNo : " + rewardInfo.adNetworkNo + ", completed : " + rewardInfo.completed);
}

public void OnVideoMixAdClicked(object sender, System.EventArgs args)
{
}

// 델리게이트 해제
void OnDestroy(){	
	if(videoMixAd!= null)	
	{	
	    videoMixAd.OnVideoMixAdLoaded -= OnVideoMixAdLoaded;
            videoMixAd.OnVideoMixAdLoadFailed -= OnVideoMixAdLoadFailed;
            videoMixAd.OnVideoMixAdOpened -= OnVideoMixAdOpened;
            videoMixAd.OnVideoMixAdOpenFailed -= OnVideoMixAdOpenFailed;
            videoMixAd.OnVideoMixAdClosed -= OnVideoMixAdClosed;
            videoMixAd.OnVideoMixPlayCompleted -= OnVideoMixPlayCompleted;
            videoMixAd.OnVideoMixAdClicked -= OnVideoMixAdClicked;
	}
}

6. 유저 식별값 입력

유저 식별값은 비디오 믹스의 리워드 비디오 광고 타입 시청 완료 시 유저를 식별하기 위해 사용되는 값입니다.

해당 유저 정보를 넘겨주어야 CS 접수 시, 유저를 특정 가능합니다. 단, CS 기능을 오픈하지 않을 경우에는 연동 진행하지 않아도 됩니다.

위 주의사항에 유의하여 유저 식별값을 입력합니다.

AdPopcornSSPPlugin.setUserId("userId")

Last updated

Was this helpful?