Interfaces
AdropConfig (SDK 설정)
AdropConfig는 Adrop Web SDK 초기화 및 동작을 위한 설정 옵션입니다.
Properties
Property
Type
Required
Description
uid
string
No
사용자 식별자. 타겟팅 하려면 필수 설정
appId
string
Yes
SDK 초기화에 반드시 필요한 App ID
appKey
string
No
API 인증용 App Key. updateUserProperties 호출 시 필요
debug
boolean
No
디버그 로그 출력 여부
Ad Types
AdropAdRequest
unit
string
Yes
광고 유닛 ID
uid
string
No
사용자 식별자 (초기화 시 설정하지 않았다면 정교한 타겟팅을 위해 권장)
contextId
string
No
컨텍스트 광고용 Context ID
trackMode
0 | 1
No
네이티브 광고용 0: Adrop 소재 사용 1: 직접 제작한 View 사용
isEntireClick
boolean
No
trackMode가 1일 때 광고 클릭 영역을 전체로 할 지 여부 true: 모든 광고 영역 클릭 가능 false: Text 및 이미지만 클릭 가능
theme
'light' | 'dark'
No
다크모드를 설정한 유닛에 대하여 테마별 소재를 받을 때 사용 'light': 라이트모드 소재 'dark': 다크모드 소재
AdropAdResponse
code
AdropErrorCode
Yes
응답 코드
msg
string
Yes
응답 메시지
result
AdData
No
광고 데이터 (code=0일 때만 존재)
AdData
id
string
No
광고 ID
cpId
string
No
캠페인 ID
creativeId
string
No
크리에이티브 ID
format
AdFormat
Yes
광고 포맷 banner | nativeAd | backfill
unit
string
Yes
광고 유닛 ID
ad
string
Yes
광고 HTML 콘텐츠
w
number
Yes
광고 너비
h
number
Yes
광고 높이
headline
string
No
제목(Headline)
body
string
No
광고 설명
callToAction
string
No
CTA 버튼 텍스트
destinationURL
string
No
도착 URL
accountTag
string
No
광고계정 태그
creativeTag
string
No
크리에이티브 태그
extra
Record<string, string>
No
커스텀 필드 값
profile
AdProfile
No
광고주 프로필 정보
target
AdBrowserTarget
No
소재 리다이렉션 위치 설정 external: 새 창
internal: 현재 창
type
AdType
No
광고 타입 display | video
carouselActivated
boolean
No
캐러셀 활성화 여부
AdProfile
displayLogo
string
광고주 정사각형 로고 URL
displayName
string
광고주 이름
link
string
광고주 프로필 링크
Event Types
Adrop SDK에서 제공하는 광고 이벤트 및 리스너 타입.
AdropEventFilter
이벤트 리스너 등록 시 조건 필터링 옵션입니다.
unit
string
특정 유닛 ID 이벤트만 필터링
AdropEventListenerMap
Type-safe 이벤트 핸들링을 위한 리스너 맵입니다.
adReceived
AdReceivedCallback
광고 로딩 성공
adImpression
AdImpressionCallback
노출 트래킹 발생 (BackFill에서 동작하지 않습니다.)
adClicked
AdClickedCallback
광고 클릭 (BackFill에서 동작하지 않습니다.)
adNoFill
AdNoFillCallback
송출 가능한 광고 없음
adFailed
AdFailedCallback
광고 로드 실패
adBackfillNoFill
AdBackfillNoFillCallback
백필 광고 없음
Event Callback Types
Property Types
Adrop SDK가 수집하거나 설정할 수 있는 속성(Property) 타입입니다.
AppProperties
appName
string
앱 패키지 ID (Bundle ID / Package Name)
appVersion
string
앱 표시 버전 (예: 1.0.3)
appBundleVersion
number
내부 빌드 버전
UserProperties
adid
string
광고 ID (Android ADID / iOS IDFA)
birth
string
출생 연도 또는 생년월일 (YYYY, YYYYMM, YYYYMMDD)
gender
string
성별 (M, F, U)
locale
string
디바이스 로케일 (예: ko_KR, en_US)
timeZone
string
디바이스 타임존 (예: Asia/Seoul)
[key: string]
string | number | boolean | undefined
사용자 정의 커스텀 속성
DeviceProperties
SDK에서 자동 수집하는 디바이스 정보입니다.
sdkv
string
SDK 버전
deviceModel
string
디바이스 모델
deviceWidth
number
화면 너비 (px)
deviceHeight
number
화면 높이 (px)
osVersion
string
OS 버전
webViewUserAgent
string
WebView User Agent
networkOperator
string
통신사명
platform
string
플랫폼 (android, ios, web)
Last updated