고급 설정 - Vungle iOS SDK

목차

  1. Vungle SDK 인스턴스
  2. 사용자 지정형 광고 경험
  3. 추가 VungleSDK 프로토콜

시작하기 전에…

본 조항은 Vungle iOS SDK의 고급 설정에 대해 설명합니다. 아직 iOS SDK에 익숙하지 않은 경우 iOS용 시작 가이드를 확인하시기 바랍니다.

VungleSDK 인스턴스

인스턴스 속성

VungleSDK singleton 인스턴스에서는 최종 사용자의 광고 경험을 사용자 지정하고 중요한 이벤트 정보를 수신할 수 있는 몇 가지 속성을 사용할 수 있습니다.  사용할 수 있는 속성의 목록은 다음과 같습니다.

음소거(BOOL): 게시된 광고를 음소거된 상태로 시작할 것인지를 제어함
델리게이트(id<VungleSDKDelegate>): 앱이 특정 SDK 이벤트에 대한 비동기적 콜백을 수신할 수 있도록 해 주는 VungleSDKDelegate 프로토콜에 따라 할당할 수 있는 속성
assetLoader(id<VungleAssetLoader>): 앱이 주요 VungleSDK playAd ViewController에 사용되는 필수 자산의 작동을 중단시킬 수 있도록 해 주는 VungleAssetLoader 프로토콜에 따라 할당할 수 있는 속성

 

인스턴스 메서드 및 도우미 상수

(BOOL)isAdPlayable; 표시할 준비가 된 캐시된 광고가 있고 현재의 사용자가 일일 조회수 또는 조회율(rate)에 의해 제한된 경우 '예'를 반환합니다. 이로써 사용 가능한 스트리밍 광고가 있는지 확인하는 것은 아닙니다. 퍼블리셔가 스트리밍 대상으로 선택된 경우에도 그렇습니다.
(NSDictionary*)debugInfo; VungleSDK singleton에 대한 다양한 디버그 정보와 함께 NSDictionary를 반환합니다.
(void)setLoggingEnabled:(BOOL)enable; VungleSDK singleton으로부터 기본 로깅 기능을 활성화 또는 비활성화합니다.  로그된 이벤트 및 정보가 콘솔에 인쇄됩니다.  각 로깅 이벤트를 처리하려면, 아래의 attachLogger 방법을 참조하십시오.
(void)log:(NSString*)메시지, ... NS_FORMAT_FUNCTION(1,2); 구체적인 메시지를 콘솔 및 첨부된 모든 VungleSDKLogger 인스턴스에 로그합니다.
(void)attachLogger:(id<VungleSDKLogger>)logger 앱이 VungleSDKLogger 프로토콜에 따라 클래스를 VungleSDKsingleton 인스턴스에 첨부하도록 허용합니다. 첨부된 로거가 SDK가 처리하는 모든 로그 이벤트를 수신합니다.  메모리 누수를 피하려면, 더 이상 필요 없게 된 로거를 적절히 분리하는 것이 중요합니다.  VungleSDK singleton 인스턴스에서 첨부된 로거가 적절히 제거될 때까지 유지합니다.
(void)attachLogger:(id<VungleSDKLogger>)logger 로거 오브젝트를 분리합니다.
NSString* VungleSDKVersion Vungle iOS SDK의 현재 버전을 기술하는 스트링 상수  주요 및 마이너 버전을 포함합니다.

사용자 지정형 광고 경험

VungleSDK singleton에 대한 playAd 방법을 통해 NSDictionary 파라미터를 수락하여 앱이 각 광고 경험을 사용자 지정하도록 할 수 있습니다.  NSDictionary 파라미터에 포함된 모든 유효한 키/값의 쌍이 기술된 설정에 대한 기본값을 재정의합니다. 모든 키는 딕셔너리에 추가할 수 있도록 선택적입니다. NSDictionary 파라미터에 포함된 설정은 단일한 playAd 호출에만 영향을 미칩니다. 옵션 딕셔너리의 예를 샘플 앱의 111행 또는 131행에서 찾을 수 있습니다.

