Vungle(SDK v.1.0 - v.4.1) - Marmalade 시작하기

이 가이드를 활용해서 Vungle Marmalade 플러그인을 기본 샘플 애플리케이션에 빠르게 통합할 수 있습니다. 여기에 언급된 소스 코드는 public GitHub 저장소에서 사용할 수 있습니다.

목차

  1. 시작하기 전에
  2. Vungle Marmalade 플러그인 설치
  3. 코드 추가!

시작하기 전에…

  1. Vungle Marmalade 플러그인을 설치하려면 Marmalade 8.0.0 이상이 필요합니다.
  2. Windows N and KN 에디션에서의 Vungle 광고: Windows 스페셜 N 또는 KN 에디션 사용자의 경우, Vungle 광고를 작동시키려면 "Windows 10 N 및 KN 에디션 미디어 기능 팩"을 반드시 설치해야 합니다.
  3. 통합하려면 Vungle 계정이 필요하므로, 계정이 없는 경우 Vungle 계정을 만듭니다.
  4. 아직 Vungle 계정을 만들지 않은 경우에는 대시보드로 이동하여 앱을 계정에 추가합니다. 이렇게 해야 SDK로 앱에 추가할 앱 ID를 받으실 수 있습니다. 앱 페이지에서 찾을 수 있습니다.
  5. Vungle Marmalade 플러그인은 't included in the sample code linked above, so you'll want to make sure you'Vungle 대시보드에서 다운로드하시기 바랍니다. 다운로드가 완료된 후에는...

Vungle Marmalade 플러그인 설치

Vungle Marmalade 플러그인 링크를 프로젝트의 MKB 파일에 추가합니다. 텍스트 편집기에서 프로젝트의 MKB 파일을 열고 파일 끝에 아래 줄을 추가하시면 됩니다.

subproject <path_to_the_Vungle_Marmalade_Plugin_directory>/VungleSDK

예:

subproject ../publisher-marmalade-plugin/VungleSDK

코드 추가!

이 설명서에서는 Vungle 관련 코드를 모두 초기화합니다. 최대한 빨리 Vungle Marmalade 플러그인을 초기화하여 'playAd'이 호출될 때 사용자에게 광고를 표시할 수 있도록 Vungle SDK 구성을 제시간에 완료하시기 바랍니다.

초기화

초기화는 단 한 줄입니다. 한 번만 호출하면 되며, Vungle Marmalade 플러그인이 사용자에게 광고를 표시할 수 있게 준비하는 데 사용됩니다. SDK에서 광고를 재생하기 위해 초기화하고 캐시하는 데 30~45초가 소요되므로 애플리케이션에서 최대한 빨리 Vungle SDK를 초기화하십시오.

#include "VungleSDK.h"
//...
int main()
{
    //앱 ID는 앱 페이지의 Vungle 대시보드에서 찾을 수 있습니다
    VungleInit("Test_Android", "Test_iOS", "Test_Windows");
}

광고 재생

광고 재생은 별도의 한 줄로 되어 있습니다.

//짧고 간단합니다!
VunglePlayAd();

VunglePlayAdWithOptions 메서드는 옵션을 수락하여 광고 재생 경험을 사용자 지정할 수도 있습니다.

// 더 많은 옵션으로 광고를 재생합니다. VungleSDKPlayOption 구조를 사용하여 옵션을 설정합니다.
VungleSDKPlayOption* opts = new VungleSDKPlayOption();
VunglePlayAdWithOptions(opts); 

옵션 구조에는 다음과 같은 필드가 있습니다.

설명
인센티브화 사용자가 광고를 완료할 때마다 통지를 받을 수 있습니다. 일반적인 사용 사례는 일종의 가치 교환을 제공할 때입니다('이 비디오를 시청하시면 100개의 보석을 드립니다!'). 광고를 인센티브화하면 당사는 귀사가 사용자에게 보상할 수 있도록 귀사 서버에 즉시 메시지와 사용자 ID(귀사 제공)를 전송합니다. '예'를 선택하면 광고가 인센티브화됩니다. 인센티브화된 광고의 설정을 위한 설명을 참조하십시오.
orientation

