Skip to main content

개요

네이티브 광고는 앱의 UI에 자연스럽게 통합되는 광고 포맷입니다. 광고 요소(제목, 이미지, 설명 등)를 앱 디자인에 맞게 자유롭게 커스터마이징할 수 있습니다.

주요 특징

  • 앱 UI와 완벽하게 통합 가능한 커스텀 디자인
  • 광고 요소 개별 접근 및 배치
  • 광고주 프로필 정보 표시 옵션
  • 추가 커스텀 필드 지원

구현 방법

네이티브 광고 구현은 다음 단계로 진행됩니다:
  1. 광고 로드
  2. 커스텀 뷰 생성
  3. 뷰 바인딩
  4. Delegate 처리

1. 광고 로드

AdropNativeAd 인스턴스를 생성하고 광고를 로드합니다.

Context ID 설정

문맥 타겟팅을 위해 Context ID를 설정할 수 있습니다.
개발 중에는 테스트 유닛 ID를 사용하세요. 테스트 유닛 ID 섹션을 참고하세요.

2. 커스텀 뷰 생성

스토리보드 또는 코드로 네이티브 광고 뷰를 구성합니다.

UIKit (Storyboard/XIB)

스토리보드에서 AdropNativeAdView를 생성하고 광고 요소를 IBOutlet으로 연결합니다.

UIKit (코드)


3. 뷰 바인딩

AdropNativeAdView에 광고 요소를 바인딩하여 광고 데이터를 표시합니다.

바인딩 메서드

onClick 클로저는 사용자가 바인딩된 뷰를 탭할 때 호출됩니다. 현재 AdropNativeAd? 인스턴스와 탭된 UIView를 파라미터로 받습니다. 제공하지 않으면 기본 클릭 동작(목적지 URL 열기)이 사용됩니다.
광고주 프로필을 표시하려면 애드컨트롤 콘솔에서 해당 광고 유닛의 광고주 프로필 표시를 활성화해야 합니다.

4. Delegate 처리

AdropNativeAdDelegate를 구현하여 광고 이벤트를 처리합니다.

Delegate 메서드


클로저 콜백

Delegate 대신 클로저 기반 콜백을 사용할 수 있습니다.
Delegate와 클로저를 동시에 설정하면 두 가지 모두 호출됩니다.

광고 속성

AdropNativeAd 객체를 통해 광고 데이터에 접근할 수 있습니다.

기본 속성

광고주 프로필

커스텀 필드

애드컨트롤 콘솔에서 설정한 추가 텍스트 항목에 접근할 수 있습니다.
extra 필드는 애드컨트롤 콘솔의 광고 유닛 설정에서 정의한 추가 텍스트 항목 ID를 키로 사용합니다.

속성 목록

AdropNativeAdProfile


커스텀 클릭

커스텀 클릭을 사용하면 기본 동작(목적지 URL 열기) 대신 광고 클릭 동작을 직접 처리할 수 있습니다.

설정

전체 클릭 영역

setIsEntireClick(_:)을 사용하여 AdropNativeAdView 전체를 클릭 가능하게 만듭니다.
useCustomClick이 true인 경우, setNativeAd(_:)에서 setIsEntireClick(true)가 자동으로 호출됩니다.

수동 클릭

performClick()을 사용하여 수동으로 클릭 이벤트를 트리거합니다.

URL 열기

open(_:useInAppBrowser:)를 사용하여 프로그래밍 방식으로 URL을 엽니다.

영상 트래킹과 VTR

Adrop은 네이티브 광고의 영상 지표 — VTR(영상 완수율), onAdVideoStart, onAdVideoEnd — 를 SDK 미디어 컨테이너(AdropNativeAdView.setMediaView(_:)로 바인딩된 UIView) 안에서 영상이 렌더링될 때에만 수집합니다. 이는 광고의 대표 미디어(미디어 1)에 해당합니다. 다중 미디어 소재의 나머지 미디어는 다중 미디어 소재를 참고하세요. AdropNativeAd.asset 프로퍼티는 원본 이미지 또는 영상 파일의 URL을 반환합니다. 이 값은 썸네일 표시나 매체사 자체 분석 등 부가 메타데이터 용도로 노출된 것이며, 재생을 직접 처리하기 위한 것이 아닙니다.
영상 네이티브 광고의 asset URL을 자체 영상 플레이어(AVPlayer, AVPlayerViewController 또는 서드파티 플레이어)에 직접 전달하지 마세요. SDK 미디어 컨테이너를 거치지 않으면 다음 현상이 발생합니다.
  • 해당 지면에서 VTR(영상 완수율)이 수집되지 않습니다.
  • onAdVideoStart / onAdVideoEnd 콜백이 호출되지 않습니다.
  • 해당 유닛의 영상 성과 집계가 누락되거나 0으로 보고됩니다.