기본 값/유형 설명
VunglePlayAdOptionKeyIncentivized NO
bool 값을 대표하는 NSNumber.
어떠한 광고 재생을 인센티브화로 표시하면, 로컬 SDK 및 Vungle 광고 서버 양쪽으로부터 기본 playAd 호출과는 약간 다른 행동이 나타납니다. 이 기능은 보상식 위치결정 광고 및 통상적으로 발생하는 광고 사이의 분리된 행동 및 기능을 지원하는 데 사용할 수 있습니다.  인센티브화된 광고와 인센티브화되지 않은 광고 간의 차이를 자세히 살펴보려면 여기의 문서를 참조하십시오.
VunglePlayAdOptionKeyOrientations UIInterfaceOrientationMaskAll
방향에 따라 bitmask를 대표하는 NSNumber(기본 설정은 자동전환)
광고의 방향을 설정합니다. 앱이 세로 방향인 경우에도 광고를 자동으로 회전하도록 설정할 것을 권장합니다. 이런 방식으로 사용자가 최대 크기의 비디오를 보게끔 선택하여 더 나은 사용자 경험을 누릴 수 있습니다. 방향을 (프로젝트 레벨에서보다는) 보기 제어 수준에서 설정하여 더 나은 사용자 경험을 가능케 할 수 있습니다.
VunglePlayAdOptionKeyUser 광고를 인센티브화하면 전달되는 사용자 식별자가 있는
NSString
인센티브화된 서버 간 호출에서 '사용자'로서 전달된 값
VunglePlayAdOptionKeyIncentivizedAlertTitleText
NSString
사용자가 인센티브화된 광고 경험을 조기에 닫을 때 표시되는 경고 대화 상자의 제목으로 사용되는 문자열입니다.
VunglePlayAdOptionKeyIncentivizedAlertBodyText 정말 이 광고를 건너뛰시겠습니까? 이 광고를 건너뛰시면 손해일 수 있습니다
NSString
사용자가 인센티브화된 광고 경험을 조기에 닫을 때 표시되는 경고 대화 상자의 본문 텍스트로 사용되는 문자열입니다.
VunglePlayAdOptionKeyIncentivizedAlertCloseButtonText 닫기
NSString
사용자가 인센티브화된 광고 경험을 조기에 닫을 때 표시되는 경고 대화 상자의 닫기 버튼 텍스트로 사용되는 문자열 제목입니다.
VunglePlayAdOptionKeyIncentivizedAlertContinueButtonText 계속
NSString
사용자가 인센티브화된 광고 경험을 조기에 닫을 때 표시되는 경고 대화 상자의 닫기 버튼 텍스트로 사용되는 문자열 제목입니다.
VunglePlayAdOptionKeyExtraInfoDictionary 여분의 키를 포함한
NSDictionary(아래에 정의됨).
연령대, 성별 등의 지표를 추적하는 데 사용할 수 있는 기본 메타데이터 딕셔너리
VunglePlayAdOptionKeyExtra1..8 추적 중인 사용자 지표를 대표하는
NSString.
곧 제공 - 이 기능은 아직 완료되지 않았으나 완료되면 여기에 있는 8개의 키를 사용하여 광고위치, 사용자 데이터 등에 관한 추가적인 정보를 추적하고 보고할 수 있습니다.

프로토콜

VungleSDKDelegate 프로토콜


@프로토콜 VungleSDKDelegate 
- (void)vungleSDKAdPlayableChanged:(BOOL)isAdPlayable;
- (void)vungleSDKwillShowAd;
- (void)vungleSDKwillCloseAdWithViewInfo:(NSDictionary*)viewInfo willPresentProductSheet:(BOOL)willPresentProductSheet;
- (void)vungleSDKwillCloseProductSheet:(id)productSheet;
@end    

VungleSDKDelegate 방법

광고 경험에 관해 유용한 이벤트를 경고해 주는 VungleSDK Delegate를 실행할 수 있습니다.

