이 가이드는 Corona 플러그인의 빠른 통합에 대해 간추려 설명합니다. Corona 샘플 앱을 참조하여 그 작동 방식을 알아보십시오.
목차
- 빌드 설정 업데이트
- Vungle 초기화
- 광고 재생
- 고급 설정
시작하기 전 몇 가지 주의사항…
- 광고가 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"
},
},
}
댓글