클릭(onAdClicked)과 노출(onAdImpression) 트래킹은 컨테이너 뷰에 연결되어 있으므로 계속 동작하지만, 영상 관련 신호는 손실됩니다.

권장 패턴

영상 네이티브 광고에는 항상 SDK 미디어 컨테이너를 바인딩하세요.
특정 지면이 반드시 자체 플레이어를 사용해야 하고 VTR이 측정되지 않는 것을 수용한다면, 광고를 AdropNativeAdView에 바인딩한 채로 유지해 클릭과 노출 어트리뷰션은 계속 확보할 수 있습니다. 다만 해당 지면을 내부 리포트에서 비-VTR 인벤토리로 분류하고 SDK가 측정한 영상 성과와 섞지 마세요.

다중 미디어 소재

iOS SDK(adrop-ads) 1.16.0 이상이 필요합니다. 백필을 쓴다면 adrop-ads-backfill도 같은 버전으로 올리세요.
네이티브 유닛에 미디어가 2개 이상이면 소재에 미디어마다 파일이 들어 있습니다. extraAssets에는 광고의 모든 미디어가 들어 있으며, 키는 콘솔에서 정한 미디어 아이디입니다. 미디어 1은 항상 m1이고, 나머지 미디어는 광고 유닛 상세 화면의 미디어 크기에 표시된 아이디(예: m2, m3)를 씁니다.
  • 미디어 1(m1)은 asset, creative와 같은 미디어입니다. 지금처럼 setMediaView(_:)에 넘긴 미디어 뷰로 표시하고, 나머지 미디어만 직접 그리세요.
  • 미디어가 하나인 유닛의 소재와 백필 광고에서는 extraAssets가 비어 있습니다. 이런 광고는 평소처럼 표시하세요.
  • extraAssets는 딕셔너리이므로 순서가 보장되지 않습니다. 미디어는 아이디로 찾으세요.
  • 광고가 다크 모드로 송출되면 이미지 미디어도 다크 모드용 이미지로 제공됩니다.
  • 다중 미디어 소재로 레이아웃을 확인하려면 테스트 기기에서 소재를 미리 보세요.

AdropNativeAsset

미디어 표시하기

  • 이미지: setHeadLineView(_:) 등 set…View 메서드로 뷰를 등록하기 전에 setIsEntireClick(true)를 호출하세요. 직접 그린 미디어는 SDK에 등록한 뷰가 아니어서, 기본 클릭 모드에서는 탭해도 클릭으로 집계되지 않습니다. 전체 클릭을 켜면 미디어 1이 동영상일 때 플레이어 컨트롤이 탭에 반응하지 않습니다. 이미지의 creative HTML은 클릭을 Adrop에 보고하지 않으므로 로드하지 마세요.
  • 동영상: asset URL이 아니라 creative HTML을 재생하세요. HTML에 동영상 플레이어와 트래킹이 들어 있어, 동영상 지표는 이 HTML로만 측정됩니다. WKWebView는 AdropNativeAdView 밖에 두세요. 안에 두면 전체 클릭 때문에 플레이어 컨트롤을 누른 것까지 모든 탭이 광고 클릭이 됩니다. HTML은 미리 로드하지 말고 광고가 화면에 나타나기 직전에 로드하세요.
  • 랜딩 페이지: 사용자가 동영상을 탭하면 HTML이 클릭을 보고하고, 랜딩 페이지를 새 창이나 같은 창으로 열어 달라고 요청합니다. 두 요청을 webView(_:createWebViewWith:for:windowFeatures:)와 webView(_:decidePolicyFor:decisionHandler:)에서 처리하고, 소재의 브라우저 옵션을 따르는 AdropNativeAd의 open(_:useInAppBrowser:)로 URL을 여세요.

