Vungle - Corona 입문

Avatar
Akifumi Shinagawa
팔로우

이 가이드는 Corona 플러그인의 빠른 통합에 대해 간추려 설명합니다. Corona 샘플 앱을 참조하여 그 작동 방식을 알아보십시오.

목차

  1. 빌드 설정 업데이트
  2. Vungle 초기화
  3. 광고 재생

  4. 고급 설정

시작하기 전 몇 가지 주의사항…

  • 광고가 Corona 시뮬레이터에서 작동하지 않을 것입니다. 광고를 테스트하기 위해 장치로 빌드해야 할 수 있습니다.

  • Vungle Corona 플러그인은 다음만을 지원합니다.

    • iOS 7+ and 32bit 및 64bit 앱 모두를 지원합니다.
    • Android 3.0(Honeycomb - API 버전 11) 이상

  • 통합하려면 Vungle 계정이 필요하므로 계정이 없다면  Vungle 계정 만들기를 하십시오.

  • 아직 Vungle 계정을 만들지 않은 경우에는 당사의 대시보드로 이동하여 해당 앱을 본인의 계정에 추가합니다. 이렇게 해야 하는 이유는 SDK로 앱에 추가할 예정인 앱 ID를 획득할 수 있기 때문입니다. 앱 페이지에 빨간색으로 표시되어 있습니다.
 

이제 시작하겠습니다.  시작하는 데 다음의 4단계가 필요합니다.

1. build.settings 업데이트

이 플러그인을 사용하려면, 엔트리를 build.settings의 플러그인 표에 추가합니다. 추가한 후에는 빌드 서버가 빌드 단계에 걸쳐 플러그인을 통합합니다. 어떠한 것도 다운로드할 필요가 없습니다. Vungle이 프로젝트에 자동으로 포함됩니다.

설정 = {
        플러그인 = {
                ["CoronaProvider.ads.vungle"] = {
                        publisherId = "com.vungle"
                },
        },
}

iOS

iOS인 경우, 다음에 따라 plist를 build.settings에 추가합니다.

iphone = { 
       plist= {

            NSAppTransportSecurity = 
              { 
            NSAllowsArbitraryLoads = true }, 
        } 
}

Android

Android인 경우, 이 플러그인을 사용하면 다음의 허용/기능이 자동으로 추가됩니다.

android = {
        usesPermissions = {
                "android.permission.INTERNET",
         },
},

2. Vungle 초기화

Vungle 광고는 Corona의 광고 라이브러리를 통해 접근할 수 있습니다. 광고를 가져올 필요가 있습니다. 그런 다음 Vungle을 최대한 신속하게 프로젝트의 코어 파일에서 초기화합니다.

main.lua:

-- Vungle 광고를 사용하여 어떠한 파일이든 가져 옴
local ads = require "ads"

-- 앱 ID로 치환할 필요가 있음
appID = "Test_iOS";

-- 광고가 init
ads.init( "vungle", appID );에 대한 캐싱을 개시

3. 광고를 재생합니다!

비디오를 재생할 준비가 되면 ads.show를 호출하기만 하면 됩니다. 광고 유형- "인터스티셜" 또는 "인센티브화"를 전달해야 합니다.

ads.show( "인터스티셜" );

또는

ads.show( "인센티브화" );

캐시된 광고의 사용가능성에 따라 불 true 또는 false를 반환합니다.

또한 ads.hide는 기타 광고 공급자와는 달리 가동 준비가 갖춰진 상태라는 점을 참고하십시오. Vungle 비디오 광고는 사용자가 닫은 경우에는 보이지 않습니다.

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

고급 설정

이러한 고급 설정은 샘플 앱에서도 다루어집니다.

1. 광고 재생 옵션

현재 재생해야 할 광고가 있는데, 이러한 선택적 파라미터를 ads.show로 넘겨 경험을 사용자 지정하려 합니다.

isAnimated(Bool)

이 파라미터는 iOS에만 적용됩니다. true(기본)인 경우, 비디오 광고가 슬라이드 효과와 함께 전환합니다. false인 경우, 즉각 표시됩니다.

isAutoRotation (Bool)

true(기본)인 경우, 비디오 광고가 장치가 놓인 방향으로 자동으로 회전합니다. false인 경우, 해당 광고에 설정된 방향을 적용합니다. Android에만 적용되는 사항입니다. iOS인 경우, 방향 키를 살펴봅니다.

방향(Bool) (api.type.Integer)