광고의 방향을 설정합니다.

  • 0 - 자동 회전(Windows, iOS, android)
  • 1 - 가로(Windows, iOS), 비디오 일치(android)
  • 2 - 세로(Windows, iOS)
userTag 키 사용자는 S2S 호출에서 사용자로 전달된 인물입니다(존재하는 경우).
placement 각 광고의 재생 위치를 자세히 기술한 메타데이터.  애플리케이션 성능에 대한 보고 데이터를 검색할 때 다양한 광고 경험을 필터링하는 데 사용됩니다.
alertTitle 사용자가 인센티브화된 광고 경험을 조기에 닫을 때 표시되는 경고 대화 상자의 제목으로 사용되는 문자열입니다.
alertText 사용자가 인센티브화된 광고 경험을 조기에 닫을 때 표시되는 경고 대화 상자의 본문 텍스트로 사용되는 문자열입니다.
alertCloseText 사용자가 인센티브화된 광고 경험을 조기에 닫을 때 표시되는 경고 대화 상자의 닫기 버튼 텍스트로 사용되는 문자열 제목입니다.
alertContinueText 사용자가 인센티브화된 광고 경험을 조기에 닫을 때 표시되는 경고 대화 상자의 닫기 버튼 텍스트로 사용되는 문자열 제목입니다.
key1..8 8개의 키가 빌드되어 있습니다.
 

이벤트 핸들링

Vungle Marmalade 플러그인을 사용하면 앱에서 광고 표시 주변의 이벤트 5개를 구독할 수 있습니다.

  • VUNGLESDK_CALLBACK_ADPLAYABLECHANGED - Vungle 광고를 표시할 준비가 되었을 때 실행
  • VUNGLESDK_CALLBACK_ADSTART - Vungle 광고가 시작될 때 실행
  • VUNGLESDK_CALLBACK_ADEND - 사용자가 광고/게임에서 나가고 컨트롤이 애플리케이션으로 반환될 때 실행
  • VUNGLESDK_CALLBACK_VIDEOVIEW - 광고가 완료될 때마다 실행
  • VUNGLESDK_CALLBACK_LOG - SDK가 로그 이벤트를 보낼 때 실행

콜백 함수에는 두 가지의 매개 변수 유형 void*가 있습니다. 첫 번째 매개 변수는 추가 이벤트 정보로 연결됩니다.

콜백 유형 설명
ADPLAYABLECHANGED bool 값이 true이면 광고를 재생할 수 있습니다
ADSTART  
ADEND bool 사용자가 다운로드 버튼을 탭하여 스토어로 이동하면 true
VIDEOVIEW VungleSDKAdViewInfo*

struct VungleSDKAdViewInfo
{
bool IsCompletedView; // 비디오를 최소 80% 시청한 경우
int VideoDuration; true // Vungle 광고 총 재생 시간(밀리 초)
int WatchedDuration; // Vungle 광고를 시청한 시간(밀리 초)
};.

LOG const char* 로그 메시지

이벤트 구독은 간단합니다. 이벤트 리스너 추가 과정은 다음과 같습니다.

int32 OnAdPlayableChanged(void* systemData, void* userData) {
    bool adPlayble = (bool)systemData;
    if (adPlayble){
        //광고 게재 준비 완료!
    }else{
        // 현재 이용 가능한 광고가 없습니다.
    }
    return 0;
}
 
int main()
{
    VungleSDKRegister(VUNGLESDK_CALLBACK_ADPLAYABLECHANGED, (s3eCallback)OnAdPlayableChanged, (void*)NULL);
}

참고: 앱이 테스트 모드에 있는 동안에는 광고 중인 앱을 다운로드할 수 없습니다. 또한, 대시보드가 광고 노출 수를 보고하지 않습니다. 이는 사용자가 올바르게 SDK를 통합했는지 확인하는 데에만 테스트 광고가 사용되기 때문입니다. 이 기능은 해당 앱이 활성 모드에서 작동할 준비가 되었을 때 비로소 제공됩니다.

이렇게만 하면 됩니다! Vungle Marmalade 플러그인에 대한 자세한 내용은 다른 플러그인 문서를 확인하거나, Marmalade 샘플 앱의 소스 코드를 살펴보십시오.

또 다른 질문이 있으십니까? 문의 등록

댓글