노출과 클릭

노출, 클릭, 동영상 지표는 SDK와 미디어가 모두 보고해도 미디어별이 아니라 광고당 한 번만 집계됩니다.
동영상의 어떤 탭이 클릭으로 집계되는지는 유닛의 영상 컨트롤러 설정에 따라 다릅니다. 컨트롤러가 꺼져 있으면 동영상의 모든 탭이 클릭으로 집계되고, 켜져 있으면 재생·음소거 컨트롤을 누른 것은 클릭으로 집계되지 않습니다.

예제

미디어 2(m2)가 이미지면 AdropNativeAdView 안에, 동영상이면 AdropNativeAdView 바로 아래에 둔 컨테이너에 표시하는 예제입니다. m2는 유닛의 미디어 아이디로 바꾸세요.
UITableView나 UICollectionView에서는 셀을 구성할 때 미디어의 WKWebView를 만들고 prepareForReuse()에서 제거하세요.

모범 사례

에러 처리

광고 로드 실패 시 대체 UI를 표시하여 사용자 경험을 유지하세요.

테스트 유닛 ID

개발 및 테스트 시 다음 테스트 유닛 ID를 사용하세요.
실제 배포 시에는 반드시 애드컨트롤 콘솔에서 생성한 실제 유닛 ID를 사용하세요.

일괄 로드 (loads)

AdropNativeAd.loads(...)를 사용하면 한 번의 호출로 여러 네이티브 광고를 요청할 수 있습니다. 피드·캐러셀·페이지네이션 리스트에 삽입할 광고 풀을 프리페칭하는 데 유용합니다.

시그니처

사용 방법

델리게이트 메서드

단건 onAdReceived(_:) / onAdFailedToReceive(_:_:) 콜백은 loads 경로에서 호출되지 않습니다. 배치 결과는 반드시 onAdsReceived(_:) / onAdsFailedToReceive(_:)로만 수신하세요.

상수

Int
기본값:"5"
단일 loads(...) 호출에서 반환되는 광고의 최대 개수.

제약 사항

  • 호출당 최대 5개. 서버가 그 이상을 반환하더라도 앞의 5개만 전달됩니다.
  • 백필은 적용되지 않습니다. 직광고 채움이 없으면 백필 설정과 무관하게 onAdsFailedToReceive가 ERROR_CODE_AD_NO_FILL로 호출됩니다.
  • AdropBanner.loads(...)와 달리, 네이티브 배치는 모든 광고의 렌더링이 끝날 때까지 기다린 후 onAdsReceived(_:)를 호출합니다. 전달 시점에 각 인스턴스는 완전히 렌더링된 상태입니다.
  • 반환된 광고에 대해 강한 참조를 유지하세요. AdropNativeAdView에 바인딩되기 전에 해제되면 조용히 드롭됩니다.

백필 광고

백필 광고가 활성화된 경우, 직광고가 없을 때 자동으로 백필 광고가 로드됩니다. isBackfilled 프로퍼티로 백필 광고 여부를 확인할 수 있습니다.

AdChoices 위치 조정

백필 네이티브 광고에서 AdChoices 마크가 표시될 코너를 지정할 수 있습니다. load() 호출 전에 AdropNativeAd 인스턴스의 preferredAdChoicesPosition을 설정하세요.
이 설정은 백필 네트워크에 전달되는 선호 위치 힌트로, 백필 네이티브 광고에만 적용됩니다 — 직광고에는 영향이 없습니다. 반드시 load() 호출 전에 설정해야 하며, 백필 네트워크가 정책상 다른 위치로 표시할 수 있습니다.
백필 광고를 사용하려면 AdropAds-Backfill 의존성을 추가해야 합니다. 시작하기를 참고하세요.

관련 문서

시작하기

SDK 설치 및 초기화

배너 광고

배너 광고 구현하기

전면 광고

전면 광고 구현하기

보상형 광고

보상형 광고 구현하기