가능한 방향 값이 있는 Bitmak 기본은 UIInterfaceOrientationMaskAll입니다.

isBackButtonEnabled(Bool)

이 파라미터는 Android에만 적용됩니다. true인 경우, Android 뒤로 버튼이 비디오 광고의 재생을 멈추게 하고 포스트 롤을 표시합니다. false인 경우(기본), 재생하는 동안 뒤로 버튼을 사용할 수 없습니다. 참고로 뒤로 버튼은 포스트 롤에서 언제나 사용할 수 있습니다. 누르면 광고를 종료하여 애플리케이션으로 반환합니다.

isSoundEnabled(Bool)

true인 경우(기본), 비디오 광고를 재생하는 동안 장치의 소리 설정에 따라 사운드를 사용할 수 있습니다. false인 경우, 비디오 재생이 무음 상태로 시작됩니다. 참고로 재생하는 동안 사용자가 음향을 끄거나 음소거 상태를 해제할 수 있습니다.

사용자 이름(문자열)

이 파라미터는 "인센티브화" 광고 단위 유형에만 적용됩니다. 명시된 경우, 사용자에게 완료된 비디오 광고 보기를 보상하는 서버 간 호출에서 수신하기를 원하는 사용자 식별자를 표시합니다.

예:

local adShown = ads.show( "인터스티셜", { isAnimated=false, isBackButtonEnabled=true } )

 

2. 이벤트 리스너

선택적으로 이벤트 리스너를 ads.init로 전달할 수도 있습니다.

ads.init( providerName, appId [, adListener] )

이러한 이벤트를 통지할 것입니다.

adStart

  • name: adsRequest
  • provider: vungle
  • type: adStart
  • isError: 광고 재생을 시작한 경우; false 광고를 재생하지 못한 경우 true
  • 응답: isError가 true인 경우 광고를 재생할 수 없는 이유

adView

  • name: adsRequest
  • provider: vungle
  • type: adView
  • isError: false
  • totalAdSeconds: 초로 환산한 비디오의 총 길이
  • secondsWatched: 초 단위로 환산한 사용자가 가장 오래 보기한 길이
  • isCompletedView: true 사용자가 비디오의 80% 를 본 경우; false 아니면

adEnd

  • name: adsRequest
  • provider: vungle
  • type: adEnd
  • isError: false
  • wasCallToActionClicked: true 사용자가 call-to-action을 클릭하는 경우(대개 '다운로드'); false 아니면

cachedadavailable

  • name: adsRequest
  • provider: vungle
  • type: cachedAdAvailable
  • isError: false

예:

local function vungleAdListener( event )
  if ( event.type == "adStart" and event.isError ) then
    -- 광고가 캐싱을 종료하지 않은 상태이며 재생되지 않음
  end
  if ( event.type == "adStart" and not event.isError ) then
    -- Ad will play
  end
  if ( event.type == "cachedAdAvailable" ) then
    -- 광고가 캐싱을 종료하지 않은 상태이며 재생할 준비가 되어 있음
  end
  if ( event.type == "adView" ) then
    -- 광고를 완료한 상태
  end
  if ( event.type == "adEnd" ) then
    -- 광고 경험을 닫은 상태임
    -- 앱을 재개하기에 좋은 조건임
  end
end

 

3. 추가 기능

vungle.isAdAvailable()

Vungle이 최적화된 사용자 경험을 위해 다음 비디오를 다운로드하여 캐싱합니다. 이 기능이 캐시된 광고의 사용가능성에 따라 불 true 또는 false를 반환합니다.

vungle.getVersionString()

플러그인 및 관련된 SDK 버전 번호를 문자열로 반환합니다.

vungle.showCacheFiles()

Vungle 캐시에 있는 파일 목록을 로그에 기록합니다. 이 기능은 iOS에서만 사용 가능합니다.

iOS에만 해당: 애플리케이션 이동 보안

iOS 9이 ATS (애플리케이션 이동 보안) 조치를 도입했습니다. iOS 9에 설치된 앱을 업데이트하여 ATS 조치 주변에서 작동해야 합니다; iOS 9용으로 앱 준비하기의 지침을 참조하십시오.

Google 플레이 서비스

Android를 대상으로 하거나 Corona SDK 버전 2014.2264 이상을 사용하는 경우, Google 플레이 서비스를 플러그인 표에 추가할 필요 또한 있습니다.

설정 = {
        플러그인 = {
                ["plugin.google.play.services"] = {
                        publisherId = "com.coronalabs"
                },
        },
}

 

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

댓글