동영상

Targetpick Video 광고 적용을 위한 가이드 입니다.

1. 동영상 광고

• 영상 형태의 동영상 광고물이 노출됩니다.

• 동영상 광고의 종류로는 가로 동영상, 세로 동영상, 정사각 동영상이 있습니다.

아래와 같은 영상 형태로 광고 노출

2. 동영상 광고 연동

@IBOutlet var videoView:ADMZVideoView!

VideoView 광고 객체 설정(필수 세팅)

  let model = ADMZVideoModel(withPublisherID:102,
      withMediaID: 202,
      withSectionID: 804408,
      withVideoSize: .init(width: 320, height: 480),
      withKeywordParameter: "KeywordTargeting",
      withOtherParameter: "BannerAdditionalParameters",
      withMediaAgeLevel: .unknownType,
      withAppID: "appID",
      withAppName: "appName",
      withStoreURL: "StoreURL",
      withSMS: true,
      withTel: true,
      withCalendar: true,
      withStorePicture: true,
      withAutoPlay: true,
      withAutoReplay: true,
      withMuteOption: true,
      withClickFull: true,
      withClickButtonShow: true,
      withSkipButtonShow: true,
      withClickVideoArea: true,
      withCloseButtonShow: true,
      withSoundButtonShow: true,
      withInlineVideo: true)

Video 요청 Model 이용자 정보 입력 – (선택 세팅)

// 유저 정보 설정
model.setUserInfo(withGenderType: .Male,
                          withAge: 15,
                          withUserID: "mezzomedia",
                          withEmail: "[e-mail]",
                          withUserLocationAgree: false)

3. 동영상 광고 시작

동영상광고 시작

// 동영상 광고 시작.
videoView?.startVideo()

Handler 발생에 따른 이벤트 구현

videoView?.setFailHandler(value: { code in
    //Fail event 발생시 code 변수에 실패코드가 나타납니다.
})
videoView?.setSuccessHandler(value: { code in
    //Success event 발생시 code 변수에 해당코드가 나타납니다.
})
videoView?.setOtherHandler(value: { code in
    //비디오 선택, 로고 선택등의 이벤트가 발생시 code 변수에 이벤트코드가 나타납니다.
})

4. 코드 설명

코드	설명
let model = ADMZVideoModel(withPublisherID:102,      withMediaID: 202,      withSectionID: 804408,      withVideoSize: .init(width: 320, height: 480),      withKeywordParameter: “KeywordTargeting”,      withOtherParameter: “BannerAdditionalParameters”,      withMediaAgeLevel: .unknownType,      withAppID: “appID”,      withAppName: “appName”,      withStoreURL: “StoreURL”,      withSMS: true,      withTel: true,      withCalendar: true,      withStorePicture: true,      withAutoPlay: true,      withAutoReplay: true,      withMuteOption: true,      withClickFull: true,      withClickButtonShow: true,      withSkipButtonShow: true,      withClickVideoArea: true,      withCloseButtonShow: true,      withSoundButtonShow: true,      withInlineVideo: true)	요청할 정보를 가지고있는 모델을 생성합니다 - pubId: 광고 퍼블리셔 ID - mediaId: 미디어 ID - sectionId: 섹션 ID - videoSize: 영상 사이즈 - keywordParam: 키워드 파라미터 - otherParam: 다른 파라미터 - ageLvType: 미디어 연령 등급 - appid: 앱 ID - appName: 앱 이름 - storeURL: 스토어 URL - isSMS: 문자 사용 여부 - isTel: 전화번호 사용 여부 - isCalendar: 캘린더 - isStorePicture: 스토어 이미지 사용 여부 - isAutoPlay: 자동 재생 - isAutoReplay: 자동 반복 - isMuteOption: 음소거 옵션 - isClickFull: 전체 화면 - isClickButtonShow: 버튼 표시 - isSkipButtonshow: 스킵 버튼 표시 - isClickVideoArea: 영상 영역 클릭 - isVideoCloseButtonShow: 영상 닫기 버튼 표시 - isSoundButtonShow: 소리 버튼 표시 - isInlineVideo: 인라인 비디오 사용 여부
model.setUserInfo(withGenderType: .Male,      withAge: 15,      withUserID: “mezzomedia”,      withEmail: “[e-mail]”,      withUserLocationAgree: false)	사용자 정보를 입력합니다(선택사항) - Gender: 성별 - Age: 나이 - UserID: 사용자 아이디 - UserEmail: 사용자 이메일 - UserLocationAgree: 위치정보 사용동의여부
videoView?.startVideo()	광고요청을 시작합니다
videoView?.setFailHandler(value: { code in                }) videoView?.setSuccessHandler(value: { code in                }) videoView?.setOtherHandler(value: { code in                })	- 이벤트를 전달하는 코드입니다. FailHandler : 실패시 실패코드를 code 변수로 리턴합니다. SuccessHandler : 성공시 성공코드를 code 변수로 리턴합니다. OtherHandler : 성공 실패 외의 이벤트코드를 code 변수로 리턴합니다. (ex: 광고 선택, 로고 선택 등)

5. 광고 에러 코드 및 Callback 메세지

code	이름	설명
200	AdSuccess	성공
201	AdClick	광고 클릭
202	AdClose	광고 닫기
301	VideoAdStart	비디오 광고 시작
302	VideoAdSkip	비디오 광고 Skip
303	AdDidImpression	비디오 노출시작
304	VideoAdFirstQ	비디오 1/4 재생
305	VideoAdMidQ	비디오 1/2 재생
306	VideoAdThirdQ	비디오 3/4 재생
309	VideoAdComplete	비디오 광고 재생완료
404	AdNotError	광고 없음 (No Ads)
405	AdPassbackError	Sync 모드 필요 (패스백)
408	AdTimeoutError	Timeout
415	AdParsingError	Parsing Error
498	AdDuplicateError	Duplicate Request Error
499	AdError	Error
501	BrowserError	Browser Error
-2001	AdNotExistError	Webview 페이지 경로 Error
-3001	AdAppStoreUrlError	매체측 앱 스토어 URL
-3002	AdIDError	광고 솔루션에서 발급 한 사업자/미디어/섹션 코드 미존재
-3003	AdTargetAreaError	광고 영역 크기 에러
-3004	AdVideoOptError	비디오 옵션 에러
-3005	AdUserAgeLevelError	User Age Level 에러
-5002	AdReloadTimeError	광고 재호출(Reload) 에러
-6002	AdNetworkError	네트워크 에러
-8001	AdFileError	광고물 파일 형식 에러
-9001	AdCreativeError	광고물 요청 실패 (Timeout)
-9995	AdModelError	요청한 모델의 Cast Type과 View의 타입이 일치하지않는 경우