API를 활용한 네이티브 광고
1. Request Ad
GET /request
응답부터 수신된 데이터 중, adof result필드를 이용하여 네이티브 광고를 표시할 수 있습니다.
배너는 HTML 형식으로 반환되므로 웹 프로젝트에서 직접 렌더링할 수 있습니다.
다른 플랫폼에서는 WebView를 활용할 수 있습니다.
REST API를 참고해주세요.
Parameters:
unit
STRING
필수
광고 유닛 ID
uid
STRING
권장 사항
개별 유저 식별자
trackMode
INT
선택
소재에 등록된 이미지의 URL을 내려받고, 노출과 클릭 추적을 직접 처리하려고 할 때 사용하는 모드입니다.
값을 1로 설정하는 경우 응답에 asset, pixelTracker, imprTracker, clickTracker 필드가 추가됩니다.
contextId
STRING
문맥 타겟 광고 요청 시 필수
콘솔 타겟팅 메뉴 > 문맥 타겟팅 에서 설정한 아이디로 광고 요청을 보낼때 사용됩니다.
Response:
Ad data
unit
STRING
필수
광고 유닛 ID
w
INT
필수
Width
h
INT
필수
Height
advertiser
STRING
선택
광고주 명
icon
URL
선택
광고주 Icon
cover
URL
선택
광고주 Cover
advertiserURL
URL
선택
광고주 URL
headline
STRING
선택
헤드 라인 텍스트
body
STRING
선택
본문 텍스트
callToAction
STRING
선택
CTA 텍스트
destinationURL
URL
선택
도착 URL
accountTag
JSON
선택
퍼블리셔가 추가한 Account tag 데이터
creativeTag
JSON
선택
퍼블리셔가 추가한 Creative tag 데이터
extra
JSON
선택
추가 텍스트 항목
key: 콘솔에서 생성한 추가 텍스트의 id
value: 광고주가 입력한 값
asset
URL
선택
(trackMode가 1인 경우) 소재 이미지 URL
pixelTracker
STRING
선택
(trackMode가 1인 경우) 소재 이미지 URL을 사용해서 화면을 구성하는 경우, 노출 집계를 위해서 1 x 1 픽셀의 투명 이미지를 제공합니다. 해당 이미지를 소재와 함께 화면에 배치하면 광고 노출시 자동으로 집계가 가능합니다. pixelTracker 와 imprTracker 중 한 가지 방법만을 사용해서 노출을 집계해야 합니다.
imprTracker
URL
선택
(trackMode가 1인 경우) 노출을 직접 추적하기 위한 URL입니다. 사용자에게 광고가 노출되었을때 해당 URL을 호출해주어야 정상적으로 노출이 집계됩니다. pixelTracker 와 imprTracker 중 한 가지 방법만을 사용해서 노출을 집계해야 합니다.
clickTracker
URL
선택
(trackMode가 1인 경우) 클릭을 직접 추적하기 위한 URL입니다. 사용자가 광고를 클릭했을 때 해당 URL을 호출해주어야 정상적으로 클릭이 집계됩니다.
profile
JSON
선택
광고유닛에 광고주 프로필을 받도록 설정했을때, 광고주가 소재 등록시 등록한 정보입니다.
displayLogo: 광고주가 업로드한 정사각형 로고
displayName: 광고주가 입력한 이름
link: 광고주가 입력한 링크
Example
아래 코드 스니펫에서 생성한 유닛 ID로 코드를 변경해주세요.
혹은 Adrop의 test_유닛ID를 대신해서 테스트 할 수 있습니다.
GET /request?unit={unit_id}&uid={user_id}&pf={platform}&lcl={locale} HTTP/1.1
Host: api-v2.adrop.io
Authorization: {app_key}{
"code": 0,
"msg": "OK",
"result": {
"format": "nativeAd",
"unit": "unit_id",
"ad": "...",
"advertiser": "..."
}
}Last updated