기본 요건
에 따라 필요한 과정을 완료합니다.
테스트 광고 게재위치
Placement Code(게재위치 코드)는 어드민의 인벤토리 > 게재위치 메뉴에서 게재위치를 등록 시 시스템을 통해 자동으로 생성됩니다.
테스트 게재위치 목록
placementCode
creativeSpecId
설명
SAMPLE_CUSTOM_EXPANDABLE_BANNER
SAMPLE_MULTIPLE_IMAGE_BANNER
광고 로드하기
커스텀형 광고는 NestAdsAdLoader 클래스로 로드되며, 이 클래스는 NestAdsAdLoaderDelegate 프로토콜에 따라 delegates에게 정보를 전송합니다.
NestAdsAdLoader 초기화하기
광고를 로드하려면 먼저 광고 로더를 초기화 해야합니다. 다음 코드는 NestAdsAdLoader 를 초기화하는 방법을 보여줍니다.
adLoader = NestAdsAdLoader(
placementCode: "SAMPLE_CUSTOM_EXPANDABLE_BANNER",
rootViewController: self,
adTypes: [.customNative],
options: [... ad loader options objects ...]
)
adLoader.delegate = self
광고를 로드하려는 게재위치 코드, 광고를 게재하는 곳의 UIViewController, 광고 형식, 광고 표시 옵션을 넣어서 광고 로더를 초기화합니다.
광고 로드 프로토콜 메서드
커스텀형 광고를 로드하는 프로토콜에는 두 가지 메서드가 있습니다.
첫 번째는 NestAdsAdLoader에서 사용해야 하는 소재 스펙 ID를 넣어 반환 하는 메서드입니다. 소재 스펙 ID 를 넣어주면 해당하는 스펙의 광고만 요청할 수 있습니다.
func customNativeCreativeSpecIDs(for adLoader: NestAdsAdLoader) -> [String]
두 번째는 광고가 로드될 때 그 응답 객체와 함께 호출 되는 메서드입니다.
func adLoader(
_ adLoader: NestAdsAdLoader,
didReceive customNativeAd: NestAdsCustomNativeAd)
소재 스펙 ID
커스텀형 광고 형식을 식별하는 데 사용되는 소재 스펙 ID는 어드민의 인벤토리 > 소재스펙 메뉴에서 확인할 수 있습니다. 소재 스펙 ID는 소재 스펙 등록 시 시스템을 통해 자동으로 생성됩니다.
소재 스펙 메뉴에서 소재 스펙을 등록 시 미디어 스펙을 자유롭게 구성할 수 있습니다.
스펙 ID는 커스텀형 광고를 표시할 때 각 미디어 스펙의 데이터를 가져오는 데 사용되는 식별자입니다.
광고 요청하기
단일 광고 요청
NestAdsAdLoader를 생성한 후에 load 메서드를 호출하여 광고를 요청합니다.
adLoader.load(NestAdsAdRequest())
다중 광고 요청
let multipleOptions = NestAdsMultipleAdsAdLoaderOptions()
multipleOptions.numberOfAds = 2
adLoader = NestAdsAdLoader(
placementCode: "SAMPLE_CUSTOM_EXPANDABLE_BANNER",
rootViewController: self,
adTypes: [.customNative],
options: [multipleOptions]
)
adLoader.load(NestAdsAdRequest())
광고 로드 완료 시점 확인하기
앱이 load()를 호출한 후 다음 호출을 사용하여 요청 결과를 가져올 수 있습니다.
각 delegate의 메소드에서 성공과 실패한 경우에 처리를 합니다.
성공한 요청 처리
NestAdsCustomNativeAdLoaderDelegate의 adLoader(_ adLoader: NestAdsAdLoader, didReceive customNativeAd: NestAdsCustomNativeAd)
실패한 요청 처리
NestAdsAdLoaderDelegate의 adLoader(_ adLoader: NestAdsAdLoader, didFailToReceiveAdWithError error: NestAdsAdError)
func adDidLoadedFail(
_ adLoader: NestAdsAdLoader,
didFailToReceiveAdWithError error: NestAdsAdError)
광고 표시하기
NestAdsCustomNativeAd와 함께 사용하는 전용 광고 뷰 클래스는 없습니다. 따라서 사용자 환경에 적합한 모든 레이아웃을 자유롭게 사용할 수 있습니다.
다음은 커스텀형 광고를 표시하는 간단한 예시입니다.
...
func populateWithCustomNativeAd(_ customNativeAd: NestAdsCustomNativeAd) {
self.customNativeAd = customNativeAd
// TEXT 타입의 "AdText"란 미디어 스펙 ID 가져와서 세팅
adTextView.text = customNativeAd.string(withMediaSpecID: "AdText")
//IMAGE 타입의 "PreviewImage" 란 미디어 스펙 ID 가져와서 세팅
mainImageView.image = customNativeAd.image(withMediaSpecID: "PreviewImage")?.image
}
...
동영상 미디어 스펙
소재 스펙을 만들 때 동영상을 추가할 수 있습니다.
NestAdsAdLoaderDelegate의 didReceive 를 통해 customNativeAd가 들어오면 customNativeAd.mediaContent 속성을 사용하여 미디어 콘텐츠를 가져올 수 있습니다.
그런 다음 NestAdsMediaView를 생성하고, mediaContent에 그 값을 설정합니다.
응답 받은 광고에 동영상이 없는 경우엔 그에 대처하여 코드를 작성해야 합니다.
extension ViewController: NestAdsCustomNativeAdLoaderDelegate {
func adLoader(
_ adLoader: NestAdsAdLoader,
didReceive customNativeAd: NestAdsCustomNativeAd) {
// native ad view 생성
let customNativeAdView = ...
let hasVideoContent = customNativeAd.mediaContent.hasVideoContent
if hasVideoContent {
customNativeAd.mediaContent.videoController.delegate = self
}
customNativeAdView.populate(withCustomNativeAd: customNativeAd)
}
}
class MySimpleNativeAdView: UIView {
func populate(withCustomNativeAd customNativeAd: NestAdsCustomNativeAd) {
let mainView: UIView = self.mainView(forCustomNativeAd: customNativeAd)
updateMainView(mainView)
}
private func mainView(forCustomNativeAd customNativeAd: NestAdsCustomNativeAd) -> UIView {
if customNativeAd.mediaContent.hasVideoContent {
let mediaView = NestAdsMediaView()
mediaView.mediaContent = customNativeAd.mediaContent
return mediaView
} else {
let image: UIImage? = customNativeAd.image(withMediaSpecID: "PreviewImage")?.image
return UIImageView(image: image) }
}
}
private func updateMainView(_ mainView: UIView) {
for subview: UIView in mainPlaceholder.subviews {
subview.removeFromSuperview()
}
mainPlaceholder.addSubview(mainView)
mainView.translatesAutoresizingMaskIntoConstraints = false
let viewDictionary: [AnyHashable: Any] = ["PreviewImage":mainView]
mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
withVisualFormat: "H:|[mainView]|", options: [], metrics: nil,
views: viewDictionary as? [String : Any] ?? [String : Any]()))
mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
withVisualFormat: "V:|[mainView]|", options: [], metrics: nil,
views: viewDictionary as? [String : Any] ?? [String : Any]()))
}
}
extension CustomExampleViewController: NestAdsVideoControllerDelegate {
func videoControllerDidPlayVideo() {
//동영상 재생 처리
}
func videoControllerDidPauseVideo() {
//동영상 일시정지 처리
}
...
}
성과 수집
어드민에서 각 성과와 미디어 스펙을 매핑할 수 있습니다. 해당 미디어 스펙의 뷰가 노출되거나 클릭되면 SDK로 성과를 전달해야 합니다.
노출수
성과필드 매핑 > 노출수와 매핑된 미디어 스펙의 뷰가 노출되면 NestAdsCustomNativeAd 에서 recordImpression 메서드를 호출합니다.
customNativeAd.recordImpression();
클릭수 및 행동유도 클릭수
성과필드 매핑 > 클릭수/행동유도 클릭수와 매핑된 미디어 스펙의 뷰가 클릭되면 NestAdsCustomNativeAd 에서 performClick 메서드를 호출하고 클릭한 미디어 스펙의 ID를 전달합니다.
예를 들어 'PreviewImage'라는 미디어 스펙이 있고 이 미디어 스펙에 해당하는 UIImageView 클릭을 보고하려는 경우 코드는 다음과 같습니다.
customNativeAd.performClick(withMediaSpecID:"PreviewImage")
performClick 을 호출하면 다음의 일을 수행합니다.
NestAdsCustomNativeAd 의 customClickHandler 을 등록한 경우 해당 함수 호출
customClickHandler 을 등록하지 않은 경우, 해당 미디어 스펙에 랜딩 URL 이 등록되어 있으면 해당 URL 오픈