방법 설명
(void)vungleSDKAdPlayableChanged:(BOOL)isAdPlayable VungleSDK가 광고 가용성 상태를 변경했을 때 호출됨.  isAdPlayable boolean은 Vungle SDK의 새로운 재생가능성을 보여줍니다.
(void)vungleSDKwillShowAd VungleSDK가 비디오 광고를 재생하려 할 때 호출됨.  이 방법의 전달은 게임, 음향 효과, 애니메이션 등을 중지하는 훌륭한 방법입니다.
(void)vungleSDKwillCloseAdWithViewInfo:
(NSDictionary *)viewInfo  willPresentProductSheet:(BOOL)willPresentProductSheet

사용자가 광고 경험을 떠날 수 있는 다음의 3가지 방식이 있습니다.

  • 비디오 광고를 완료하기(표시되는 광고가 자동으로 닫힘)
  • 진행 중인 또는 완료된 광고에서 닫기 버튼을 누르기
  • (StoreKit 프레임워크를 사용하여) iOS에서 제공하는 앱 내 앱스토어를 여는 다운로드 버튼을 클릭하기

이 모든 경우에서 주요 Vungle ViewController가 기각됨으로써 콜백이 실행됩니다. viewInfo NSDictionary는 다음의 정보를 포함합니다.

  • completedView: BOOL로서의 NSNumber, 비디오를 80% 이상 시청했을 경우 예
  • playTime: 비디오를 시청한 시간의 NSNumber
  • didDownload: BOOL로서의 NSNumber, 사용자가 다운로드 버튼을 누른 경우 '예'
  • videoLength: (Vungle iOS SDK 4.0.9에서 사용되지 않음)

참고로 willPresentProductSheet 파라미터는 항상 '아니오'입니다. 사용자가 다운로드 버튼을 눌렀는지 확인하기 위해 이 파라미터에 의존하지 마십시오.

(void)vungleSDKwillCloseProductSheet:(id)productSheet (제거됨) (Vungle iOS SDK 4.0.9.에서 제거됨) 이 최종 호출은 사용자가 광고된 앱을 다운로드하기로 결정하는 경우 실행되며, 지금 앱 내 앱스토어에서 닫히고 있습니다. 앱으로 돌아올 때 이 이벤트는 애니메이션, 음향 효과 등을 재개하는 데 사용할 수 있습니다.

 

VungleSDKDelegate 등록

VungleSDK singleton으로부터 이벤트를 수신하려면, VungleSDKDelegate 프로토콜을 따르는 클래스를 다음의 방식으로 등록해야 합니다.

[[VungleSDK sharedSDK] setDelegate:yourDelegateInstance];

메모리 누수를 방지하려면, 등록된 델리게이트가 더 이상 필요 없게 되었을 때 반드시 제거해야 합니다. VungleSDK singleton이 등록된 델리게이트가 분명히 제거될 때까지 유지합니다.

델리게이트를 삭제하려면, 다음을 사용하십시오.

[[VungleSDK sharedSDK] setDelegate:nil];

 

VungleSDKLogger 프로토콜


@프로토콜 VungleSDKLogger 
- (void)vungleSDKLog:(NSString*)message;
@end

VungleSDK singleton이 로깅 이벤트를 VungleSDKLogger 프로토콜에 따라 첨부된 클래스에 전송합니다.  로그 이벤트에는 콘솔로도 인쇄되는 NSString 값이 포함됩니다(로깅이 켜져 있는 경우).  로거를 첨부하려면, 다음을 사용하십시오.

 [sdk attachLogger:yourLoggerInstance];

위에서 언급한 것처럼 VungleSDK로부터 첨부된 로거를 제거하는 것이 중요합니다. 다음의 접근 방식을 사용하여 로거를 분리할 수 있습니다.

[sdk detachLogger:yourLoggerInstance];

 

assetLoader 프로토콜


@protocol VungleAssetLoader
/**
 * 구체화된 경로 또는 닐에 대한 (가공되지 않은) 이미지 데이터를 포함하는 유효한 NSData를 반환해야 합니다. */
- (NSData*)vungleLoadAsset:(NSString*)경로;

/**
 * 구체화된 경로 또는 닐에 대한 유효한 UIImage를 반환해야 합니다.
 */
- (UIImage*)vungleLoadImage:(NSString*)경로;
@end
또 다른 질문이 있으십니까? 문의 등록

댓글